自己部署的事件统计

1. 1

   保存 compose.yaml，启动

   ClickHouse、Redis、evstats 三个服务。把示例口令 change-me 改掉，然后执行 docker compose up -d。

   复制

   services:
     clickhouse:
       image: clickhouse/clickhouse-server:24.8
       environment:
         CLICKHOUSE_USER: evstats
         CLICKHOUSE_PASSWORD: change-me
         CLICKHOUSE_DB: evstats
       volumes:
         - ch-data:/var/lib/clickhouse
       healthcheck:
         test: ["CMD", "clickhouse-client", "--user", "evstats", "--password", "change-me", "--query", "SELECT 1"]
         interval: 5s
         retries: 30
       restart: unless-stopped
       # 不要把 8123 映射到公网
     redis:
       image: redis:7
       command: ["redis-server", "--appendonly", "yes", "--requirepass", "change-me"]
       volumes:
         - redis-data:/data
       healthcheck:
         test: ["CMD", "redis-cli", "-a", "change-me", "ping"]
         interval: 5s
         retries: 30
       restart: unless-stopped
       # 不要把 6379 映射到公网
     evstats:
       image: ghcr.io/mosongcc/evstats:1
       working_dir: /var/lib/evstats
       # 推荐环境变量。同名启动参数 -clickhouse、-redis、-port 写了就覆盖。
       environment:
         EVS_CLICKHOUSE: http://evstats:change-me@clickhouse:8123/evstats
         EVS_REDIS: redis://:change-me@redis:6379/0
       volumes:
         - evstats-data:/var/lib/evstats/data
       ports:
         - "51321:51321"
       # ClickHouse 或 Redis 连不上时 evstats 按设计退出：等两个依赖健康后再启动，异常退出后自动重启
       depends_on:
         clickhouse:
           condition: service_healthy
         redis:
           condition: service_healthy
       restart: unless-stopped
       healthcheck:
         test: ["CMD", "/evstats", "healthcheck"]
         interval: 10s
   volumes:
     ch-data:
     redis-data:
     evstats-data:
   

2. 2

   打开网页，创建管理员

   浏览器打开 http://你的主机:51321/。ClickHouse 和 Redis 已经在 Compose 里配好。没有预置账号，管理员由你自己设。

3. 3

   创建项目，把 SDK 粘进网页

   项目页给出带写入密钥的片段。放进网页，打开项目的「接入」页签就能看到第一条事件。

   复制

   <script src="https://unpkg.com/@evstats/web/dist/evstats.min.js"></script>
   <script>evstats.init({ endpoint: "http://你的主机/sa", key: "evs_wk_xxx" })</script>

完整步骤、截图与排障 → 快速体验

正式上线建议三类服务器分开：ClickHouse 存全部数据，Redis 放采集队列和会话，evstats 负责采集、统计和页面。 每台一份 Compose 文件，开头写着要改的地方；三台都起来以后，打开网页走一遍引导。

1. 1

   ClickHouse 服务器

   示例内网地址 10.0.0.11

   数据盘 SSD，内存越大越好

   deploy/production/clickhouse/ → docker compose up -d

   只对 evstats 服务器开放 8123

2. 2

   Redis 服务器

   示例内网地址 10.0.0.12

   打开 AOF，不淘汰键

   deploy/production/redis/ → docker compose up -d

   只对 evstats 服务器开放 6379

3. 3

   evstats 服务器（可多台）

   示例内网地址 10.0.0.21

   Nginx 终止 HTTPS，evstats 只听本机

   deploy/production/evstats/ → docker compose up -d

   对公网只开放 443

4. 4

   打开网页完成引导

   https://stats.example.com

   创建管理员和第一个项目。Redis 地址写在启动参数 -redis 里。

   再填 site.public_url 与可信代理

每台机器的完整命令、防火墙、HTTPS、上线核对 → 生产环境部署