系统设置增加中控企业微信告警，后台巡检离线/故障并冷却推送。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
@@ -1,91 +1,95 @@
|
||||
# crypto_okx_hub 部署文档(Ubuntu)
|
||||
|
||||
**仓库:** [https://git.bz121.com/dekun/crypto_okx_hub.git](https://git.bz121.com/dekun/crypto_okx_hub.git)
|
||||
|
||||
配套说明：**[使用说明.md](./使用说明.md)** · **[设计文档.md](./设计文档.md)** · **[deploy/README.md](./deploy/README.md)**
|
||||
关联客户端仓库：[crypto_okx](https://git.bz121.com/dekun/crypto_okx.git)
|
||||
|
||||
> 中控与客户端一样：**仅 Ubuntu + PM2 一键部署**。不提供 Windows 部署。
|
||||
|
||||
---
|
||||
|
||||
## 1. 一键部署(推荐)
|
||||
|
||||
新服务器(免 clone):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://git.bz121.com/dekun/crypto_okx_hub/raw/branch/main/deploy/manage.sh | bash
|
||||
```
|
||||
|
||||
已安装:
|
||||
|
||||
```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` |
|
||||
|
||||
**不要**在中控配置任何 `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 草案 |
|
||||
# crypto_okx_hub 部署文档(Ubuntu)
|
||||
|
||||
**仓库:** [https://git.bz121.com/dekun/crypto_okx_hub.git](https://git.bz121.com/dekun/crypto_okx_hub.git)
|
||||
|
||||
配套说明：**[使用说明.md](./使用说明.md)** · **[设计文档.md](./设计文档.md)** · **[deploy/README.md](./deploy/README.md)**
|
||||
关联客户端仓库：[crypto_okx](https://git.bz121.com/dekun/crypto_okx.git)
|
||||
|
||||
> 中控与客户端一样：**仅 Ubuntu + PM2 一键部署**。不提供 Windows 部署。
|
||||
|
||||
---
|
||||
|
||||
## 1. 一键部署(推荐)
|
||||
|
||||
新服务器(免 clone):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://git.bz121.com/dekun/crypto_okx_hub/raw/branch/main/deploy/manage.sh | bash
|
||||
```
|
||||
|
||||
已安装:
|
||||
|
||||
```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 草案 |
|
||||
|
||||
Reference in New Issue
Block a user