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>
2026-07-29 20:57:56 +08:00
parent 101cb3c045
commit c41122ae71
4 changed files with 507 additions and 446 deletions
@@ -16,6 +16,9 @@
 | 进程管理 | PM2（`eth-hedge-api`） |
 | 安装目录 | `/opt/eth_hedge_sim` |
 | 端口 | **5155** |
+| 云服务器（推荐） | **2 vCPU / 2 GB / 40 GB SSD**；地域优先香港、新加坡等低延迟区 |
+
+云服务器最低/推荐/余量规格、地域与带宽选择见 **[开发方案 §6.0 云服务器配置选择说明](docs/开发方案.md#60-云服务器配置选择说明)**。

 ## 文档

@@ -49,11 +49,22 @@

 ### 2.2 客户侧必备条件

- 一台独立 **Ubuntu 22.04** 主机（建议独立 IP）
- 出网访问目标交易所 API（OKX 等）
+- 一台独立 **Ubuntu 22.04** 主机（建议独立公网 IP）
+- **云服务器规格**：见下方「配置选择」；更完整说明见 [开发方案 §6.0](./开发方案.md#60-云服务器配置选择说明)
+- 出网访问目标交易所 API（OKX / 币安等）
 - 域名或 IP + HTTPS（可用反代）
 - 客户自备交易所 API Key（只读行情 / 实盘交易按档位要求）

+#### 云服务器配置选择（交付速查）
+
+| 用途 | 建议规格 | 地域 |
+|------|----------|------|
+| 演示 / SIM | 2 vCPU / 2 GB / 40 GB SSD | 香港或新加坡优先 |
+| LIVE 实盘 | 同上起配；网络优先于堆配置 | 对交易所延迟低的海外区 |
+| 最低试装 | 1 vCPU / 1 GB（仅短期试跑） | 同上 |
+
+不建议：超售共享低配、无稳定公网、大陆机房直连境外交易所作为默认 LIVE 节点。
+
 ### 2.3 部署流程（商用目标体验）

 1. 客户拿到安装脚本或镜像 + **授权码**
@@ -15,7 +15,7 @@
 | 产品名 | **比特骆驼自动化对冲系统** |
 | 工程名 / 目录名 | `eth_hedge_sim` |
 | 部署操作系统 | **Ubuntu 22.04** LTS |
-| 云服务器 | **单独一台 Ubuntu 22.04**（或同机不同目录/不同 PM2 进程名，且与现网隔离） |
+| 云服务器 | **单独一台 Ubuntu 22.04**；规格选型见 [§6.0 云服务器配置选择](#60-云服务器配置选择说明) |
 | 部署 | PM2 |
 | 行情 | OKX **实盘只读** API（REST + WebSocket） |
 | 成交（默认） | **本地模拟撮合 + 本地虚拟资金**（非 OKX 模拟盘） |
@@ -152,6 +152,44 @@ OKX 实盘只读行情 (WS/REST)

 ## 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 长期 / 同机反代）** | 2～4 | 4 GB | 40～80 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 建议目录

 ```text
@@ -5,6 +5,15 @@

 ---

+## 2026-07-29 — 文档：云服务器配置选择说明
+
+### 变更
+
+1. [`docs/开发方案.md`](./开发方案.md) 增加 **§6.0 云服务器配置选择说明**（最低/推荐/余量规格、地域网络、选型速查）。  
+2. [`docs/商业化与授权方案.md`](./商业化与授权方案.md)、[`README.md`](../README.md) 同步交付速查与链接。
+
+---
+
 ## 2026-07-29 — 第四轮：查仓失败≠空仓；回滚/账本幂等

 ### 变更