远端控制中心部署
该目录只包含控制中心的部署文件。Go 源码仍位于仓库的 cmd/douyu-control 和 internal/remote,避免桌面端 Agent 与控制中心协议分叉。
架构
Internet
-> Caddy 443
-> 127.0.0.1:18080
-> douyu-control 容器
-> ./data
Caddy 不放入该 Compose。继续使用宿主机现有 Caddy,避免重复申请证书和占用 80/443。
首次部署
cd deploy/control-center
cp .env.example .env
openssl rand -hex 32
openssl rand -hex 32
把两个随机值分别填入 .env:
DOUYU_CONTROL_OPERATOR_TOKEN=管理网页令牌
DOUYU_CONTROL_ENROLL_TOKEN=桌面实例注册令牌
创建数据目录并交给容器用户:
sudo install -d -m 0700 -o 10001 -g 10001 data
docker compose -f compose.yaml -f compose.build.yaml build
docker compose up -d
如果服务器无法访问 proxy.golang.org,将 .env 中的 GOPROXY 改为可用的 Go 模块代理,例如 https://goproxy.cn,direct。
检查:
curl http://127.0.0.1:18080/api/health
docker compose ps
docker compose logs -f --tail=100
Caddy
宿主机 Caddy 使用 Caddyfile.example。如果现有 Caddy 本身运行在 Docker 中,使用 Caddyfile.container.example,并加载网络覆盖文件:
docker compose -f compose.yaml -f compose.existing-caddy.yaml up -d
此时 Caddy 通过 douyu-control:18080 访问控制中心。.env 中的 DOUYU_CONTROL_CADDY_NETWORK 必须填写现有 Caddy 所在 Docker 网络。
把对应示例中的配置改好域名后加入现有 Caddy 站点配置,然后验证并重载:
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
公网防火墙只开放 80/443,不要开放 18080。Caddy 会自动处理 HTTPS 和 Agent WebSocket Upgrade。
桌面实例
每个实例填写:
控制中心地址: https://control.example.com
注册令牌: 与 DOUYU_CONTROL_ENROLL_TOKEN 相同
实例首次连接时使用注册令牌换取独立实例令牌,之后复用本机凭据。控制中心不需要保存桌面端的注册令牌。
管理网页
https://control.example.com/#admin=<DOUYU_CONTROL_OPERATOR_TOKEN>
#admin 不会发送给服务器,页面读取后会从地址栏移除。
数据与备份
data/
events.ndjson
runs.ndjson
agent_tokens.json
agent_tokens.json 丢失后,已有实例需要重新注册。至少每天备份一次整个 data 目录。
当前 NDJSON 不会自动轮转。长期运行前需要增加应用层保留策略,不能只依赖 Docker 容器日志轮转。
升级
使用本地构建:
docker compose -f compose.yaml -f compose.build.yaml build --pull
docker compose up -d
使用镜像仓库时,将 .env 中的 DOUYU_CONTROL_IMAGE 改为固定版本,然后:
docker compose pull
docker compose up -d
升级不会删除 data。控制中心只能运行一个副本,不能直接水平扩容。