Files
dygou_go/deploy/control-center/README.md
T
yml 3cb7a6bad8 feat(deploy): 支持复用容器化 Caddy
- 拆分为镜像运行与本地构建 Compose\n- 增加现有 Caddy Docker 网络覆盖\n- 增加容器内反代示例与部署说明
2026-11-21 21:06:35 +08:00

3.0 KiB
Raw Blame History

远端控制中心部署

该目录只包含控制中心的部署文件。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。控制中心只能运行一个副本,不能直接水平扩容。