119 lines
3.0 KiB
Markdown
119 lines
3.0 KiB
Markdown
# 远端控制中心部署
|
||
|
||
该目录只包含控制中心的部署文件。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=<DOUYU_CONTROL_OPERATOR_TOKEN>
|
||
```
|
||
|
||
`#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`。控制中心只能运行一个副本,不能直接水平扩容。
|