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

110 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 远端控制中心部署
该目录只包含控制中心的部署文件。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 up -d --build
```
如果服务器无法访问 `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
把 `Caddyfile.example` 中的配置改好域名后加入宿主机现有 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=<DOUYU_CONTROL_OPERATOR_TOKEN>
```
`#admin` 不会发送给服务器,页面读取后会从地址栏移除。
## 数据与备份
```text
data/
events.ndjson
runs.ndjson
agent_tokens.json
```
`agent_tokens.json` 丢失后,已有实例需要重新注册。至少每天备份一次整个 `data` 目录。
当前 NDJSON 不会自动轮转。长期运行前需要增加应用层保留策略,不能只依赖 Docker 容器日志轮转。
## 升级
使用本地构建:
```bash
docker compose build --pull
docker compose up -d
```
使用镜像仓库时,将 `.env` 中的 `DOUYU_CONTROL_IMAGE` 改为固定版本,然后:
```bash
docker compose pull
docker compose up -d
```
升级不会删除 `data`。控制中心只能运行一个副本,不能直接水平扩容。