Files
dygou_go/deploy/control-center/README.md
T
yml 9c83be798d feat: 优化代理准备并完善远端部署
- 增加严格代理、两分钟预取、白名单去重与分组状态展示\n- 增加远端注册令牌和安全地址校验\n- 增加 Docker Compose、Caddy 示例与控制中心部署文档
2026-11-21 20:59:35 +08:00

2.5 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 up -d --build

如果服务器无法访问 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

把 Caddyfile.example 中的配置改好域名后加入宿主机现有 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 build --pull
docker compose up -d

使用镜像仓库时,将 .env 中的 DOUYU_CONTROL_IMAGE 改为固定版本,然后:

docker compose pull
docker compose up -d

升级不会删除 data。控制中心只能运行一个副本,不能直接水平扩容。