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