dekun
d726810320
默认账号改为 admin/admin123，去掉 Windows 部署说明，与客户端同套部署流程。 Co-authored-by: Cursor <cursoragent@cursor.com>
92 lines
2.7 KiB
Markdown
92 lines
2.7 KiB
Markdown
# 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 草案 |
|