增加一键部署脚本
This commit is contained in:
dekun
+134
-134
@@ -1,134 +1,134 @@
|
||||
# 使用说明
|
||||
|
||||
**本文件对应仓库：`crypto_monitor_binance`（Binance U 本位永续）。**
|
||||
功能、界面与 **Gate.io USDT 永续版**（目录 `crypto_monitor_gate`）基本一致，差异主要在 **`.env` 里交易所密钥与部分参数名**（`BINANCE_*` / `GATE_*`），文末有对照。
|
||||
|
||||
**部署、代理、PM2 等**请参考本仓库说明或 **`crypto_monitor_gate`** 下的 **`部署文档.md`**（该文以 Gate + SSH SOCKS 为例；Binance 侧将 API 与密钥改为 `BINANCE_*` 即可类比）。
|
||||
**关键位自动开仓的规则、RR、结案原因**见本目录 **`关键位自动下单说明.md`**。
|
||||
|
||||
---
|
||||
|
||||
## 1. 它能做什么
|
||||
|
||||
面向个人盘面的 **Web 控制台**，主要能力包括：
|
||||
|
||||
| 模块 | 说明 |
|
||||
|------|------|
|
||||
| **关键位监控** | 录入上/下沿与类型，按 **5m 收线** 做硬条件过滤；符合条件后 **企业微信** 提醒，部分类型可 **自动市价开仓**（见第 4 节与专门文档）。 |
|
||||
| **实盘下单监控** | 手工填止损/止盈，**以损定仓** 市价开单，挂上条件止盈止损，并在页面跟踪浮盈亏、保本逻辑等。 |
|
||||
| **交易记录 / 复盘** | 平仓结果、盈亏、错过的单等归档与导出。 |
|
||||
|
||||
后台按 **`MONITOR_POLL_SECONDS`**（默认几秒）轮询行情与监控逻辑。**切勿**在未理解规则时同时运行两套程序共用一个实盘账户。
|
||||
|
||||
---
|
||||
|
||||
## 2. 运行前必须配置（`.env`）
|
||||
|
||||
首次在本目录执行 **`cp .env.example .env`**，再编辑 `.env`（`.env` 勿提交 Git；`git pull` 不会改你的 `.env`，升级前建议 `cp .env .env.backup.$(date +%Y%m%d)`）。
|
||||
|
||||
至少检查以下项（具体键名以 **`.env.example`** 为准）：
|
||||
|
||||
| 类别 | 说明 |
|
||||
|------|------|
|
||||
| **登录网页** | `APP_PASSWORD`：打开站点后的登录口令。`FLASK_SECRET_KEY`：Session 密钥，请勿使用默认值。 |
|
||||
| **企业微信** | `WECHAT_WEBHOOK`：告警与关键位推送机器人的 Webhook。 |
|
||||
| **是否真下单** | `LIVE_TRADING_ENABLED=false`：**不会**向交易所发送开仓指令（适合测试流程）。改为 `true` 且密钥正确才会实盘。 |
|
||||
| **交易所 API** | **本仓库：** `BINANCE_API_KEY`、`BINANCE_API_SECRET`；永续相关见 `BINANCE_MARGIN_MODE`、`BINANCE_POSITION_MODE`、`BINANCE_TRIGGER_WORKING_TYPE` 等。**勿**把 `.env` 提交到 Git。 |
|
||||
| **关键位 RR / 止损外扩** | `KEY_AUTO_MIN_PLANNED_RR`、`KEY_STOP_OUTSIDE_BREAKOUT_PCT`（详见 `关键位自动下单说明.md`）。 |
|
||||
|
||||
网络需要代理时可配置 **`BINANCE_SOCKS_PROXY` / `BINANCE_HTTP_PROXY`**（与 Gate 版 `GATE_*_PROXY` 用法类似）。
|
||||
|
||||
---
|
||||
|
||||
## 3. 如何启动与登录
|
||||
|
||||
1. 准备 Python 虚拟环境并安装依赖（如 `flask`、`requests`、`ccxt`、按需 `Pillow`、`PySocks` 等），配置好 `.env`。
|
||||
2. 启动 Flask 应用（可用 **`ecosystem.config.cjs`** 交给 PM2，或本地 `python app.py` / `flask run`，以你当前脚本为准）。
|
||||
3. 浏览器访问站点，打开 **`/login`**，使用 **`.env` 里的 `APP_PASSWORD`** 登录。
|
||||
|
||||
登录后顶栏为四页：**关键位监控** | **实盘下单**（默认首页）| **交易记录与复盘** | **统计分析**。
|
||||
|
||||
---
|
||||
|
||||
## 4. 关键位监控（顶栏「关键位监控」→ `/key_monitor`）
|
||||
|
||||
### 4.1 添加一条关键位
|
||||
|
||||
1. **币种**：如 `BTC` 或 `BTC/USDT`（会规范成内部符号）。
|
||||
2. **类型**（必选其一）：
|
||||
|
||||
| 类型 | 行为摘要 |
|
||||
|------|----------|
|
||||
| **箱体突破** | 通过门控且计划 RR 达标 → **自动市价开仓**（需 `LIVE_TRADING_ENABLED=true` 且无其他持仓占位）。结案后本条从列表消失并记入历史。 |
|
||||
| **收敛突破** | 同上（自动开仓类）。 |
|
||||
| **关键阻力位** | **不自动开仓**；触发后 **发 1 次微信**，然后本条 **结案进历史**。 |
|
||||
| **关键支撑位** | 同上（仅提醒）。 |
|
||||
|
||||
3. **方向**：做多 / 做空（必选）。
|
||||
4. **上沿 / 下沿**：必填；保存时会按交易所 **价格精度** 取整。
|
||||
|
||||
**限制：**
|
||||
活跃持仓数达到 **`MAX_ACTIVE_POSITIONS`**（默认 1）时，**不允许**再添加「**箱体突破** / **收敛突破**」；仍可添加「**关键阻力位 / 支撑位**」。
|
||||
若 **4h EMA55** 与你的方向逆势，页面会 **额外 Flash 提示**，**不阻挡**提交。
|
||||
|
||||
### 4.2 触发后会发生什么（简版）
|
||||
|
||||
- **箱体 / 收敛**：门控通过后算计划 SL/TP 与 RR；不达标 → 微信说明 + **`rr_insufficient`** 结案；达标 → **市价开仓**，成功 **`auto_opened`** / 失败 **`exchange_failed`**，均不重试同一关键位。
|
||||
- **阻力 / 支撑**：仅 **单次推送** → **`key_level_alert_only`** 结案。
|
||||
|
||||
详细公式与字段见 **`关键位自动下单说明.md`**。
|
||||
|
||||
### 4.3 列表与历史
|
||||
|
||||
当前条目与历史记录的用法与 Gate 版相同；结案后可在历史区查阅 **`close_reason`**。
|
||||
|
||||
---
|
||||
|
||||
## 5. 实盘下单（顶栏「实盘下单」→ `/trade`）
|
||||
|
||||
- 持仓上限由 **`MAX_ACTIVE_POSITIONS`** 控制（默认 1）。
|
||||
- **人工开仓**计划盈亏比不得低于 **`MANUAL_MIN_PLANNED_RR`**（默认 1.4:1）。
|
||||
- 填写币种、方向、杠杆（可选）、止损/止盈（价格或百分比按表单）。
|
||||
- 移动保本等选项按页面与 `.env` 默认。
|
||||
|
||||
开仓成功后卡片 **「来源」**：手工一般为 **下单监控**；关键位自动为 **关键位监控**。
|
||||
|
||||
---
|
||||
|
||||
## 6. 企业微信
|
||||
|
||||
推送逻辑与 Gate 版一致；未配置 **`WECHAT_WEBHOOK`** 时可能没有消息，请以 **交易所端** 核对持仓与挂单。
|
||||
|
||||
---
|
||||
|
||||
## 7. 强烈建议的风险与运维习惯
|
||||
|
||||
1. **先用 `LIVE_TRADING_ENABLED=false`** 熟悉流程再实盘。
|
||||
2. **API 权限**最小化，密钥勿泄露。
|
||||
3. **同一账户避免多程序重复开仓**。
|
||||
4. **自动备份**：服务器上执行 `bash scripts/install_backup_cron.sh`（每天北京时间 0:00 → `/root/backups`，保留 30 天）；升级前也可 `bash scripts/backup_data.sh` 手动跑一次。
|
||||
5. 升级代码后留意 **首轮启动**有无数据库迁移报错。
|
||||
|
||||
---
|
||||
|
||||
## 8. 常见问题（简要）
|
||||
|
||||
| 现象 | 可自查 |
|
||||
|------|--------|
|
||||
| 关键位永远不触发 | 门控五项、日成交量排名、`KLINE_TIMEFRAME`。 |
|
||||
| 有信号但不自动开仓 | `LIVE_TRADING_ENABLED`、RR 阈值、是否已有持仓、API/保证金错误信息。 |
|
||||
| 加不了箱体/收敛 | 是否已有持仓。 |
|
||||
| 推送收不到 | Webhook、网络。 |
|
||||
|
||||
---
|
||||
|
||||
## 9. Gate 版（`crypto_monitor_gate`）差异速查
|
||||
|
||||
| 项目 | Binance 本仓库 | Gate 版 |
|
||||
|------|----------------|--------|
|
||||
| API 变量 | `BINANCE_API_KEY`、`BINANCE_API_SECRET`、`BINANCE_*` | `GATE_API_KEY`、`GATE_API_SECRET`、`GATE_*` |
|
||||
| 代理示例 | `BINANCE_SOCKS_PROXY` | `GATE_SOCKS_PROXY` |
|
||||
| TP/SL 实现 | `_binance_place_tp_sl_orders` | `_gate_place_tp_sl_orders`、`GATE_TPSL_*` |
|
||||
| 资金舍入口径 | **`FUNDS_DECIMALS`**（与记账一致） | 以 Gate 仓库实现为准 |
|
||||
|
||||
业务流程（登录、四种关键位、手工单、单仓）两份程序对齐；仅需更换目录与 `.env`。
|
||||
# 使用说明
|
||||
|
||||
**本文件对应仓库：`crypto_monitor_binance`（Binance U 本位永续）。**
|
||||
功能、界面与 **Gate.io USDT 永续版**（目录 `crypto_monitor_gate`）基本一致，差异主要在 **`.env` 里交易所密钥与部分参数名**（`BINANCE_*` / `GATE_*`），文末有对照。
|
||||
|
||||
**部署、代理、PM2 等**请参考本仓库说明或 **`crypto_monitor_gate`** 下的 **`部署文档.md`**（该文以 Gate + SSH SOCKS 为例；Binance 侧将 API 与密钥改为 `BINANCE_*` 即可类比）。
|
||||
**关键位自动开仓的规则、RR、结案原因**见本目录 **`关键位自动下单说明.md`**。
|
||||
|
||||
---
|
||||
|
||||
## 1. 它能做什么
|
||||
|
||||
面向个人盘面的 **Web 控制台**，主要能力包括：
|
||||
|
||||
| 模块 | 说明 |
|
||||
|------|------|
|
||||
| **关键位监控** | 录入上/下沿与类型，按 **5m 收线** 做硬条件过滤；符合条件后 **企业微信** 提醒，部分类型可 **自动市价开仓**（见第 4 节与专门文档）。 |
|
||||
| **实盘下单监控** | 手工填止损/止盈，**以损定仓** 市价开单，挂上条件止盈止损，并在页面跟踪浮盈亏、保本逻辑等。 |
|
||||
| **交易记录 / 复盘** | 平仓结果、盈亏、错过的单等归档与导出。 |
|
||||
|
||||
后台按 **`MONITOR_POLL_SECONDS`**（默认几秒）轮询行情与监控逻辑。**切勿**在未理解规则时同时运行两套程序共用一个实盘账户。
|
||||
|
||||
---
|
||||
|
||||
## 2. 运行前必须配置（`.env`）
|
||||
|
||||
首次在本目录执行 **`cp .env.example .env`**，再编辑 `.env`（`.env` 勿提交 Git；`git pull` 不会改你的 `.env`，升级前建议 `cp .env .env.backup.$(date +%Y%m%d)`）。
|
||||
|
||||
至少检查以下项（具体键名以 **`.env.example`** 为准）：
|
||||
|
||||
| 类别 | 说明 |
|
||||
|------|------|
|
||||
| **登录网页** | `APP_PASSWORD`：打开站点后的登录口令。`FLASK_SECRET_KEY`：Session 密钥，请勿使用默认值。 |
|
||||
| **企业微信** | `WECHAT_WEBHOOK`：告警与关键位推送机器人的 Webhook。 |
|
||||
| **是否真下单** | `LIVE_TRADING_ENABLED=false`：**不会**向交易所发送开仓指令（适合测试流程）。改为 `true` 且密钥正确才会实盘。 |
|
||||
| **交易所 API** | **本仓库：** `BINANCE_API_KEY`、`BINANCE_API_SECRET`；永续相关见 `BINANCE_MARGIN_MODE`、`BINANCE_POSITION_MODE`、`BINANCE_TRIGGER_WORKING_TYPE` 等。**勿**把 `.env` 提交到 Git。 |
|
||||
| **关键位 RR / 止损外扩** | `KEY_AUTO_MIN_PLANNED_RR`、`KEY_STOP_OUTSIDE_BREAKOUT_PCT`（详见 `关键位自动下单说明.md`）。 |
|
||||
|
||||
网络需要代理时可配置 **`BINANCE_SOCKS_PROXY` / `BINANCE_HTTP_PROXY`**（与 Gate 版 `GATE_*_PROXY` 用法类似）。
|
||||
|
||||
---
|
||||
|
||||
## 3. 如何启动与登录
|
||||
|
||||
1. 准备 Python 虚拟环境并安装依赖（如 `flask`、`requests`、`ccxt`、按需 `Pillow`、`PySocks` 等），配置好 `.env`。
|
||||
2. 启动 Flask 应用（可用 **`ecosystem.config.cjs`** 交给 PM2，或本地 `python app.py` / `flask run`，以你当前脚本为准）。
|
||||
3. 浏览器访问站点，打开 **`/login`**，使用 **`.env` 里的 `APP_PASSWORD`** 登录。
|
||||
|
||||
登录后顶栏为四页：**关键位监控** | **实盘下单**（默认首页）| **交易记录与复盘** | **统计分析**。
|
||||
|
||||
---
|
||||
|
||||
## 4. 关键位监控（顶栏「关键位监控」→ `/key_monitor`）
|
||||
|
||||
### 4.1 添加一条关键位
|
||||
|
||||
1. **币种**：如 `BTC` 或 `BTC/USDT`（会规范成内部符号）。
|
||||
2. **类型**（必选其一）：
|
||||
|
||||
| 类型 | 行为摘要 |
|
||||
|------|----------|
|
||||
| **箱体突破** | 通过门控且计划 RR 达标 → **自动市价开仓**（需 `LIVE_TRADING_ENABLED=true` 且无其他持仓占位）。结案后本条从列表消失并记入历史。 |
|
||||
| **收敛突破** | 同上（自动开仓类）。 |
|
||||
| **关键阻力位** | **不自动开仓**；触发后 **发 1 次微信**，然后本条 **结案进历史**。 |
|
||||
| **关键支撑位** | 同上（仅提醒）。 |
|
||||
|
||||
3. **方向**：做多 / 做空（必选）。
|
||||
4. **上沿 / 下沿**：必填；保存时会按交易所 **价格精度** 取整。
|
||||
|
||||
**限制：**
|
||||
活跃持仓数达到 **`MAX_ACTIVE_POSITIONS`**（默认 1）时，**不允许**再添加「**箱体突破** / **收敛突破**」；仍可添加「**关键阻力位 / 支撑位**」。
|
||||
若 **4h EMA55** 与你的方向逆势，页面会 **额外 Flash 提示**，**不阻挡**提交。
|
||||
|
||||
### 4.2 触发后会发生什么（简版）
|
||||
|
||||
- **箱体 / 收敛**：门控通过后算计划 SL/TP 与 RR；不达标 → 微信说明 + **`rr_insufficient`** 结案；达标 → **市价开仓**，成功 **`auto_opened`** / 失败 **`exchange_failed`**，均不重试同一关键位。
|
||||
- **阻力 / 支撑**：仅 **单次推送** → **`key_level_alert_only`** 结案。
|
||||
|
||||
详细公式与字段见 **`关键位自动下单说明.md`**。
|
||||
|
||||
### 4.3 列表与历史
|
||||
|
||||
当前条目与历史记录的用法与 Gate 版相同；结案后可在历史区查阅 **`close_reason`**。
|
||||
|
||||
---
|
||||
|
||||
## 5. 实盘下单（顶栏「实盘下单」→ `/trade`）
|
||||
|
||||
- 持仓上限由 **`MAX_ACTIVE_POSITIONS`** 控制（默认 1）。
|
||||
- **人工开仓**计划盈亏比不得低于 **`MANUAL_MIN_PLANNED_RR`**（默认 1.4:1）。
|
||||
- 填写币种、方向、杠杆（可选）、止损/止盈（价格或百分比按表单）。
|
||||
- 移动保本等选项按页面与 `.env` 默认。
|
||||
|
||||
开仓成功后卡片 **「来源」**：手工一般为 **下单监控**；关键位自动为 **关键位监控**。
|
||||
|
||||
---
|
||||
|
||||
## 6. 企业微信
|
||||
|
||||
推送逻辑与 Gate 版一致；未配置 **`WECHAT_WEBHOOK`** 时可能没有消息，请以 **交易所端** 核对持仓与挂单。
|
||||
|
||||
---
|
||||
|
||||
## 7. 强烈建议的风险与运维习惯
|
||||
|
||||
1. **先用 `LIVE_TRADING_ENABLED=false`** 熟悉流程再实盘。
|
||||
2. **API 权限**最小化，密钥勿泄露。
|
||||
3. **同一账户避免多程序重复开仓**。
|
||||
4. **自动备份**：服务器上执行 `bash scripts/install_backup_cron.sh`（每天北京时间 0:00 → `/root/backups`，保留 30 天）；升级前也可 `bash scripts/backup_data.sh` 手动跑一次。
|
||||
5. 升级代码后留意 **首轮启动**有无数据库迁移报错。
|
||||
|
||||
---
|
||||
|
||||
## 8. 常见问题（简要）
|
||||
|
||||
| 现象 | 可自查 |
|
||||
|------|--------|
|
||||
| 关键位永远不触发 | 门控五项、日成交量排名、`KLINE_TIMEFRAME`。 |
|
||||
| 有信号但不自动开仓 | `LIVE_TRADING_ENABLED`、RR 阈值、是否已有持仓、API/保证金错误信息。 |
|
||||
| 加不了箱体/收敛 | 是否已有持仓。 |
|
||||
| 推送收不到 | Webhook、网络。 |
|
||||
|
||||
---
|
||||
|
||||
## 9. Gate 版（`crypto_monitor_gate`）差异速查
|
||||
|
||||
| 项目 | Binance 本仓库 | Gate 版 |
|
||||
|------|----------------|--------|
|
||||
| API 变量 | `BINANCE_API_KEY`、`BINANCE_API_SECRET`、`BINANCE_*` | `GATE_API_KEY`、`GATE_API_SECRET`、`GATE_*` |
|
||||
| 代理示例 | `BINANCE_SOCKS_PROXY` | `GATE_SOCKS_PROXY` |
|
||||
| TP/SL 实现 | `_binance_place_tp_sl_orders` | `_gate_place_tp_sl_orders`、`GATE_TPSL_*` |
|
||||
| 资金舍入口径 | **`FUNDS_DECIMALS`**（与记账一致） | 以 Gate 仓库实现为准 |
|
||||
|
||||
业务流程（登录、四种关键位、手工单、单仓）两份程序对齐；仅需更换目录与 `.env`。
|
||||
|
||||
+101
-101
@@ -1,101 +1,101 @@
|
||||
# 关键位自动下单说明
|
||||
|
||||
**适用仓库：`crypto_monitor_binance`｜交易所：Binance U 本位永续**（Gate 版见同名的 `crypto_monitor_gate` 目录。）
|
||||
|
||||
本文档与 `.env`、`app.check_key_monitors`、`app.add_key`、`_market_open_for_key_monitor` 的实现一致。
|
||||
|
||||
---
|
||||
|
||||
## 结构与是否自动开仓
|
||||
|
||||
| `key_monitors.monitor_type`（录入类型） | 自动下单 | 触发后处置 |
|
||||
|---------------------------------------|----------|------------|
|
||||
| **箱体突破** | 是（满足全部条件） | **一次性结案**：写 `key_monitor_history` → 从 `key_monitors` **删除** |
|
||||
| **收敛突破** | 是（同上） | 同上 |
|
||||
| **关键阻力位** | 否 | 企业微信 **1 次** → `close_reason=key_level_alert_only` → **失效** |
|
||||
| **关键支撑位** | 否 | 同上 |
|
||||
|
||||
触发条件：**5m 收线硬门控** `_key_hard_checks`（量能、突破幅度、第二根收盘确认、日成交量前 30 等）。
|
||||
|
||||
---
|
||||
|
||||
## 录入限制（`/add_key`）
|
||||
|
||||
- 存在 **`order_monitors.status='active'`** 时：**禁止添加** 「箱体突破」「收敛突破」。
|
||||
- **关键阻力位 / 关键支撑位**：不受上条限制；触发后 **仅单次微信提醒**，然后结案。
|
||||
- **4h EMA55 与所选方向逆势**：**不拦截**；添加成功后 **Flash** 提示。
|
||||
- 上下沿入库前经 **`round_price_to_exchange`** 按合约 **价格精度** 取整。
|
||||
|
||||
---
|
||||
|
||||
## 环境与参数（`.env`）
|
||||
|
||||
| 变量 | 含义 | 默认 |
|
||||
|------|------|------|
|
||||
| `KEY_AUTO_MIN_PLANNED_RR` | 计划 RR 阈值：**仅当严格大于该值** 才自动开仓（按下方 `E` 计算） | `1.5` |
|
||||
| `KEY_STOP_OUTSIDE_BREAKOUT_PCT` | 止损：突破 K 极值向外 **百分比**（多：`低×(1−p/100)`；空：`高×(1+p/100)`） | `0.5` |
|
||||
|
||||
**其余与本仓库手动实盘一致：** `KLINE_TIMEFRAME`、`RISK_PERCENT`、`LIVE_TRADING_ENABLED`、`BREAKEVEN_*`、`DAILY_OPEN_ALERT_THRESHOLD`，以及 **`BINANCE_*`**（密钥、`BINANCE_MARGIN_MODE`、`BINANCE_POSITION_MODE`、`BINANCE_TRIGGER_WORKING_TYPE` 等）。资金字段舍入端口径与 **`FUNDS_DECIMALS`** 一致。
|
||||
|
||||
---
|
||||
|
||||
## 计价与下单口径
|
||||
|
||||
| 用途 | 价格 |
|
||||
|------|------|
|
||||
| 企业微信展示、**与 RR 门槛比较的计划 RR** | 确认 K（第二根闭合 5m）收盘 **`E`** |
|
||||
| **实际开仓** | **市价**（`place_exchange_order`，与 `/add_order` 一致）；成交价可能与 `E` **滑点** |
|
||||
| **以损定仓** | `calc_risk_fraction(direction, 当前市价, 止损)` + `RISK_PERCENT`（保证金等 **`FUNDS_DECIMALS`** 舍入，与 `/add_order` 一致） |
|
||||
|
||||
- 开仓成功后：`order_monitors.monitor_type` 为 **关键位监控**；持仓卡片「来源」显示之。手动开仓为 **下单监控**。
|
||||
- 持仓列表中的 **盈亏比**：按 **实际成交价** 相对 SL/TP 重算，可与「按 `E` 算的计划 RR」略有偏差。
|
||||
- **本仓库止盈止损挂单**：开仓后由 **`_binance_place_tp_sl_orders`** 挂载（与手动一致：U 本位条件/Algo 类触发单；具体类型以 ccxt / 交易所为准）。
|
||||
|
||||
---
|
||||
|
||||
## 自动单止盈 / 止损（仅箱体突破、收敛突破）
|
||||
|
||||
添加关键位时在页面选择 **止盈止损方案**（写入 `key_monitors.sl_tp_mode`）。确认 K 收盘 **E**，箱体高 **H = |upper − lower|`**。
|
||||
|
||||
| 方案 | `sl_tp_mode` | 多：SL / TP | 空：SL / TP |
|
||||
|------|--------------|-------------|-------------|
|
||||
| 标准突破（默认） | `standard` | 突破 K 低 × (1−`KEY_STOP_OUTSIDE_BREAKOUT_PCT`%) / **E+H** | 突破 K 高 × (1+外侧%) / **E−H** |
|
||||
| 箱体1R·止盈1.5H | `box_1p5` | **E−H** / **E+1.5×H**（RR≈1.5） | **E+H** / **E−1.5×H** |
|
||||
| 趋势单·自填止盈 | `trend_manual` | 突破 K 低 × (1−`KEY_TREND_STOP_OUTSIDE_PCT`%) / **录入止盈** | 突破 K 高 × (1+外侧%) / **录入止盈** |
|
||||
|
||||
计划 **`RR = calc_rr_ratio(direction, E, SL, TP)`**。若为 `None` 或 **RR ≤ `KEY_AUTO_MIN_PLANNED_RR`** → **不下单**，走 `rr_insufficient` 结案。
|
||||
|
||||
**移动保本：** 添加时可勾选（默认关）；开仓写入 `order_monitors.breakeven_enabled` 与勾选一致。详见仓库根目录 `关键位止盈止损与移动保本更新说明.md`。
|
||||
|
||||
---
|
||||
|
||||
## 一次性结案（`close_reason`）
|
||||
|
||||
以下任一发生：**按需发微信** → **`key_monitor_history`** → **从 `key_monitors` 删除**；**不会对同一条关键位重复轮询重试开仓**。
|
||||
|
||||
| `close_reason` | 含义 |
|
||||
|----------------|------|
|
||||
| `rr_insufficient` | 门控通过，但计划 RR 未达标或 SL/TP / RR **几何无效** |
|
||||
| `exchange_failed` | 计划 RR 达标，但未开实盘、`LIVE_TRADING_ENABLED=false`、风控、保证金或 **交易所报错** 等导致 **开仓失败** |
|
||||
| `auto_opened` | 计划 RR 达标且 **市价开仓成功**（已写 `order_monitors`，并已挂止盈止损） |
|
||||
| `key_level_alert_only` | 阻力/支撑位 **仅推送**结案 |
|
||||
|
||||
---
|
||||
|
||||
## 与企业微信推送
|
||||
|
||||
每种结案路径 **至多一条**主业务推送（RR 不足 / 下单失败 / 开仓成功 / 阻力支撑仅提醒）。
|
||||
|
||||
旧版「满 `KEY_ALERT_MAX_TIMES` 次再归档」对已触发结案的路径 **不再适用**；表中 `notification_count`、`max_notify` 等字段仍可能存在，以 **导出、兼容** 为主。
|
||||
|
||||
---
|
||||
|
||||
## 相关代码位置（通用）
|
||||
|
||||
| 说明 | 符号 |
|
||||
|------|------|
|
||||
| 门控与主循环 | `check_key_monitors` |
|
||||
| 录入、有仓拦截、4h Flash | `add_key` |
|
||||
| 市价开仓 + 写 `order_monitors` | `_market_open_for_key_monitor` |
|
||||
| 计划 RR | `calc_rr_ratio(direction, E, SL, TP)` |
|
||||
| 价格精度 | `round_price_to_exchange` |
|
||||
# 关键位自动下单说明
|
||||
|
||||
**适用仓库：`crypto_monitor_binance`｜交易所：Binance U 本位永续**（Gate 版见同名的 `crypto_monitor_gate` 目录。）
|
||||
|
||||
本文档与 `.env`、`app.check_key_monitors`、`app.add_key`、`_market_open_for_key_monitor` 的实现一致。
|
||||
|
||||
---
|
||||
|
||||
## 结构与是否自动开仓
|
||||
|
||||
| `key_monitors.monitor_type`（录入类型） | 自动下单 | 触发后处置 |
|
||||
|---------------------------------------|----------|------------|
|
||||
| **箱体突破** | 是（满足全部条件） | **一次性结案**：写 `key_monitor_history` → 从 `key_monitors` **删除** |
|
||||
| **收敛突破** | 是（同上） | 同上 |
|
||||
| **关键阻力位** | 否 | 企业微信 **1 次** → `close_reason=key_level_alert_only` → **失效** |
|
||||
| **关键支撑位** | 否 | 同上 |
|
||||
|
||||
触发条件：**5m 收线硬门控** `_key_hard_checks`（量能、突破幅度、第二根收盘确认、日成交量前 30 等）。
|
||||
|
||||
---
|
||||
|
||||
## 录入限制（`/add_key`）
|
||||
|
||||
- 存在 **`order_monitors.status='active'`** 时：**禁止添加** 「箱体突破」「收敛突破」。
|
||||
- **关键阻力位 / 关键支撑位**：不受上条限制；触发后 **仅单次微信提醒**，然后结案。
|
||||
- **4h EMA55 与所选方向逆势**：**不拦截**；添加成功后 **Flash** 提示。
|
||||
- 上下沿入库前经 **`round_price_to_exchange`** 按合约 **价格精度** 取整。
|
||||
|
||||
---
|
||||
|
||||
## 环境与参数（`.env`）
|
||||
|
||||
| 变量 | 含义 | 默认 |
|
||||
|------|------|------|
|
||||
| `KEY_AUTO_MIN_PLANNED_RR` | 计划 RR 阈值：**仅当严格大于该值** 才自动开仓（按下方 `E` 计算） | `1.5` |
|
||||
| `KEY_STOP_OUTSIDE_BREAKOUT_PCT` | 止损：突破 K 极值向外 **百分比**（多：`低×(1−p/100)`；空：`高×(1+p/100)`） | `0.5` |
|
||||
|
||||
**其余与本仓库手动实盘一致：** `KLINE_TIMEFRAME`、`RISK_PERCENT`、`LIVE_TRADING_ENABLED`、`BREAKEVEN_*`、`DAILY_OPEN_ALERT_THRESHOLD`，以及 **`BINANCE_*`**（密钥、`BINANCE_MARGIN_MODE`、`BINANCE_POSITION_MODE`、`BINANCE_TRIGGER_WORKING_TYPE` 等）。资金字段舍入端口径与 **`FUNDS_DECIMALS`** 一致。
|
||||
|
||||
---
|
||||
|
||||
## 计价与下单口径
|
||||
|
||||
| 用途 | 价格 |
|
||||
|------|------|
|
||||
| 企业微信展示、**与 RR 门槛比较的计划 RR** | 确认 K（第二根闭合 5m）收盘 **`E`** |
|
||||
| **实际开仓** | **市价**（`place_exchange_order`，与 `/add_order` 一致）；成交价可能与 `E` **滑点** |
|
||||
| **以损定仓** | `calc_risk_fraction(direction, 当前市价, 止损)` + `RISK_PERCENT`（保证金等 **`FUNDS_DECIMALS`** 舍入，与 `/add_order` 一致） |
|
||||
|
||||
- 开仓成功后：`order_monitors.monitor_type` 为 **关键位监控**；持仓卡片「来源」显示之。手动开仓为 **下单监控**。
|
||||
- 持仓列表中的 **盈亏比**：按 **实际成交价** 相对 SL/TP 重算，可与「按 `E` 算的计划 RR」略有偏差。
|
||||
- **本仓库止盈止损挂单**：开仓后由 **`_binance_place_tp_sl_orders`** 挂载（与手动一致：U 本位条件/Algo 类触发单；具体类型以 ccxt / 交易所为准）。
|
||||
|
||||
---
|
||||
|
||||
## 自动单止盈 / 止损（仅箱体突破、收敛突破）
|
||||
|
||||
添加关键位时在页面选择 **止盈止损方案**（写入 `key_monitors.sl_tp_mode`）。确认 K 收盘 **E**，箱体高 **H = |upper − lower|`**。
|
||||
|
||||
| 方案 | `sl_tp_mode` | 多：SL / TP | 空：SL / TP |
|
||||
|------|--------------|-------------|-------------|
|
||||
| 标准突破（默认） | `standard` | 突破 K 低 × (1−`KEY_STOP_OUTSIDE_BREAKOUT_PCT`%) / **E+H** | 突破 K 高 × (1+外侧%) / **E−H** |
|
||||
| 箱体1R·止盈1.5H | `box_1p5` | **E−H** / **E+1.5×H**（RR≈1.5） | **E+H** / **E−1.5×H** |
|
||||
| 趋势单·自填止盈 | `trend_manual` | 突破 K 低 × (1−`KEY_TREND_STOP_OUTSIDE_PCT`%) / **录入止盈** | 突破 K 高 × (1+外侧%) / **录入止盈** |
|
||||
|
||||
计划 **`RR = calc_rr_ratio(direction, E, SL, TP)`**。若为 `None` 或 **RR ≤ `KEY_AUTO_MIN_PLANNED_RR`** → **不下单**，走 `rr_insufficient` 结案。
|
||||
|
||||
**移动保本：** 添加时可勾选（默认关）；开仓写入 `order_monitors.breakeven_enabled` 与勾选一致。详见仓库根目录 `关键位止盈止损与移动保本更新说明.md`。
|
||||
|
||||
---
|
||||
|
||||
## 一次性结案（`close_reason`）
|
||||
|
||||
以下任一发生：**按需发微信** → **`key_monitor_history`** → **从 `key_monitors` 删除**；**不会对同一条关键位重复轮询重试开仓**。
|
||||
|
||||
| `close_reason` | 含义 |
|
||||
|----------------|------|
|
||||
| `rr_insufficient` | 门控通过，但计划 RR 未达标或 SL/TP / RR **几何无效** |
|
||||
| `exchange_failed` | 计划 RR 达标，但未开实盘、`LIVE_TRADING_ENABLED=false`、风控、保证金或 **交易所报错** 等导致 **开仓失败** |
|
||||
| `auto_opened` | 计划 RR 达标且 **市价开仓成功**（已写 `order_monitors`，并已挂止盈止损） |
|
||||
| `key_level_alert_only` | 阻力/支撑位 **仅推送**结案 |
|
||||
|
||||
---
|
||||
|
||||
## 与企业微信推送
|
||||
|
||||
每种结案路径 **至多一条**主业务推送（RR 不足 / 下单失败 / 开仓成功 / 阻力支撑仅提醒）。
|
||||
|
||||
旧版「满 `KEY_ALERT_MAX_TIMES` 次再归档」对已触发结案的路径 **不再适用**；表中 `notification_count`、`max_notify` 等字段仍可能存在，以 **导出、兼容** 为主。
|
||||
|
||||
---
|
||||
|
||||
## 相关代码位置（通用）
|
||||
|
||||
| 说明 | 符号 |
|
||||
|------|------|
|
||||
| 门控与主循环 | `check_key_monitors` |
|
||||
| 录入、有仓拦截、4h Flash | `add_key` |
|
||||
| 市价开仓 + 写 `order_monitors` | `_market_open_for_key_monitor` |
|
||||
| 计划 RR | `calc_rr_ratio(direction, E, SL, TP)` |
|
||||
| 价格精度 | `round_price_to_exchange` |
|
||||
|
||||
+147
-147
@@ -1,147 +1,147 @@
|
||||
# 界面与风控更新说明（Binance 实例）
|
||||
|
||||
## 顶栏导航（4 项）
|
||||
|
||||
| 顺序 | 名称 | 路由 | 说明 |
|
||||
|------|------|------|------|
|
||||
| 1 | 关键位监控 | `/key_monitor` | 关键位添加、实时门控、历史 |
|
||||
| 2 | 实盘下单 | `/trade` | 人工开仓、划转、实时持仓（**默认首页** `/` → `/trade`） |
|
||||
| 3 | 交易记录与复盘 | `/records` | 交易记录、复盘表单、AI 历史（受顶栏 UTC 时间窗筛选） |
|
||||
| 4 | 统计分析 | `/stats` | 按北京时间交易日切日 + 分品类统计块 |
|
||||
|
||||
## 关键位监控页
|
||||
|
||||
- 标题去掉「5m」；规则条从 `.env` 读取（周期、确认K、量能、自动开仓盈亏比、日成交量排名）。
|
||||
- 左列：活跃关键位，**pos-card** 样式展示现价/距上沿/距下沿/门控。
|
||||
- 右列：关键位历史（失效/结案），与左列等高滚动；**受顶栏 UTC 列表时间窗筛选**（默认 UTC 当日）。
|
||||
- 监控类型新增：**斐波回调0.618**、**斐波回调0.786**（与 Gate 主站同一套规则，计算逻辑见仓库根目录 `fib_key_monitor_lib.py`）。
|
||||
|
||||
### 斐波关键位监控（方案 A：交易所限价）
|
||||
|
||||
| 项 | 说明 |
|
||||
|----|------|
|
||||
| 同币互斥 | 每个币种只能有一条斐波监控（0.618 与 0.786 不可并存） |
|
||||
| 上下沿 | 上沿 **H**、下沿 **L**（须 H > L） |
|
||||
| 挂单价 E | **做多** `E = H − ratio × (H − L)`（自 H 向下回撤）；**做空** `E = L + ratio × (H − L)`（自 L 向上反弹） |
|
||||
| 做多 | 限价 @ E，止损 L，止盈 H |
|
||||
| 做空 | 限价 @ E，止损 H，止盈 L |
|
||||
| 添加后 | **立即**在 Binance U 本位挂限价单；卡片显示 **挂E**、限价单 ID |
|
||||
| 失效 | 以**标记价**判断：做多且标记价 ≥ H、做空且标记价 ≤ L，且限价**未成交** → 撤销该限价单并结案 |
|
||||
| 成交后 | 挂交易所 TP/SL（含 Algo 通道条件单）→ 写入 **实盘下单监控**（`monitor_type=关键位监控`，`key_signal_type=斐波回调…`）→ 从关键位列表移除 |
|
||||
| 撤单 | 仅撤本条斐波的订单 ID，**不会**对该合约 `cancel_all_orders` / 全撤 Algo，避免误伤其他委托 |
|
||||
| 盈亏比 | 计划 RR 须 > `KEY_AUTO_MIN_PLANNED_RR`；0.618 理论约 1.6:1，0.786 约 3.7:1 |
|
||||
| 日成交量 | 与箱体/收敛相同，须在前 `KEY_DAILY_VOLUME_RANK_MAX` 名内方可添加 |
|
||||
|
||||
后台轮询：`check_fib_key_monitors()`；箱体/收敛仍走 `check_key_monitors()`。
|
||||
|
||||
手动删除关键位时，未成交斐波会先撤限价再删库。
|
||||
|
||||
### 箱体 / 收敛自动开仓（来源标注）
|
||||
|
||||
- 自动开仓写入 `order_monitors.key_signal_type`：`箱体突破` 或 `收敛突破`。
|
||||
- 持仓与交易记录展示「来源 · 信号类型」。
|
||||
|
||||
## 列表时间窗（UTC，全站顶栏）
|
||||
|
||||
共用模块：仓库根目录 `history_window_lib.py`（Gate / Binance 主站一致）。
|
||||
|
||||
| 项 | 说明 |
|
||||
|----|------|
|
||||
| 默认 | **UTC 当日**（`win_preset=utc_today`，从 UTC 0:00 至当前时刻） |
|
||||
| 可选 | 近 24 小时、近 7 天、自定义起止（UTC，`datetime-local`） |
|
||||
| 作用范围 | 关键位历史、交易记录列表、复盘记录 API、AI 历史 API、导出「交易记录」「关键位历史」 |
|
||||
| 与统计的关系 | **仅影响列表/导出**；**统计分析页仍按北京时间 `TRADING_DAY_RESET_HOUR`（默认 8:00）切交易日** |
|
||||
| 库内时间 | DB 存北京时间字符串；后端用 `utc_window_to_bj_sql_strings()` 换算后再 SQL 比较 |
|
||||
| 切换方式 | 顶栏「列表筛选（UTC）」→ 选预设 → **应用**（保留当前路由，如 `/records?win_preset=…`） |
|
||||
|
||||
查询参数示例：
|
||||
|
||||
- `?win_preset=utc_today`
|
||||
- `?win_preset=utc_last24h` / `utc_last7d`
|
||||
- `?win_preset=custom&from_utc=2026-05-18 00:00:00&to_utc=2026-05-19 12:00:00`
|
||||
|
||||
## 交易记录与复盘
|
||||
|
||||
- 交易记录盈亏以**本地估算**为准（平仓时按成交/计划价计算）；盈亏列可标注 **估**。
|
||||
- 与币安 App 不一致时，请在「核对修改」或复盘中 **手工填写** `reviewed_pnl_amount` 覆盖展示（不再提供批量「同步交易所盈亏」）。
|
||||
- **列表默认只显示当前 UTC 时间窗内**的记录（见上节）；导出 CSV 同步该时间窗。
|
||||
- 表头 **「止损(开仓)」**：展示开仓快照 `initial_stop_loss`（无则回退 `stop_loss`）；核对/复盘仍可用有效止损字段。
|
||||
- 平仓写入 `trade_records` 时：`stop_loss` 与 `initial_stop_loss` 均写入**开仓时止损快照**；`key_signal_type` 保留箱体/收敛/斐波来源（`fib_key_monitor_lib.key_signal_type_for_trade_record`）。
|
||||
- **开仓类型**（`entry_reason`）：机器单平仓入库时，若未手填，按 `key_signal_type` 自动映射（见下表）；列表/导出「开仓类型」列 = 复盘核对值优先，否则入库值，否则按信号映射。
|
||||
|
||||
| `key_signal_type` | 自动写入的 `entry_reason` |
|
||||
|-------------------|---------------------------|
|
||||
| 箱体突破 | 关键位箱体突破 |
|
||||
| 收敛突破 | 关键位收敛突破 |
|
||||
| 斐波回调0.618 | 关键位斐波0.618 |
|
||||
| 斐波回调0.786 | 关键位斐波0.786 |
|
||||
|
||||
- 复盘表单 **开仓类型** 下拉新增上述四条固定文案（与趋势/波段类并列）。
|
||||
- 复盘 **离场触发** 新增 **「止盈」**；从交易记录「填入复盘」时，若结果为「止盈/保本止盈/移动止盈/止损/手动平仓」会自动选中对应触发项，并按 `key_signal_type` 预填开仓类型。
|
||||
- 勾选「保存时自动生成多周期 K 线图」时：以 **平仓时间** 为锚点，各周期向前约 `ORDER_CHART_LIMIT`（默认 100）根 K 线（`_fetch_ohlcv_ending_at`），不再固定拉「最近 100 根」。
|
||||
- `/api/journals`、`/api/reviews` 支持同一时间窗 query，与列表一致。
|
||||
|
||||
### 导出（交易记录 v3）
|
||||
|
||||
- 文件名：`trade_records_v3_YYYYMMDD.csv`
|
||||
- 相对 v2 增加：`key_signal_type`、`initial_stop_loss`（及开仓快照列）、`planned_rr`、`actual_rr`、`risk_amount`、交易所盈亏与时间字段等；末列「开仓类型」为有效展示文案。
|
||||
- 「关键位历史」导出同样受 UTC 时间窗限制。
|
||||
|
||||
## 实盘下单页
|
||||
|
||||
- 左列：实盘下单监控（表单、划转、规则）。
|
||||
- 右列：实时持仓（独立模块）。
|
||||
- **人工开仓门控**：计划盈亏比 < `MANUAL_MIN_PLANNED_RR`（默认 **1.4**）时前端弹窗 + 后端拒绝。
|
||||
- **移动保本**（勾选启用）：监控轮询达到触发 RR 后，止损阶梯上移时**同步交易所**——**先撤**该合约全部 TP/SL（含 Algo 条件单）**再挂**新止损 + 原止盈（`replace_active_monitor_tpsl_on_exchange`）。仅交易所成功后才写库；失败发企业微信告警。未配置实盘 API 时仍只更新本地。
|
||||
|
||||
## 统计分析页（`/stats`）
|
||||
|
||||
| 项 | 说明 |
|
||||
|----|------|
|
||||
| 切日 | **北京时间**；交易日边界 = 每日 `TRADING_DAY_RESET_HOUR:00`（`.env` 默认 **8**） |
|
||||
| 品类下拉 | 页顶 **「统计品类」** 下拉切换（默认「全部交易」）：全部交易、下单监控、关键位箱体突破、关键位收敛结构、关键位斐波0.618、关键位斐波0.786；一次只显示所选品类的日/周/月 |
|
||||
| URL | 切换后写入 `stats_segment=`（如 `all`、`manual`、`key_box`、`key_conv`、`key_fib618`、`key_fib786`），刷新 `/stats` 可保持选项 |
|
||||
| 每块指标 | 日 / 周 / 月：开单次数、平仓笔数、胜率、净盈亏、回撤、连续亏损等（与原口径一致） |
|
||||
| 开单次数 | 人工块：`monitor_type=下单监控` 且无 `key_signal_type`；关键位块：按 `order_monitors.key_signal_type` 计数 |
|
||||
| 不受 UTC 窗影响 | 统计始终基于库内全部已平仓记录，按北京交易日归类，**不**随顶栏 UTC 列表窗切换 |
|
||||
|
||||
## 持仓与计仓
|
||||
|
||||
- `MAX_ACTIVE_POSITIONS` 默认 **1**（可在 `.env` 调大）。
|
||||
- 关键位自动开仓：在已有持仓时，若 `KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT=true`，按**首笔开仓前**交易账户资金快照计仓（字段 `trading_sessions.key_sizing_capital_snapshot`）。
|
||||
|
||||
## 配置
|
||||
|
||||
详见 `.env.example` 中「关键位门控」「交易执行 / 人工风控」注释段。
|
||||
|
||||
## 自动备份（服务器）
|
||||
|
||||
- 脚本：`scripts/backup_data.sh`（`crypto.db` + `static/images`）
|
||||
- 定时：`scripts/install_backup_cron.sh` → 每天 **北京时间 0:00**，目录 **`/root/backups/<实例名>/YYYY-MM-DD/`**，保留 **30** 天
|
||||
- 详见 `部署文档.md` 第 5.3 节
|
||||
|
||||
## 数据库（启动时自动迁移）
|
||||
|
||||
`key_monitors` 斐波字段：`fib_limit_order_id`、`fib_entry_price`、`fib_stop_loss`、`fib_take_profit`、`fib_order_amount`、`fib_margin_capital`、`fib_leverage`。
|
||||
|
||||
`trade_records` / `order_monitors`：`key_signal_type`、`exchange_realized_pnl`、`exchange_opened_at`、`exchange_closed_at`、`exchange_sync_key`、`entry_reason`、`reviewed_entry_reason`、`initial_stop_loss`。
|
||||
|
||||
**历史数据**：本次**不做**旧记录的批量回填（`entry_reason` / `initial_stop_loss` / `key_signal_type` 等）；仅**新产生**的平仓与复盘按新逻辑写入。旧行展示可回退已有字段。
|
||||
|
||||
## 涉及文件（便于排查）
|
||||
|
||||
| 路径 | 说明 |
|
||||
|------|------|
|
||||
| `history_window_lib.py` | UTC 时间窗解析与转北京时间 SQL 字符串 |
|
||||
| `fib_key_monitor_lib.py` | 斐波计算、`KEY_ENTRY_REASON_BY_SIGNAL`、`entry_reason_from_key_signal` |
|
||||
| `crypto_monitor_binance/app.py` | 列表筛选、统计分块、导出 v3、复盘 K 线锚点、入库逻辑 |
|
||||
| `crypto_monitor_binance/templates/index.html` | 顶栏时间窗、统计分块 UI、止损(开仓)列、复盘预填 |
|
||||
|
||||
## 升级步骤
|
||||
|
||||
1. `git pull` 后对比 `.env.example`，把新增变量合并进本地 `.env`。
|
||||
2. 在 VPS 上为 Binance / Gate / Gate Bot **各执行一次** `bash scripts/install_backup_cron.sh`（若尚未安装）。
|
||||
3. 重启 Binance 实例（如 `pm2 restart crypto_binance`）；SQLite 会自动 `ALTER` 缺列（斐波、交易所盈亏、`entry_reason` 等）。
|
||||
4. 浏览器强刷（Ctrl+F5）避免旧版 `index.html` 缓存。
|
||||
5. 打开任意页确认顶栏出现 **「列表筛选（UTC）」**；`/stats` 可见分品类统计与「北京 8:00 切日」说明。
|
||||
6. 建议先用测试币验证斐波：限价挂出、标记价失效撤单、成交后 TP/SL 与订单监控是否正常；平仓后检查交易记录止损(开仓)与开仓类型。
|
||||
# 界面与风控更新说明（Binance 实例）
|
||||
|
||||
## 顶栏导航（4 项）
|
||||
|
||||
| 顺序 | 名称 | 路由 | 说明 |
|
||||
|------|------|------|------|
|
||||
| 1 | 关键位监控 | `/key_monitor` | 关键位添加、实时门控、历史 |
|
||||
| 2 | 实盘下单 | `/trade` | 人工开仓、划转、实时持仓（**默认首页** `/` → `/trade`） |
|
||||
| 3 | 交易记录与复盘 | `/records` | 交易记录、复盘表单、AI 历史（受顶栏 UTC 时间窗筛选） |
|
||||
| 4 | 统计分析 | `/stats` | 按北京时间交易日切日 + 分品类统计块 |
|
||||
|
||||
## 关键位监控页
|
||||
|
||||
- 标题去掉「5m」；规则条从 `.env` 读取（周期、确认K、量能、自动开仓盈亏比、日成交量排名）。
|
||||
- 左列：活跃关键位，**pos-card** 样式展示现价/距上沿/距下沿/门控。
|
||||
- 右列：关键位历史（失效/结案），与左列等高滚动；**受顶栏 UTC 列表时间窗筛选**（默认 UTC 当日）。
|
||||
- 监控类型新增：**斐波回调0.618**、**斐波回调0.786**（与 Gate 主站同一套规则，计算逻辑见仓库根目录 `fib_key_monitor_lib.py`）。
|
||||
|
||||
### 斐波关键位监控（方案 A：交易所限价）
|
||||
|
||||
| 项 | 说明 |
|
||||
|----|------|
|
||||
| 同币互斥 | 每个币种只能有一条斐波监控（0.618 与 0.786 不可并存） |
|
||||
| 上下沿 | 上沿 **H**、下沿 **L**（须 H > L） |
|
||||
| 挂单价 E | **做多** `E = H − ratio × (H − L)`（自 H 向下回撤）；**做空** `E = L + ratio × (H − L)`（自 L 向上反弹） |
|
||||
| 做多 | 限价 @ E，止损 L，止盈 H |
|
||||
| 做空 | 限价 @ E，止损 H，止盈 L |
|
||||
| 添加后 | **立即**在 Binance U 本位挂限价单；卡片显示 **挂E**、限价单 ID |
|
||||
| 失效 | 以**标记价**判断：做多且标记价 ≥ H、做空且标记价 ≤ L，且限价**未成交** → 撤销该限价单并结案 |
|
||||
| 成交后 | 挂交易所 TP/SL（含 Algo 通道条件单）→ 写入 **实盘下单监控**（`monitor_type=关键位监控`，`key_signal_type=斐波回调…`）→ 从关键位列表移除 |
|
||||
| 撤单 | 仅撤本条斐波的订单 ID，**不会**对该合约 `cancel_all_orders` / 全撤 Algo，避免误伤其他委托 |
|
||||
| 盈亏比 | 计划 RR 须 > `KEY_AUTO_MIN_PLANNED_RR`；0.618 理论约 1.6:1，0.786 约 3.7:1 |
|
||||
| 日成交量 | 与箱体/收敛相同，须在前 `KEY_DAILY_VOLUME_RANK_MAX` 名内方可添加 |
|
||||
|
||||
后台轮询：`check_fib_key_monitors()`；箱体/收敛仍走 `check_key_monitors()`。
|
||||
|
||||
手动删除关键位时，未成交斐波会先撤限价再删库。
|
||||
|
||||
### 箱体 / 收敛自动开仓（来源标注）
|
||||
|
||||
- 自动开仓写入 `order_monitors.key_signal_type`：`箱体突破` 或 `收敛突破`。
|
||||
- 持仓与交易记录展示「来源 · 信号类型」。
|
||||
|
||||
## 列表时间窗（UTC，全站顶栏）
|
||||
|
||||
共用模块：仓库根目录 `history_window_lib.py`（Gate / Binance 主站一致）。
|
||||
|
||||
| 项 | 说明 |
|
||||
|----|------|
|
||||
| 默认 | **UTC 当日**（`win_preset=utc_today`，从 UTC 0:00 至当前时刻） |
|
||||
| 可选 | 近 24 小时、近 7 天、自定义起止（UTC，`datetime-local`） |
|
||||
| 作用范围 | 关键位历史、交易记录列表、复盘记录 API、AI 历史 API、导出「交易记录」「关键位历史」 |
|
||||
| 与统计的关系 | **仅影响列表/导出**；**统计分析页仍按北京时间 `TRADING_DAY_RESET_HOUR`（默认 8:00）切交易日** |
|
||||
| 库内时间 | DB 存北京时间字符串；后端用 `utc_window_to_bj_sql_strings()` 换算后再 SQL 比较 |
|
||||
| 切换方式 | 顶栏「列表筛选（UTC）」→ 选预设 → **应用**（保留当前路由，如 `/records?win_preset=…`） |
|
||||
|
||||
查询参数示例：
|
||||
|
||||
- `?win_preset=utc_today`
|
||||
- `?win_preset=utc_last24h` / `utc_last7d`
|
||||
- `?win_preset=custom&from_utc=2026-05-18 00:00:00&to_utc=2026-05-19 12:00:00`
|
||||
|
||||
## 交易记录与复盘
|
||||
|
||||
- 交易记录盈亏以**本地估算**为准（平仓时按成交/计划价计算）；盈亏列可标注 **估**。
|
||||
- 与币安 App 不一致时，请在「核对修改」或复盘中 **手工填写** `reviewed_pnl_amount` 覆盖展示（不再提供批量「同步交易所盈亏」）。
|
||||
- **列表默认只显示当前 UTC 时间窗内**的记录（见上节）；导出 CSV 同步该时间窗。
|
||||
- 表头 **「止损(开仓)」**：展示开仓快照 `initial_stop_loss`（无则回退 `stop_loss`）；核对/复盘仍可用有效止损字段。
|
||||
- 平仓写入 `trade_records` 时：`stop_loss` 与 `initial_stop_loss` 均写入**开仓时止损快照**；`key_signal_type` 保留箱体/收敛/斐波来源（`fib_key_monitor_lib.key_signal_type_for_trade_record`）。
|
||||
- **开仓类型**（`entry_reason`）：机器单平仓入库时，若未手填，按 `key_signal_type` 自动映射（见下表）；列表/导出「开仓类型」列 = 复盘核对值优先，否则入库值，否则按信号映射。
|
||||
|
||||
| `key_signal_type` | 自动写入的 `entry_reason` |
|
||||
|-------------------|---------------------------|
|
||||
| 箱体突破 | 关键位箱体突破 |
|
||||
| 收敛突破 | 关键位收敛突破 |
|
||||
| 斐波回调0.618 | 关键位斐波0.618 |
|
||||
| 斐波回调0.786 | 关键位斐波0.786 |
|
||||
|
||||
- 复盘表单 **开仓类型** 下拉新增上述四条固定文案（与趋势/波段类并列）。
|
||||
- 复盘 **离场触发** 新增 **「止盈」**；从交易记录「填入复盘」时，若结果为「止盈/保本止盈/移动止盈/止损/手动平仓」会自动选中对应触发项，并按 `key_signal_type` 预填开仓类型。
|
||||
- 勾选「保存时自动生成多周期 K 线图」时：以 **平仓时间** 为锚点，各周期向前约 `ORDER_CHART_LIMIT`（默认 100）根 K 线（`_fetch_ohlcv_ending_at`），不再固定拉「最近 100 根」。
|
||||
- `/api/journals`、`/api/reviews` 支持同一时间窗 query，与列表一致。
|
||||
|
||||
### 导出（交易记录 v3）
|
||||
|
||||
- 文件名：`trade_records_v3_YYYYMMDD.csv`
|
||||
- 相对 v2 增加：`key_signal_type`、`initial_stop_loss`（及开仓快照列）、`planned_rr`、`actual_rr`、`risk_amount`、交易所盈亏与时间字段等；末列「开仓类型」为有效展示文案。
|
||||
- 「关键位历史」导出同样受 UTC 时间窗限制。
|
||||
|
||||
## 实盘下单页
|
||||
|
||||
- 左列：实盘下单监控（表单、划转、规则）。
|
||||
- 右列：实时持仓（独立模块）。
|
||||
- **人工开仓门控**：计划盈亏比 < `MANUAL_MIN_PLANNED_RR`（默认 **1.4**）时前端弹窗 + 后端拒绝。
|
||||
- **移动保本**（勾选启用）：监控轮询达到触发 RR 后，止损阶梯上移时**同步交易所**——**先撤**该合约全部 TP/SL（含 Algo 条件单）**再挂**新止损 + 原止盈（`replace_active_monitor_tpsl_on_exchange`）。仅交易所成功后才写库；失败发企业微信告警。未配置实盘 API 时仍只更新本地。
|
||||
|
||||
## 统计分析页（`/stats`）
|
||||
|
||||
| 项 | 说明 |
|
||||
|----|------|
|
||||
| 切日 | **北京时间**；交易日边界 = 每日 `TRADING_DAY_RESET_HOUR:00`（`.env` 默认 **8**） |
|
||||
| 品类下拉 | 页顶 **「统计品类」** 下拉切换（默认「全部交易」）：全部交易、下单监控、关键位箱体突破、关键位收敛结构、关键位斐波0.618、关键位斐波0.786；一次只显示所选品类的日/周/月 |
|
||||
| URL | 切换后写入 `stats_segment=`（如 `all`、`manual`、`key_box`、`key_conv`、`key_fib618`、`key_fib786`），刷新 `/stats` 可保持选项 |
|
||||
| 每块指标 | 日 / 周 / 月：开单次数、平仓笔数、胜率、净盈亏、回撤、连续亏损等（与原口径一致） |
|
||||
| 开单次数 | 人工块：`monitor_type=下单监控` 且无 `key_signal_type`；关键位块：按 `order_monitors.key_signal_type` 计数 |
|
||||
| 不受 UTC 窗影响 | 统计始终基于库内全部已平仓记录，按北京交易日归类，**不**随顶栏 UTC 列表窗切换 |
|
||||
|
||||
## 持仓与计仓
|
||||
|
||||
- `MAX_ACTIVE_POSITIONS` 默认 **1**（可在 `.env` 调大）。
|
||||
- 关键位自动开仓：在已有持仓时，若 `KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT=true`，按**首笔开仓前**交易账户资金快照计仓（字段 `trading_sessions.key_sizing_capital_snapshot`）。
|
||||
|
||||
## 配置
|
||||
|
||||
详见 `.env.example` 中「关键位门控」「交易执行 / 人工风控」注释段。
|
||||
|
||||
## 自动备份（服务器）
|
||||
|
||||
- 脚本：`scripts/backup_data.sh`（`crypto.db` + `static/images`）
|
||||
- 定时：`scripts/install_backup_cron.sh` → 每天 **北京时间 0:00**，目录 **`/root/backups/<实例名>/YYYY-MM-DD/`**，保留 **30** 天
|
||||
- 详见 `部署文档.md` 第 5.3 节
|
||||
|
||||
## 数据库（启动时自动迁移）
|
||||
|
||||
`key_monitors` 斐波字段：`fib_limit_order_id`、`fib_entry_price`、`fib_stop_loss`、`fib_take_profit`、`fib_order_amount`、`fib_margin_capital`、`fib_leverage`。
|
||||
|
||||
`trade_records` / `order_monitors`：`key_signal_type`、`exchange_realized_pnl`、`exchange_opened_at`、`exchange_closed_at`、`exchange_sync_key`、`entry_reason`、`reviewed_entry_reason`、`initial_stop_loss`。
|
||||
|
||||
**历史数据**：本次**不做**旧记录的批量回填（`entry_reason` / `initial_stop_loss` / `key_signal_type` 等）；仅**新产生**的平仓与复盘按新逻辑写入。旧行展示可回退已有字段。
|
||||
|
||||
## 涉及文件（便于排查）
|
||||
|
||||
| 路径 | 说明 |
|
||||
|------|------|
|
||||
| `history_window_lib.py` | UTC 时间窗解析与转北京时间 SQL 字符串 |
|
||||
| `fib_key_monitor_lib.py` | 斐波计算、`KEY_ENTRY_REASON_BY_SIGNAL`、`entry_reason_from_key_signal` |
|
||||
| `crypto_monitor_binance/app.py` | 列表筛选、统计分块、导出 v3、复盘 K 线锚点、入库逻辑 |
|
||||
| `crypto_monitor_binance/templates/index.html` | 顶栏时间窗、统计分块 UI、止损(开仓)列、复盘预填 |
|
||||
|
||||
## 升级步骤
|
||||
|
||||
1. `git pull` 后对比 `.env.example`，把新增变量合并进本地 `.env`。
|
||||
2. 在 VPS 上为 Binance / Gate / Gate Bot **各执行一次** `bash scripts/install_backup_cron.sh`（若尚未安装）。
|
||||
3. 重启 Binance 实例（如 `pm2 restart crypto_binance`）；SQLite 会自动 `ALTER` 缺列（斐波、交易所盈亏、`entry_reason` 等）。
|
||||
4. 浏览器强刷（Ctrl+F5）避免旧版 `index.html` 缓存。
|
||||
5. 打开任意页确认顶栏出现 **「列表筛选（UTC）」**；`/stats` 可见分品类统计与「北京 8:00 切日」说明。
|
||||
6. 建议先用测试币验证斐波：限价挂出、标记价失效撤单、成交后 TP/SL 与订单监控是否正常；平仓后检查交易记录止损(开仓)与开仓类型。
|
||||
|
||||
+378
-378
@@ -1,378 +1,378 @@
|
||||
# `crypto_monitor_binance` 部署指南：SSH SOCKS + Binance + PM2（Ubuntu）
|
||||
|
||||
项目功能、环境变量总览与本地运行说明见 **[README.md](./README.md)**。
|
||||
|
||||
本文面向：**在本机或 VPS 上运行本项目**，但 **直连 Binance API 不稳定、超时或被网络策略拦截** 的场景。思路是：
|
||||
|
||||
- 本机用 `ssh -D` 做动态转发，把 **SOCKS5 出口**放到能稳定访问 Binance 的机器（常见为一台境外 VPS）
|
||||
- 项目在 `.env` 中设置 **`BINANCE_SOCKS_PROXY=socks5h://127.0.0.1:1080`**（或你实际端口），`ccxt` 经 SOCKS 访问交易所
|
||||
- **SSH 隧道**：用 `ssh -D` 在本机常驻即可（screen / tmux / systemd 等），**不必交给 PM2**
|
||||
- 使用 **PM2** 仅托管 **Flask 应用**；仓库根目录 **`ecosystem.config.cjs`** 默认进程名为 **`crypto-monitor-binance`**
|
||||
|
||||
> 安全提醒：不要把 `.env`、私钥 `.pem`、Binance API Key / Secret 提交到 Git；下文只用占位符。
|
||||
|
||||
---
|
||||
|
||||
## 0. 你需要准备的东西
|
||||
|
||||
- 一台 **Ubuntu**（或同类 Linux）运行项目的机器（下文称「本机」）
|
||||
- 一台可 SSH 登录、且 **能正常访问 Binance API** 的 VPS（示例：`HostName` 填你的服务器 IP，用户如 `root`）
|
||||
- SSH：**私钥登录**（推荐，便于隧道脚本无人值守）
|
||||
- 本机已安装：`python3`、`python3-venv`、`pip`、`curl`、`ssh`、`git`（可选）、`node` + `npm`（安装 PM2）
|
||||
- Binance 账户：已开通 **USDT-M 永续合约**；API Key 勾选 **合约**、**万向划转**（若使用资金↔合约划转）等所需权限，并配置 **IP 白名单**（若启用）
|
||||
|
||||
---
|
||||
|
||||
## 1. 获取代码与目录
|
||||
|
||||
将包含 `app.py` 的项目放到固定目录，例如：
|
||||
|
||||
```bash
|
||||
mkdir -p /opt/crypto_monitor
|
||||
cd /opt/crypto_monitor
|
||||
git clone https://git.bz121.com/dekun/crypto_monitor.git
|
||||
cd crypto_monitor/crypto_monitor_binance
|
||||
```
|
||||
|
||||
下文用 **`/opt/crypto_monitor/crypto_monitor_binance`** 仅为示例，请换成你的实际绝对路径。
|
||||
|
||||
拉取代码后，若目录下尚无 `.env`，先从模板生成（**勿**把填好密钥的 `.env` 提交 Git）：
|
||||
|
||||
```bash
|
||||
cp -n .env.example .env # -n：已存在 .env 时不覆盖
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 配置 SSH 私钥与 `~/.ssh/config`
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.ssh
|
||||
chmod 700 ~/.ssh
|
||||
# 私钥示例：~/.ssh/vps1.pem
|
||||
chmod 600 ~/.ssh/vps1.pem
|
||||
```
|
||||
|
||||
编辑 `~/.ssh/config`（示例别名 **`bn-vps`**，与你手工启动 `ssh -D ... bn-vps` 一致即可）：
|
||||
|
||||
```sshconfig
|
||||
Host bn-vps
|
||||
HostName 你的_VPS_IP
|
||||
User root
|
||||
IdentityFile ~/.ssh/vps1.pem
|
||||
IdentitiesOnly yes
|
||||
ServerAliveInterval 30
|
||||
ServerAliveCountMax 3
|
||||
ExitOnForwardFailure yes
|
||||
BatchMode yes
|
||||
```
|
||||
|
||||
测试：
|
||||
|
||||
```bash
|
||||
ssh bn-vps true
|
||||
```
|
||||
|
||||
> 若尚未完全改为密钥登录，可暂时注释 `BatchMode yes`，调试完成后再打开。
|
||||
|
||||
---
|
||||
|
||||
## 3. 手工验证：SSH SOCKS + Binance API
|
||||
|
||||
### 3.1 本地 SOCKS（示例端口 1080）
|
||||
|
||||
```bash
|
||||
ssh -N -D 127.0.0.1:1080 bn-vps
|
||||
```
|
||||
|
||||
保持运行，另开终端继续。
|
||||
|
||||
### 3.2 验证经 SOCKS 可访问 Binance（公开接口）
|
||||
|
||||
```bash
|
||||
curl -4 -sS --max-time 15 --proxy socks5h://127.0.0.1:1080 https://api.binance.com/api/v3/time
|
||||
```
|
||||
|
||||
应返回 JSON（含 `serverTime` 字段）。若此处失败，**不要先启动应用**：先修隧道或 VPS 出站。
|
||||
|
||||
---
|
||||
|
||||
## 4. Python 虚拟环境
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
|
||||
python3 -m venv .venv
|
||||
source .venv/bin/activate
|
||||
python -m pip install -U pip
|
||||
pip install flask requests ccxt werkzeug PySocks Pillow
|
||||
```
|
||||
|
||||
走 SOCKS 时 **必须** 安装 **`PySocks`**，否则易出现代理相关报错。
|
||||
|
||||
可选：
|
||||
|
||||
```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_binance
|
||||
|
||||
cp -n .env.example .env # 已存在 .env 时不覆盖
|
||||
nano .env # 填入 API、登录密码、端口、代理等
|
||||
```
|
||||
|
||||
### 5.2 备份与 `git pull`
|
||||
|
||||
- **`.env` 已被仓库根目录 `.gitignore` 忽略**：`git pull` **不会**覆盖或删除你本地的 `.env`。
|
||||
- 若远端更新了 **`.env.example`**（新增变量名），pull 后请对照模板，**手动把新行补进你的 `.env`**（不会自动合并进 `.env`）。
|
||||
- **建议在每次 `git pull` 或大批量改配置前备份**：
|
||||
|
||||
```bash
|
||||
cp .env .env.backup.$(date +%Y%m%d)
|
||||
# 恢复示例：cp .env.backup.20260516 .env
|
||||
```
|
||||
|
||||
- **换机 / 迁移**：用 `scp` 复制整份 `.env` 到新机器对应目录；或在新机重新 `cp .env.example .env` 后填写。
|
||||
|
||||
### 5.3 自动备份（数据库 + 复盘图片）
|
||||
|
||||
默认每天 **北京时间 0:00** 备份到 **`/root/backups`**，保留 **30 天** 后自动删除更早的目录。
|
||||
|
||||
备份内容（路径来自 `.env` 的 `DB_PATH`、`UPLOAD_DIR`）：
|
||||
|
||||
- `crypto.db`（优先 `sqlite3 .backup` 热备）
|
||||
- `static/images` 打包为 `static_images.tar.gz`
|
||||
|
||||
目录结构示例：
|
||||
|
||||
```text
|
||||
/root/backups/crypto_monitor_binance/2026-05-17/
|
||||
crypto.db
|
||||
static_images.tar.gz
|
||||
manifest.txt
|
||||
```
|
||||
|
||||
**一次性安装定时任务**（在对应项目目录执行，Binance / Gate 各执行一次）：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
chmod +x scripts/backup_data.sh scripts/install_backup_cron.sh
|
||||
bash scripts/install_backup_cron.sh
|
||||
```
|
||||
|
||||
Gate 实例：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_gate
|
||||
bash scripts/install_backup_cron.sh
|
||||
```
|
||||
|
||||
Gate Bot 实例（趋势回调等）：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_gate_bot
|
||||
bash scripts/install_backup_cron.sh
|
||||
```
|
||||
|
||||
**立即试跑**（不写 cron）：
|
||||
|
||||
```bash
|
||||
bash scripts/backup_data.sh
|
||||
```
|
||||
|
||||
日志默认：`/var/log/crypto-monitor-backup-<项目目录名>.log`。可选在 `.env` 中覆盖：`BACKUP_ROOT`、`BACKUP_RETENTION_DAYS`、`BACKUP_INSTANCE`。
|
||||
|
||||
**恢复示例**（先停 PM2，再覆盖文件）：
|
||||
|
||||
```bash
|
||||
pm2 stop crypto-monitor-binance
|
||||
cp /root/backups/crypto_monitor_binance/2026-05-16/crypto.db ./crypto.db
|
||||
tar -xzf /root/backups/crypto_monitor_binance/2026-05-16/static_images.tar.gz -C .
|
||||
pm2 start ecosystem.config.cjs
|
||||
```
|
||||
|
||||
建议安装：`apt install -y sqlite3`（热备更稳）。
|
||||
|
||||
### 5.4 必填项检查（Binance + 代理）
|
||||
|
||||
与交易所相关的变量使用 **`BINANCE_`** 前缀（与代码一致）。至少确认：
|
||||
|
||||
```env
|
||||
APP_HOST=127.0.0.1
|
||||
APP_PORT=5000
|
||||
|
||||
# 实盘（按需）
|
||||
LIVE_TRADING_ENABLED=false
|
||||
BINANCE_API_KEY=你的_Key
|
||||
BINANCE_API_SECRET=你的_Secret
|
||||
|
||||
# 保证金：cross=全仓 isolated=逐仓（与币安账户/习惯一致）
|
||||
BINANCE_MARGIN_MODE=cross
|
||||
|
||||
# 持仓模式：hedge=双向（需在币安开启双向持仓）；oneway=单向
|
||||
BINANCE_POSITION_MODE=hedge
|
||||
|
||||
# 条件单触发参考：CONTRACT_PRICE=最新成交价 MARK_PRICE=标记价
|
||||
BINANCE_TRIGGER_WORKING_TYPE=CONTRACT_PRICE
|
||||
|
||||
# 经本机 SSH 动态转发访问 Binance（端口与隧道一致）
|
||||
BINANCE_SOCKS_PROXY=socks5h://127.0.0.1:1080
|
||||
|
||||
# 若不用 SOCKS，可改用 HTTP 代理（一般二选一）
|
||||
# BINANCE_HTTP_PROXY=http://127.0.0.1:7890
|
||||
# BINANCE_HTTPS_PROXY=http://127.0.0.1:7890
|
||||
```
|
||||
|
||||
说明：**推荐 `socks5h://`**，由 SOCKS 端解析域名，与 `curl --proxy socks5h://...` 行为一致。
|
||||
|
||||
**止盈止损说明（应用逻辑）**：实盘开仓后，程序会在 Binance USDT-M 永续上挂 **`STOP_MARKET`（止损）** 与 **`TAKE_PROFIT_MARKET`（止盈）**；`BINANCE_POSITION_MODE=hedge` 时会自动带 **`positionSide`**，须与币安合约「双向持仓」开关一致。不显式传 **`reduceOnly`**（否则易触发 API **`-1106`**：`Parameter 'reduceOnly' sent when not required`）。
|
||||
|
||||
---
|
||||
|
||||
## 6. 自检脚本（可选）
|
||||
|
||||
在已配置 `.env` 且网络可达的前提下：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
source .venv/bin/activate
|
||||
python scripts/verify_binance_funding.py
|
||||
```
|
||||
|
||||
用于粗测资金钱包与合约钱包 USDT 读取（需有效 API 与权限）。
|
||||
|
||||
---
|
||||
|
||||
## 7. 手工启动 Flask（验证）
|
||||
|
||||
1. SOCKS 已监听 `127.0.0.1:1080`（若使用代理）
|
||||
2. 已 `source .venv/bin/activate`
|
||||
3. `.env` 已按需配置 `BINANCE_SOCKS_PROXY` 等
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
source .venv/bin/activate
|
||||
python app.py
|
||||
```
|
||||
|
||||
浏览器访问：`http://127.0.0.1:5000`（或你在 `.env` 中的端口）。
|
||||
|
||||
---
|
||||
|
||||
## 8. 安装 PM2
|
||||
|
||||
```bash
|
||||
sudo npm i -g pm2
|
||||
pm2 -v
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. PM2：使用仓库内 `ecosystem.config.cjs`（推荐）
|
||||
|
||||
在项目根目录：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
pm2 start ecosystem.config.cjs
|
||||
pm2 status
|
||||
pm2 logs --lines 200
|
||||
```
|
||||
|
||||
默认只启动 **`crypto-monitor-binance`**（`.venv/bin/python app.py`）。
|
||||
|
||||
### 本机已可直连 Binance、不需要隧道时
|
||||
|
||||
`.env` 里应 **去掉或留空** `BINANCE_SOCKS_PROXY`（除非仍要走别的代理），再 `pm2 start ecosystem.config.cjs`。
|
||||
|
||||
### 开机自启
|
||||
|
||||
```bash
|
||||
pm2 save
|
||||
pm2 startup
|
||||
# 按屏幕提示执行一条 sudo 命令
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. 等价手工命令（不使用 ecosystem 文件时）
|
||||
|
||||
### 10.1 SSH SOCKS（自行后台常驻，不推荐用 PM2）
|
||||
|
||||
示例（前台；实际可用 `screen`/`tmux`/`-f` 后台化或 systemd）：
|
||||
|
||||
```bash
|
||||
ssh -N -D 127.0.0.1:1080 bn-vps \
|
||||
-o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
|
||||
-o ExitOnForwardFailure=yes
|
||||
```
|
||||
|
||||
### 10.2 Flask
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
pm2 start /opt/crypto_monitor/crypto_monitor_binance/.venv/bin/python --name crypto-monitor-binance -- \
|
||||
/opt/crypto_monitor/crypto_monitor_binance/app.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 11. 交易所「连接不上」排查清单
|
||||
|
||||
1. **`.env` 是否为 Binance 变量**：`BINANCE_SOCKS_PROXY` / `BINANCE_HTTP_PROXY` / `BINANCE_API_KEY` / `BINANCE_API_SECRET` 等前缀需与代码一致。
|
||||
2. **隧道是否在本机端口监听**（若配置了 `BINANCE_SOCKS_PROXY`）：
|
||||
```bash
|
||||
ss -lntp | grep 1080 || true
|
||||
```
|
||||
3. **curl 复测 Binance**（与第 3.2 节相同）；curl 不通则应用也不会通。
|
||||
4. **PySocks**：`pip show PySocks`，缺失则 `pip install PySocks`。
|
||||
5. **SSH 隧道连不上**：检查私钥权限、`~/.ssh/config`、VPS 出站与端口是否与 `.env` 一致。
|
||||
6. **API 权限与 IP 白名单**：Secret 错误、权限不足、未放行当前出口 IP 时，私有接口会失败。
|
||||
7. **启动顺序**：若走代理，先保证 SOCKS 已监听，再 `pm2 start` 应用（或重启应用）。
|
||||
|
||||
---
|
||||
|
||||
## 12. 推荐启动顺序（习惯）
|
||||
|
||||
1. 若走代理：先启动并确认 SSH SOCKS 已监听，再 `curl --proxy socks5h://127.0.0.1:1080 https://api.binance.com/api/v3/time` 成功
|
||||
2. `pm2 start ecosystem.config.cjs`
|
||||
3. 再确认页面与余额等接口正常
|
||||
|
||||
---
|
||||
|
||||
## 13. 免责声明
|
||||
|
||||
交易所有合规与地区政策要求。请确保使用方式符合当地法律法规与交易所条款。本文仅描述网络与工程部署路径。
|
||||
|
||||
---
|
||||
|
||||
## 附录：数据库标签修复脚本 `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='保本止盈'`。
|
||||
# `crypto_monitor_binance` 部署指南：SSH SOCKS + Binance + PM2（Ubuntu）
|
||||
|
||||
项目功能、环境变量总览与本地运行说明见 **[README.md](./README.md)**。
|
||||
|
||||
本文面向：**在本机或 VPS 上运行本项目**，但 **直连 Binance API 不稳定、超时或被网络策略拦截** 的场景。思路是：
|
||||
|
||||
- 本机用 `ssh -D` 做动态转发，把 **SOCKS5 出口**放到能稳定访问 Binance 的机器（常见为一台境外 VPS）
|
||||
- 项目在 `.env` 中设置 **`BINANCE_SOCKS_PROXY=socks5h://127.0.0.1:1080`**（或你实际端口），`ccxt` 经 SOCKS 访问交易所
|
||||
- **SSH 隧道**：用 `ssh -D` 在本机常驻即可（screen / tmux / systemd 等），**不必交给 PM2**
|
||||
- 使用 **PM2** 仅托管 **Flask 应用**；仓库根目录 **`ecosystem.config.cjs`** 默认进程名为 **`crypto-monitor-binance`**
|
||||
|
||||
> 安全提醒：不要把 `.env`、私钥 `.pem`、Binance API Key / Secret 提交到 Git；下文只用占位符。
|
||||
|
||||
---
|
||||
|
||||
## 0. 你需要准备的东西
|
||||
|
||||
- 一台 **Ubuntu**（或同类 Linux）运行项目的机器（下文称「本机」）
|
||||
- 一台可 SSH 登录、且 **能正常访问 Binance API** 的 VPS（示例：`HostName` 填你的服务器 IP，用户如 `root`）
|
||||
- SSH：**私钥登录**（推荐，便于隧道脚本无人值守）
|
||||
- 本机已安装：`python3`、`python3-venv`、`pip`、`curl`、`ssh`、`git`（可选）、`node` + `npm`（安装 PM2）
|
||||
- Binance 账户：已开通 **USDT-M 永续合约**；API Key 勾选 **合约**、**万向划转**（若使用资金↔合约划转）等所需权限，并配置 **IP 白名单**（若启用）
|
||||
|
||||
---
|
||||
|
||||
## 1. 获取代码与目录
|
||||
|
||||
将包含 `app.py` 的项目放到固定目录，例如：
|
||||
|
||||
```bash
|
||||
mkdir -p /opt/crypto_monitor
|
||||
cd /opt/crypto_monitor
|
||||
git clone https://git.bz121.com/dekun/crypto_monitor.git
|
||||
cd crypto_monitor/crypto_monitor_binance
|
||||
```
|
||||
|
||||
下文用 **`/opt/crypto_monitor/crypto_monitor_binance`** 仅为示例，请换成你的实际绝对路径。
|
||||
|
||||
拉取代码后，若目录下尚无 `.env`，先从模板生成（**勿**把填好密钥的 `.env` 提交 Git）：
|
||||
|
||||
```bash
|
||||
cp -n .env.example .env # -n：已存在 .env 时不覆盖
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 配置 SSH 私钥与 `~/.ssh/config`
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.ssh
|
||||
chmod 700 ~/.ssh
|
||||
# 私钥示例：~/.ssh/vps1.pem
|
||||
chmod 600 ~/.ssh/vps1.pem
|
||||
```
|
||||
|
||||
编辑 `~/.ssh/config`（示例别名 **`bn-vps`**，与你手工启动 `ssh -D ... bn-vps` 一致即可）：
|
||||
|
||||
```sshconfig
|
||||
Host bn-vps
|
||||
HostName 你的_VPS_IP
|
||||
User root
|
||||
IdentityFile ~/.ssh/vps1.pem
|
||||
IdentitiesOnly yes
|
||||
ServerAliveInterval 30
|
||||
ServerAliveCountMax 3
|
||||
ExitOnForwardFailure yes
|
||||
BatchMode yes
|
||||
```
|
||||
|
||||
测试：
|
||||
|
||||
```bash
|
||||
ssh bn-vps true
|
||||
```
|
||||
|
||||
> 若尚未完全改为密钥登录，可暂时注释 `BatchMode yes`，调试完成后再打开。
|
||||
|
||||
---
|
||||
|
||||
## 3. 手工验证：SSH SOCKS + Binance API
|
||||
|
||||
### 3.1 本地 SOCKS（示例端口 1080）
|
||||
|
||||
```bash
|
||||
ssh -N -D 127.0.0.1:1080 bn-vps
|
||||
```
|
||||
|
||||
保持运行，另开终端继续。
|
||||
|
||||
### 3.2 验证经 SOCKS 可访问 Binance（公开接口）
|
||||
|
||||
```bash
|
||||
curl -4 -sS --max-time 15 --proxy socks5h://127.0.0.1:1080 https://api.binance.com/api/v3/time
|
||||
```
|
||||
|
||||
应返回 JSON（含 `serverTime` 字段）。若此处失败，**不要先启动应用**：先修隧道或 VPS 出站。
|
||||
|
||||
---
|
||||
|
||||
## 4. Python 虚拟环境
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
|
||||
python3 -m venv .venv
|
||||
source .venv/bin/activate
|
||||
python -m pip install -U pip
|
||||
pip install flask requests ccxt werkzeug PySocks Pillow
|
||||
```
|
||||
|
||||
走 SOCKS 时 **必须** 安装 **`PySocks`**，否则易出现代理相关报错。
|
||||
|
||||
可选：
|
||||
|
||||
```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_binance
|
||||
|
||||
cp -n .env.example .env # 已存在 .env 时不覆盖
|
||||
nano .env # 填入 API、登录密码、端口、代理等
|
||||
```
|
||||
|
||||
### 5.2 备份与 `git pull`
|
||||
|
||||
- **`.env` 已被仓库根目录 `.gitignore` 忽略**：`git pull` **不会**覆盖或删除你本地的 `.env`。
|
||||
- 若远端更新了 **`.env.example`**（新增变量名），pull 后请对照模板，**手动把新行补进你的 `.env`**（不会自动合并进 `.env`）。
|
||||
- **建议在每次 `git pull` 或大批量改配置前备份**：
|
||||
|
||||
```bash
|
||||
cp .env .env.backup.$(date +%Y%m%d)
|
||||
# 恢复示例：cp .env.backup.20260516 .env
|
||||
```
|
||||
|
||||
- **换机 / 迁移**：用 `scp` 复制整份 `.env` 到新机器对应目录；或在新机重新 `cp .env.example .env` 后填写。
|
||||
|
||||
### 5.3 自动备份（数据库 + 复盘图片）
|
||||
|
||||
默认每天 **北京时间 0:00** 备份到 **`/root/backups`**，保留 **30 天** 后自动删除更早的目录。
|
||||
|
||||
备份内容（路径来自 `.env` 的 `DB_PATH`、`UPLOAD_DIR`）：
|
||||
|
||||
- `crypto.db`（优先 `sqlite3 .backup` 热备）
|
||||
- `static/images` 打包为 `static_images.tar.gz`
|
||||
|
||||
目录结构示例：
|
||||
|
||||
```text
|
||||
/root/backups/crypto_monitor_binance/2026-05-17/
|
||||
crypto.db
|
||||
static_images.tar.gz
|
||||
manifest.txt
|
||||
```
|
||||
|
||||
**一次性安装定时任务**（在对应项目目录执行，Binance / Gate 各执行一次）：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
chmod +x scripts/backup_data.sh scripts/install_backup_cron.sh
|
||||
bash scripts/install_backup_cron.sh
|
||||
```
|
||||
|
||||
Gate 实例：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_gate
|
||||
bash scripts/install_backup_cron.sh
|
||||
```
|
||||
|
||||
Gate Bot 实例（趋势回调等）：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_gate_bot
|
||||
bash scripts/install_backup_cron.sh
|
||||
```
|
||||
|
||||
**立即试跑**（不写 cron）：
|
||||
|
||||
```bash
|
||||
bash scripts/backup_data.sh
|
||||
```
|
||||
|
||||
日志默认：`/var/log/crypto-monitor-backup-<项目目录名>.log`。可选在 `.env` 中覆盖：`BACKUP_ROOT`、`BACKUP_RETENTION_DAYS`、`BACKUP_INSTANCE`。
|
||||
|
||||
**恢复示例**（先停 PM2，再覆盖文件）：
|
||||
|
||||
```bash
|
||||
pm2 stop crypto-monitor-binance
|
||||
cp /root/backups/crypto_monitor_binance/2026-05-16/crypto.db ./crypto.db
|
||||
tar -xzf /root/backups/crypto_monitor_binance/2026-05-16/static_images.tar.gz -C .
|
||||
pm2 start ecosystem.config.cjs
|
||||
```
|
||||
|
||||
建议安装：`apt install -y sqlite3`（热备更稳）。
|
||||
|
||||
### 5.4 必填项检查（Binance + 代理）
|
||||
|
||||
与交易所相关的变量使用 **`BINANCE_`** 前缀（与代码一致）。至少确认：
|
||||
|
||||
```env
|
||||
APP_HOST=127.0.0.1
|
||||
APP_PORT=5000
|
||||
|
||||
# 实盘（按需）
|
||||
LIVE_TRADING_ENABLED=false
|
||||
BINANCE_API_KEY=你的_Key
|
||||
BINANCE_API_SECRET=你的_Secret
|
||||
|
||||
# 保证金：cross=全仓 isolated=逐仓（与币安账户/习惯一致）
|
||||
BINANCE_MARGIN_MODE=cross
|
||||
|
||||
# 持仓模式：hedge=双向（需在币安开启双向持仓）；oneway=单向
|
||||
BINANCE_POSITION_MODE=hedge
|
||||
|
||||
# 条件单触发参考：CONTRACT_PRICE=最新成交价 MARK_PRICE=标记价
|
||||
BINANCE_TRIGGER_WORKING_TYPE=CONTRACT_PRICE
|
||||
|
||||
# 经本机 SSH 动态转发访问 Binance（端口与隧道一致）
|
||||
BINANCE_SOCKS_PROXY=socks5h://127.0.0.1:1080
|
||||
|
||||
# 若不用 SOCKS，可改用 HTTP 代理（一般二选一）
|
||||
# BINANCE_HTTP_PROXY=http://127.0.0.1:7890
|
||||
# BINANCE_HTTPS_PROXY=http://127.0.0.1:7890
|
||||
```
|
||||
|
||||
说明：**推荐 `socks5h://`**，由 SOCKS 端解析域名，与 `curl --proxy socks5h://...` 行为一致。
|
||||
|
||||
**止盈止损说明（应用逻辑）**：实盘开仓后，程序会在 Binance USDT-M 永续上挂 **`STOP_MARKET`（止损）** 与 **`TAKE_PROFIT_MARKET`（止盈）**；`BINANCE_POSITION_MODE=hedge` 时会自动带 **`positionSide`**，须与币安合约「双向持仓」开关一致。不显式传 **`reduceOnly`**（否则易触发 API **`-1106`**：`Parameter 'reduceOnly' sent when not required`）。
|
||||
|
||||
---
|
||||
|
||||
## 6. 自检脚本（可选）
|
||||
|
||||
在已配置 `.env` 且网络可达的前提下：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
source .venv/bin/activate
|
||||
python scripts/verify_binance_funding.py
|
||||
```
|
||||
|
||||
用于粗测资金钱包与合约钱包 USDT 读取（需有效 API 与权限）。
|
||||
|
||||
---
|
||||
|
||||
## 7. 手工启动 Flask（验证）
|
||||
|
||||
1. SOCKS 已监听 `127.0.0.1:1080`（若使用代理）
|
||||
2. 已 `source .venv/bin/activate`
|
||||
3. `.env` 已按需配置 `BINANCE_SOCKS_PROXY` 等
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
source .venv/bin/activate
|
||||
python app.py
|
||||
```
|
||||
|
||||
浏览器访问：`http://127.0.0.1:5000`（或你在 `.env` 中的端口）。
|
||||
|
||||
---
|
||||
|
||||
## 8. 安装 PM2
|
||||
|
||||
```bash
|
||||
sudo npm i -g pm2
|
||||
pm2 -v
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. PM2：使用仓库内 `ecosystem.config.cjs`（推荐）
|
||||
|
||||
在项目根目录：
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
pm2 start ecosystem.config.cjs
|
||||
pm2 status
|
||||
pm2 logs --lines 200
|
||||
```
|
||||
|
||||
默认只启动 **`crypto-monitor-binance`**（`.venv/bin/python app.py`）。
|
||||
|
||||
### 本机已可直连 Binance、不需要隧道时
|
||||
|
||||
`.env` 里应 **去掉或留空** `BINANCE_SOCKS_PROXY`（除非仍要走别的代理），再 `pm2 start ecosystem.config.cjs`。
|
||||
|
||||
### 开机自启
|
||||
|
||||
```bash
|
||||
pm2 save
|
||||
pm2 startup
|
||||
# 按屏幕提示执行一条 sudo 命令
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. 等价手工命令（不使用 ecosystem 文件时）
|
||||
|
||||
### 10.1 SSH SOCKS（自行后台常驻，不推荐用 PM2）
|
||||
|
||||
示例（前台；实际可用 `screen`/`tmux`/`-f` 后台化或 systemd）：
|
||||
|
||||
```bash
|
||||
ssh -N -D 127.0.0.1:1080 bn-vps \
|
||||
-o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
|
||||
-o ExitOnForwardFailure=yes
|
||||
```
|
||||
|
||||
### 10.2 Flask
|
||||
|
||||
```bash
|
||||
cd /opt/crypto_monitor/crypto_monitor_binance
|
||||
pm2 start /opt/crypto_monitor/crypto_monitor_binance/.venv/bin/python --name crypto-monitor-binance -- \
|
||||
/opt/crypto_monitor/crypto_monitor_binance/app.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 11. 交易所「连接不上」排查清单
|
||||
|
||||
1. **`.env` 是否为 Binance 变量**：`BINANCE_SOCKS_PROXY` / `BINANCE_HTTP_PROXY` / `BINANCE_API_KEY` / `BINANCE_API_SECRET` 等前缀需与代码一致。
|
||||
2. **隧道是否在本机端口监听**（若配置了 `BINANCE_SOCKS_PROXY`）：
|
||||
```bash
|
||||
ss -lntp | grep 1080 || true
|
||||
```
|
||||
3. **curl 复测 Binance**（与第 3.2 节相同）；curl 不通则应用也不会通。
|
||||
4. **PySocks**：`pip show PySocks`，缺失则 `pip install PySocks`。
|
||||
5. **SSH 隧道连不上**：检查私钥权限、`~/.ssh/config`、VPS 出站与端口是否与 `.env` 一致。
|
||||
6. **API 权限与 IP 白名单**：Secret 错误、权限不足、未放行当前出口 IP 时，私有接口会失败。
|
||||
7. **启动顺序**：若走代理，先保证 SOCKS 已监听，再 `pm2 start` 应用（或重启应用）。
|
||||
|
||||
---
|
||||
|
||||
## 12. 推荐启动顺序（习惯）
|
||||
|
||||
1. 若走代理：先启动并确认 SSH SOCKS 已监听，再 `curl --proxy socks5h://127.0.0.1:1080 https://api.binance.com/api/v3/time` 成功
|
||||
2. `pm2 start ecosystem.config.cjs`
|
||||
3. 再确认页面与余额等接口正常
|
||||
|
||||
---
|
||||
|
||||
## 13. 免责声明
|
||||
|
||||
交易所有合规与地区政策要求。请确保使用方式符合当地法律法规与交易所条款。本文仅描述网络与工程部署路径。
|
||||
|
||||
---
|
||||
|
||||
## 附录：数据库标签修复脚本 `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='保本止盈'`。
|
||||
|
||||
Reference in New Issue
Block a user