# 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 草案 |