Document cloud server sizing and region guidance.

Add recommended VPS specs and low-latency region notes for deploy and commercial delivery.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
2026-07-29 20:57:56 +08:00
parent 101cb3c045
commit c41122ae71
4 changed files with 507 additions and 446 deletions
+3
View File
@@ -16,6 +16,9 @@
| 进程管理 | PM2`eth-hedge-api` | | 进程管理 | PM2`eth-hedge-api` |
| 安装目录 | `/opt/eth_hedge_sim` | | 安装目录 | `/opt/eth_hedge_sim` |
| 端口 | **5155** | | 端口 | **5155** |
| 云服务器(推荐) | **2 vCPU / 2 GB / 40 GB SSD**;地域优先香港、新加坡等低延迟区 |
云服务器最低/推荐/余量规格、地域与带宽选择见 **[开发方案 §6.0 云服务器配置选择说明](docs/开发方案.md#60-云服务器配置选择说明)**。
## 文档 ## 文档
+13 -2
View File
@@ -49,11 +49,22 @@
### 2.2 客户侧必备条件 ### 2.2 客户侧必备条件
- 一台独立 **Ubuntu 22.04** 主机(建议独立 IP - 一台独立 **Ubuntu 22.04** 主机(建议独立公网 IP
- 出网访问目标交易所 API(OKX 等) - **云服务器规格**:见下方「配置选择」;更完整说明见 [开发方案 §6.0](./开发方案.md#60-云服务器配置选择说明)
- 出网访问目标交易所 API(OKX / 币安等)
- 域名或 IP + HTTPS(可用反代) - 域名或 IP + HTTPS(可用反代)
- 客户自备交易所 API Key(只读行情 / 实盘交易按档位要求) - 客户自备交易所 API Key(只读行情 / 实盘交易按档位要求)
#### 云服务器配置选择(交付速查)
| 用途 | 建议规格 | 地域 |
|------|----------|------|
| 演示 / SIM | 2 vCPU / 2 GB / 40 GB SSD | 香港或新加坡优先 |
| LIVE 实盘 | 同上起配;网络优先于堆配置 | 对交易所延迟低的海外区 |
| 最低试装 | 1 vCPU / 1 GB(仅短期试跑) | 同上 |
不建议:超售共享低配、无稳定公网、大陆机房直连境外交易所作为默认 LIVE 节点。
### 2.3 部署流程(商用目标体验) ### 2.3 部署流程(商用目标体验)
1. 客户拿到安装脚本或镜像 + **授权码** 1. 客户拿到安装脚本或镜像 + **授权码**
+39 -1
View File
@@ -15,7 +15,7 @@
| 产品名 | **比特骆驼自动化对冲系统** | | 产品名 | **比特骆驼自动化对冲系统** |
| 工程名 / 目录名 | `eth_hedge_sim` | | 工程名 / 目录名 | `eth_hedge_sim` |
| 部署操作系统 | **Ubuntu 22.04** LTS | | 部署操作系统 | **Ubuntu 22.04** LTS |
| 云服务器 | **单独一台 Ubuntu 22.04**(或同机不同目录/不同 PM2 进程名,且与现网隔离) | | 云服务器 | **单独一台 Ubuntu 22.04**;规格选型见 [§6.0 云服务器配置选择](#60-云服务器配置选择说明) |
| 部署 | PM2 | | 部署 | PM2 |
| 行情 | OKX **实盘只读** APIREST + WebSocket | | 行情 | OKX **实盘只读** APIREST + WebSocket |
| 成交(默认) | **本地模拟撮合 + 本地虚拟资金**(非 OKX 模拟盘) | | 成交(默认) | **本地模拟撮合 + 本地虚拟资金**(非 OKX 模拟盘) |
@@ -152,6 +152,44 @@ OKX 实盘只读行情 (WS/REST)
## 6. 部署(Ubuntu 22.04 + PM2 ## 6. 部署(Ubuntu 22.04 + PM2
### 6.0 云服务器配置选择说明
本系统为 **轻量常驻进程**(行情 WebSocket + 策略 tick + FastAPI + SQLite),对 CPU/内存要求不高,但对 **网络延迟与稳定性** 要求高(连交易所 API)。
#### 推荐规格(单机专跑本系统)
| 场景 | vCPU | 内存 | 系统盘 | 带宽 | 说明 |
|------|------|------|--------|------|------|
| **最低可用(SIM 试跑)** | 1 | 1 GB | 20 GB SSD | ≥3 Mbps | 可装 Ubuntu + 本服务;偏紧,构建前端时可能吃紧 |
| **推荐(SIM / 小仓 LIVE** | **2** | **2 GB** | **40 GB SSD** | **≥5 Mbps** | 日常够用;前端 `npm build`、依赖安装更稳 |
| **余量(LIVE 长期 / 同机反代)** | 24 | 4 GB | 4080 GB SSD | ≥5 Mbps | 同机跑 nginx、日志、备份更从容 |
| **不建议** | 共享超售极低配、无稳定公网、国内机访问境外交易所极慢 | — | — | — | 行情断连、下单超时风险高 |
#### 地域与网络(比「堆配置」更重要)
| 项 | 建议 |
|----|------|
| **机房地域** | 优先选 **香港 / 新加坡 / 东京** 等对 OKX、币安延迟低的区域;大陆机房常需稳定出网或代理,不适合作为默认 LIVE 节点 |
| **公网** | 要有 **固定公网 IP**(或稳定入口);安全组放行 **5155**(或仅反代 443 |
| **延迟** | 部署后用本机测交易所 REST/WS;持续高延迟或频繁断线应换区,而不是盲目加 CPU |
| **隔离** | **单独一台**跑本系统;勿与现网 `crypto_monitor` 混用同一套密钥/同一 PM2 `restart all` |
#### 软件与其它选型
| 项 | 约定 |
|----|------|
| OS | **Ubuntu 22.04 LTS**(与一键脚本一致) |
| 磁盘 | SSD;日志与 SQLite 在本机,无需独立数据盘(仓位不大) |
| 架构 | **x86_64**(常规云主机);ARM 需自行验证 Node/Python 构建 |
| 面板 | 可选;一键部署只依赖 SSH + apt,不依赖宝塔等面板 |
| 反代 | 公网建议 **Nginx/Caddy + HTTPS**,后端仍监听本机 `5155` |
#### 选型速查
- **只想先 SIM 看盘跑策略**:香港/新加坡 **2C2G** 即可。
- **要 LIVE 真下单**:同样 **2C2G 起**,重点换到 **低延迟机房** 并配齐非默认 `AUTH_SECRET` + 交易密钥。
- **同机还要跑其它重服务**:升到 **4G 内存**,或把本系统拆到独立机。
### 6.1 建议目录 ### 6.1 建议目录
```text ```text
+9
View File
@@ -5,6 +5,15 @@
--- ---
## 2026-07-29 — 文档:云服务器配置选择说明
### 变更
1. [`docs/开发方案.md`](./开发方案.md) 增加 **§6.0 云服务器配置选择说明**(最低/推荐/余量规格、地域网络、选型速查)。
2. [`docs/商业化与授权方案.md`](./商业化与授权方案.md)、[`README.md`](../README.md) 同步交付速查与链接。
---
## 2026-07-29 — 第四轮:查仓失败≠空仓;回滚/账本幂等 ## 2026-07-29 — 第四轮:查仓失败≠空仓;回滚/账本幂等
### 变更 ### 变更