dekun
1282293e91
Add docs/ubuntu-server.md; remove Windows and alternate process managers from deployment guides; index strategy, key monitor, TP/SL, breakeven, and replay docs in root README. Co-authored-by: Cursor <cursoragent@cursor.com>
365 lines
9.5 KiB
Markdown
365 lines
9.5 KiB
Markdown
# `crypto_monitor_okx` 部署文档（Ubuntu）
|
||
|
||
**功能与页面操作** 见同目录 **[使用说明.md](./使用说明.md)**。Ubuntu 环境（Python / Node / PM2）见 **[docs/ubuntu-server.md](../docs/ubuntu-server.md)**。策略与 AI 见 **[策略交易说明.md](../策略交易说明.md)**、**[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。
|
||
|
||
---
|
||
|
||
# 本地部署 + SSH SOCKS 转发 + PM2 启动指南（Ubuntu）
|
||
|
||
本文面向：**本地 Ubuntu 机器运行项目**，但 **本机直连 OKX 会被 TLS/SNI reset** 的场景。解决思路是：
|
||
|
||
- 本机启动 `ssh -D` 动态转发，把 **SOCKS5 出口**放到你可正常访问 OKX 的 VPS 上
|
||
- 项目通过环境变量 `OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080` 让 `ccxt` 走 SOCKS
|
||
- **SSH 隧道**用 `ssh -D` 常驻（可用 tmux / autossh）；**Flask 应用** 仅用 **PM2** 托管（见 [docs/ubuntu-server.md](../docs/ubuntu-server.md)）
|
||
|
||
> 安全提醒：不要把 `.env`、私钥 `.pem`、OKX API Key 提交到 Git；文档里只用占位符。
|
||
|
||
---
|
||
|
||
## 0. 你需要准备的东西
|
||
|
||
- 一台 **Ubuntu** 本地机器（下文称“本机”）
|
||
- 一台可 SSH 登录、且 **能正常访问 OKX** 的 VPS（示例公网 IP：`47.76.87.111`，用户：`root`）
|
||
- VPS 登录方式：**SSH 私钥**（推荐）或密码（不推荐用于无人值守）
|
||
- 本机已安装：
|
||
- `python3`、`python3-venv`、`pip`（或 `python3-pip`）
|
||
- `git`（可选）
|
||
- `curl`、`ssh`
|
||
- `node` + `npm`（用于安装 `pm2`）
|
||
|
||
---
|
||
|
||
## 1. 从云服务器把项目同步到本地（推荐：打包下载）
|
||
|
||
在云服务器项目目录（包含 `app.py` 的目录）执行：
|
||
|
||
```bash
|
||
cd /opt/crypto_monitor/crypto_monitor_okx
|
||
|
||
# 可选：清理 Python 缓存，减少小文件传输
|
||
find . -type d -name __pycache__ -prune -exec rm -rf {} +
|
||
find . -type f -name "*.pyc" -delete
|
||
|
||
tar -czf crypto_monitor.tgz .
|
||
```
|
||
|
||
下载 `crypto_monitor.tgz` 到本机后解压：
|
||
|
||
```bash
|
||
mkdir -p /opt/crypto_monitor/crypto_monitor_okx
|
||
cd /opt/crypto_monitor
|
||
tar -xzf crypto_monitor.tgz -C crypto_monitor_okx
|
||
cd crypto_monitor_okx
|
||
cp -n .env.example .env # 若尚无 .env
|
||
```
|
||
|
||
---
|
||
|
||
## 2. 配置 SSH 私钥与 `~/.ssh/config`（推荐）
|
||
|
||
把私钥放到本机（示例：`~/.ssh/vps1.pem`），并设置权限：
|
||
|
||
```bash
|
||
mkdir -p ~/.ssh
|
||
chmod 700 ~/.ssh
|
||
mv ~/Downloads/vps1.pem ~/.ssh/vps1.pem
|
||
chmod 600 ~/.ssh/vps1.pem
|
||
```
|
||
|
||
编辑 `~/.ssh/config`（没有就创建），添加：
|
||
|
||
```sshconfig
|
||
Host okx-vps
|
||
HostName 47.76.87.111
|
||
User root
|
||
IdentityFile ~/.ssh/vps1.pem
|
||
IdentitiesOnly yes
|
||
ServerAliveInterval 30
|
||
ServerAliveCountMax 3
|
||
ExitOnForwardFailure yes
|
||
BatchMode yes
|
||
```
|
||
|
||
测试：
|
||
|
||
```bash
|
||
ssh okx-vps true
|
||
```
|
||
|
||
> 如果你还没完全切到密钥登录（还会交互要密码），先把 `BatchMode yes` 注释掉，等密钥登录稳定后再打开。
|
||
|
||
---
|
||
|
||
## 3. 先手工验证：SSH SOCKS + OKX API
|
||
|
||
### 3.1 开一个本地 SOCKS（1080）
|
||
|
||
```bash
|
||
ssh -N -D 127.0.0.1:1080 okx-vps
|
||
```
|
||
|
||
保持该进程运行（另开终端继续下面步骤）。
|
||
|
||
### 3.2 验证 OKX 走 SOCKS 可用
|
||
|
||
```bash
|
||
curl -4 -Iv --max-time 15 --proxy socks5h://127.0.0.1:1080 https://www.okx.com/api/v5/public/time
|
||
```
|
||
|
||
看到 `HTTP/2 200`（或至少 TLS 握手成功且返回 JSON）即 OK。
|
||
|
||
---
|
||
|
||
## 4. Python 虚拟环境（venv）
|
||
|
||
在本机项目目录：
|
||
|
||
```bash
|
||
cd /opt/crypto_monitor/crypto_monitor_okx
|
||
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
|
||
python -m pip install -U pip
|
||
pip install flask requests ccxt werkzeug PySocks Pillow
|
||
```
|
||
|
||
> 说明：本仓库当前没有 `requirements.txt`。如果你希望“完全复刻云服务器依赖”，可以在云服务器项目环境里执行 `pip freeze > requirements.txt` 带回本机再 `pip install -r requirements.txt`（记得删掉明显无关/体积巨大的包）。
|
||
|
||
建议减少 `.pyc` 垃圾文件（可选）：
|
||
|
||
```bash
|
||
export PYTHONDONTWRITEBYTECODE=1
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 配置环境变量（`.env.example` → `.env`）
|
||
|
||
| 文件 | 是否进 Git | 说明 |
|
||
|------|------------|------|
|
||
| **`.env.example`** | ✅ 是 | 变量模板与注释，可随 `git pull` 更新 |
|
||
| **`.env`** | ❌ 否 | 本机真实配置；`app.py` **只读此文件** |
|
||
|
||
### 5.1 首次配置
|
||
|
||
```bash
|
||
cd /opt/crypto_monitor/crypto_monitor_okx
|
||
|
||
cp -n .env.example .env # 已存在 .env 时不覆盖
|
||
nano .env
|
||
```
|
||
|
||
### 5.2 备份与 `git pull`
|
||
|
||
- **`.env` 不在 Git 中**：`git pull` **不会**覆盖本地 `.env`。
|
||
- 远端若更新 **`.env.example`**，pull 后请**手动**把新增变量补进你的 `.env`。
|
||
- **升级前备份**：`cp .env .env.backup.$(date +%Y%m%d)`；恢复：`cp .env.backup.YYYYMMDD .env`。
|
||
- **换机**：`scp` 复制 `.env`，或新机 `cp .env.example .env` 后重填。
|
||
|
||
**AI 复盘**：四所共用根目录 **`ai_client.py`**。默认 **`AI_PROVIDER=openai`**，网关 `https://op.bz121.com/v1`，模型 `gemma4:e4b`；或改 **`ollama`** 走本机 Ollama。PM2 须 **`PYTHONPATH=..`**。详见 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。
|
||
|
||
### 5.3 必填项检查（OKX + 代理）
|
||
|
||
至少确认/填写这些关键项（示例）：
|
||
|
||
```env
|
||
APP_HOST=127.0.0.1
|
||
APP_PORT=5000
|
||
|
||
# OKX（如需实盘）
|
||
LIVE_TRADING_ENABLED=false
|
||
OKX_API_KEY=...
|
||
OKX_API_SECRET=...
|
||
OKX_API_PASSPHRASE=...
|
||
|
||
# OKX 出口：走本机 SSH 动态转发 SOCKS
|
||
OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080
|
||
|
||
# 开仓多周期K线图（可选）
|
||
# ORDER_CHART_ENABLED=true
|
||
# ORDER_CHART_TFS=4h,1h,15m,5m
|
||
# ORDER_CHART_LIMIT=100
|
||
# ORDER_CHART_DIR=static/images/order_charts
|
||
# DAILY_OPEN_ALERT_THRESHOLD=5
|
||
|
||
# AI 复盘（默认 OpenAI 兼容网关；与 Ollama 二选一）
|
||
AI_PROVIDER=openai
|
||
AI_TIMEOUT_SECONDS=120
|
||
OPENAI_API_BASE=https://op.bz121.com/v1
|
||
OPENAI_API_KEY=你的密钥
|
||
OPENAI_MODEL=gemma4:e4b
|
||
# 本机 Ollama（仅 AI_PROVIDER=ollama）
|
||
OLLAMA_API=http://127.0.0.1:11434/api/generate
|
||
AI_MODEL=你的模型名
|
||
```
|
||
|
||
> 完整说明见仓库根 **[AI复盘与模型配置说明.md](../AI复盘与模型配置说明.md)**。`OPENAI_API_KEY` 在 [op.bz121.com](https://op.bz121.com/) 的 `gateway.json` 获取。
|
||
|
||
> `OKX_SOCKS_PROXY` 使用 `socks5h`：让 SOCKS 侧做域名解析（更贴近你 `curl --proxy socks5h://...` 的成功路径）。
|
||
|
||
---
|
||
|
||
## 6. 本机手工启动（验证 Flask）
|
||
|
||
确保：
|
||
|
||
1. SOCKS 隧道已运行（127.0.0.1:1080）
|
||
2. 虚拟环境已 `activate`
|
||
3. `.env` 已配置
|
||
|
||
启动：
|
||
|
||
```bash
|
||
cd /opt/crypto_monitor/crypto_monitor_okx
|
||
source .venv/bin/activate
|
||
python app.py
|
||
```
|
||
|
||
浏览器访问：`http://127.0.0.1:5000`（或你在 `.env` 配的端口）。
|
||
|
||
---
|
||
|
||
## 7. 安装 PM2（Node）
|
||
|
||
```bash
|
||
sudo npm i -g pm2
|
||
pm2 -v
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 用 PM2 启动 SSH SOCKS 隧道（推荐：密钥免交互）
|
||
|
||
### 8.1 启动隧道进程
|
||
|
||
```bash
|
||
pm2 start "ssh" --name okx-socks-tunnel -- \
|
||
-N -D 127.0.0.1:1080 okx-vps \
|
||
-o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
|
||
-o ExitOnForwardFailure=yes -o BatchMode=yes
|
||
```
|
||
|
||
查看日志：
|
||
|
||
```bash
|
||
pm2 logs okx-socks-tunnel --lines 200
|
||
```
|
||
|
||
### 8.2 仍然验证 OKX
|
||
|
||
```bash
|
||
curl -4 -Iv --max-time 15 --proxy socks5h://127.0.0.1:1080 https://www.okx.com/api/v5/public/time
|
||
```
|
||
|
||
### 8.3 开机自启（可选）
|
||
|
||
```bash
|
||
pm2 save
|
||
pm2 startup
|
||
```
|
||
|
||
---
|
||
|
||
## 9. 用 PM2 启动 Flask（`app.py`）
|
||
|
||
`pm2` 管理 Python 的常用方式是直接启动解释器：
|
||
|
||
```bash
|
||
cd /opt/crypto_monitor/crypto_monitor_okx
|
||
|
||
pm2 start /opt/crypto_monitor/crypto_monitor_okx/.venv/bin/python --name crypto-monitor -- \
|
||
/opt/crypto_monitor/crypto_monitor_okx/app.py
|
||
```
|
||
|
||
> 若项目目录与上文不一致，请替换为实际绝对路径；或用 `readlink -f app.py` 得到绝对路径。
|
||
|
||
查看日志：
|
||
|
||
```bash
|
||
pm2 logs crypto-monitor --lines 200
|
||
```
|
||
|
||
保存进程列表：
|
||
|
||
```bash
|
||
pm2 save
|
||
```
|
||
|
||
---
|
||
|
||
## 10. 常见问题排查（高频）
|
||
|
||
### 10.1 OKX 仍然失败：先看隧道是否在
|
||
|
||
```bash
|
||
ss -lntp | grep 1080 || true
|
||
pm2 status
|
||
```
|
||
|
||
### 10.2 `pm2` 里的 `ssh` 立刻退出
|
||
|
||
常见原因：
|
||
|
||
- 私钥权限不对（`chmod 600`）
|
||
- `~/.ssh/config` 写错 `HostName/User/IdentityFile`
|
||
- 开了 `BatchMode yes` 但仍需要密码（会失败）
|
||
|
||
### 10.3 `ccxt` SOCKS 报错 / 代理不生效
|
||
|
||
本机 Python 依赖通常需要：
|
||
|
||
```bash
|
||
source .venv/bin/activate
|
||
pip install PySocks
|
||
```
|
||
|
||
### 10.4 `.pyc` 很多导致同步慢
|
||
|
||
`.pyc` 是缓存，删除不影响功能：
|
||
|
||
```bash
|
||
find . -type d -name __pycache__ -prune -exec rm -rf {} +
|
||
find . -type f -name "*.pyc" -delete
|
||
```
|
||
|
||
---
|
||
|
||
## 11. 推荐的启动顺序（固定习惯）
|
||
|
||
1. `pm2` 启动 `okx-socks-tunnel`
|
||
2. `curl --proxy socks5h://127.0.0.1:1080 ...` 验证 OKX
|
||
3. `pm2` 启动 `crypto-monitor`
|
||
|
||
---
|
||
|
||
## 12. 免责声明
|
||
|
||
交易所有合规与地区政策要求。请确保你的使用方式符合当地法律法规与交易所条款。本文仅描述网络与工程部署技术路径。
|
||
|
||
|
||
|
||
|
||
写好了，脚本路径：
|
||
|
||
- `scripts/fix_breakeven_labels.py`
|
||
|
||
你在 Ubuntu 上这样用：
|
||
|
||
1) 先预览（不写库）：
|
||
```bash
|
||
python scripts/fix_breakeven_labels.py --db ./crypto.db --dry-run
|
||
```
|
||
|
||
2) 确认后执行：
|
||
```bash
|
||
python scripts/fix_breakeven_labels.py --db ./crypto.db --apply
|
||
```
|
||
|
||
默认修复条件就是你要的：
|
||
- `monitor_type='下单监控'`
|
||
- `result='止损'`
|
||
- `pnl_amount > 0`
|
||
- 改成 `result='保本止盈'`
|
||
|
||
如果你想，我还可以再给你一条“先自动备份 DB 再执行”的一键命令。 |