crypto_okx_hub/部署文档.md

crypto_okx_hub 部署文档(Ubuntu)

仓库: https://git.bz121.com/dekun/crypto_okx_hub.git

配套说明：使用说明.md · 设计文档.md · deploy/README.md
关联客户端仓库：crypto_okx

中控与客户端一样：仅 Ubuntu + PM2 一键部署。不提供 Windows 部署。

---

1. 一键部署(推荐)

新服务器(免 clone):

curl -fsSL https://git.bz121.com/dekun/crypto_okx_hub/raw/branch/main/deploy/manage.sh | bash

已安装:

bash /opt/crypto_okx_hub/deploy/manage.sh

菜单：

1. 一键部署 — 系统依赖、Node/PM2、venv、启动 crypto_okx_hub
2. 一键卸载 — 备份 .env / hub.db → 停 PM2 → 移走目录
3. 更新 — git pull + pm2 restart(或含 pip)
4. 仅检测 — 不安装

安装路径：/opt/crypto_okx_hub，默认端口 5100，默认登录 admin / admin123。

---

2. 部署拓扑

[Ubuntu 云机]                 [云服务器 A]              [云服务器 B]
 crypto_okx_hub      ──拉快照──▶  crypto_okx            crypto_okx
 (中控只一份,PM2)              公网域名 A              公网域名 B
                               HUB_BRIDGE_TOKEN=xxx    HUB_BRIDGE_TOKEN=yyy

• 客户端：必须能被浏览器与中控以 公网域名（建议 HTTPS） 访问。
• 中控：Ubuntu + PM2；需能访问各客户端公网 URL。

---

3. 中控环境变量

变量	说明
APP_HOST / APP_PORT	默认 0.0.0.0 / 5100
HUB_USERNAME / HUB_PASSWORD	默认 admin / admin123；也可在页面「系统设置」修改
FLASK_SECRET_KEY	Session；部署脚本可自动生成
DB_PATH	注册表 SQLite，默认 hub.db
HUB_PULL_INTERVAL_SEC	后台健康巡检/总览拉取间隔，默认 10
HUB_PULL_TIMEOUT_SEC	单机超时，默认 5
HUB_WECHAT_ENABLED	中控企业微信告警开关，默认 false；可在系统设置修改
HUB_WECHAT_WEBHOOK	企业微信机器人 Webhook
HUB_ALERT_COOLDOWN_SEC	同一机器告警冷却秒数，默认 600
HUB_HEALTH_FAIL_THRESHOLD	连续失败几次后告警，默认 2

不要在中控配置任何 OKX_API_*。

---

4. 客户端侧（crypto_okx）联调清单

变量	说明
HUB_BRIDGE_TOKEN	与中控登记的 Token 一致
（可选）HUB_EMBED_FRAME_ANCESTORS	允许嵌入的中控 Origin

并确认公网 DNS、快照 API、/embed 可打开。

---

5. 联调验收

1. 中控添加 2 个客户端（不同公网域名 + Token）。
2. 总览两卡均在线。
3. 「打开」内嵌 / 「新标签」正常。
4. 系统设置可改用户名密码，改后可用新账号登录；可配置企业微信告警并发送测试消息。

---

变更记录

日期	说明
2026-10-01	Ubuntu 一键部署 + PM2；默认 admin/admin123；系统设置改密
2026-10-01	初稿：双仓拓扑、env 草案