dekun/gate_scout_order

Fork 0

Files

T

dekun ac762b540c 增加关键位人工输入

2026-05-22 22:15:46 +08:00

7.9 KiB

Raw Blame History

交易系统部署说明（Gate USDT 永续 · PM2）

1. 系统概要

本系统是基于 Python 的云端监控服务，仅使用 Gate.io 交易所公共 API（REST v4）。

监控市场：Gate USDT 本位线性永续（合约名如 BTC_USDT）
方向：策略支持多空信号；企业微信推送文案随信号方向变化
周期：监控主循环固定 5m
信号分级：WATCH / TRIGGER
数据：/futures/usdt/contracts、/tickers、/candlesticks

2. 当前策略（摘要）

2.1 全市场 5m 扫描（雷达）

WATCH：横盘结构成立
TRIGGER：横盘 + 5m 收盘突破边界 + 放量
可调参数：横盘时长、振幅、放量倍数、回看根数、缓冲（见 Web 面板 / SQLite kv_store）
企微为参考计划；默认不转发执行器（见 key_monitor.auto_scan_forward_executor）

2.2 关键位突破监控（半自动 · 推荐）

面板 GEMMA 漏斗 下方 「关键位突破监控」：录入币种、方向、上沿/下沿。
箱体突破 / 收敛突破，各支持 标准突破（止损突破 K 外 0.3%，止盈 1×H）或 趋势突破（止损外 1%，止盈手填）。
5m 硬门控通过后：企微 + 可选 POST /v1/signal（单一 SL/TP）；历史可导出 CSV。
详见 docs/关键位突破监控说明.md、更新说明.md。

3. config.yaml 示例

app:
  host: 0.0.0.0
  port: 8088
  poll_interval_seconds: 300
  log_file: ./runtime/system.log
  database_url: sqlite+aiosqlite:///./runtime/alerts.db
  session_secret: please-replace-with-strong-random-value

auth:
  username: admin
  password: ChangeThisPassword!

wecom:
  webhook: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=replace
  mentioned_mobile_list: []

gate:
  api_base: https://api.gateio.ws/api/v4
  settle: usdt
  quote_currency: USDT

monitor:
  universe: all_swaps
  min_24h_quote_volume_usdt: 10000000

watch_symbols: []

key_monitor:
  enabled: true
  poll_interval_seconds: 5
  push_wecom: true
  forward_executor: true
  standard_stop_outside_pct: 0.3
  trend_stop_outside_pct: 1.0
  min_planned_rr: 1.5
  auto_scan_forward_executor: false

# 可选：与并列项目 gate_order_executor 联动（关键位门控通过后 POST /v1/signal）
order_executor:
  enabled: false
  base_url: "http://127.0.0.1:8090"
  webhook_secret: "same-as-executor-security-webhook_secret"
  timeout_seconds: 15

3.1 企微与自动下单

关键位：门控与计划 RR 通过后发企微，并在 key_monitor.forward_executor: true 时向执行器发单一 SL/TP（与录入方案一致）。
执行器：面板 「下单执行器 · 转发链」 总开关开启，webhook_secret 与各执行器一致。
全市场 TRIGGER 默认仅企微参考，不转发（auto_scan_forward_executor: false）。

3.2 执行器联调（curl，无面板按钮）

并列项目 gate_order_executor 的 Web 面板 不再提供「拉取余额 / 测试市价」入口；需在服务器用 curl 或脚本调用 POST /api/test、POST /v1/test 做联调（micro_market 须 gate.test_orders_enabled: true）。完整命令与鉴权说明见 gate_order_executor/docs/使用说明.md §4.1 与 gate_order_executor/docs/部署说明.md §11。

4. 云端部署（Python venv + PM2，推荐）

以下以 Ubuntu/Debian、项目路径 /root/onchain_scout_gate 为例：

4.1 系统依赖

apt update && apt install -y python3 python3-pip python3-venv curl

安装 Node.js（用于 PM2），参见 NodeSource 或发行版自带 nodejs / npm。

npm install -g pm2

4.2 上传项目

将项目放到 /root/onchain_scout_gate（包含 app/、requirements.txt、deploy/ecosystem.config.cjs）。

4.3 虚拟环境与 Python 依赖

cd /root/onchain_scout_gate && \
python3 -m venv .venv && \
source .venv/bin/activate && \
python -m pip install -U pip && \
pip install -r requirements.txt

4.4 配置文件

nano /root/onchain_scout_gate/config.yaml

至少修改：auth、session_secret、wecom.webhook、monitor。旧版 okx: 配置需改为 gate:（见上方示例）。

4.5 PM2 启动与自检

在项目根目录执行：

cd /root/onchain_scout_gate
pm2 start deploy/ecosystem.config.cjs
pm2 logs onchain-scout

验证：浏览器访问 http://服务器IP:8088（端口以 config.yaml 为准）。

常用运维：

pm2 restart onchain-scout
pm2 save
pm2 startup   # 按提示配置开机自启

日志：runtime/system.log（应用轮转日志）、runtime/pm2-out.log / runtime/pm2-error.log（PM2）。

5. 前台调试（非守护）

便于排查问题时临时使用：

cd /root/onchain_scout_gate && source .venv/bin/activate && \
python -m app.main

或：uvicorn app.main:app --host 0.0.0.0 --port 8088 --workers 1

6. systemd（可选）

若希望用 systemd 托管 pm2-runtime（保持进程在前台供 systemd 监控），可复制并修改 deploy/onchain-scout.service 中的路径与 ExecStart。生产环境更常见做法是仅用 PM2 自带的 pm2 startup。

7. 多执行器转发（Web 面板维护）

同一套突破信号可向多个 gate_order_executor 广播（对照实验：各执行器自行配置盈亏比、仓位等）。

部署	操作
单账户	面板「下单执行器」中保留 1 条 Base URL（如 `http://127.0.0.1:8090`）
多账户	添加多条 URL（如 `:8090`、`:8091`），各进程绑定不同 Gate API
暂停某一账户	将该条设为「停用」，或关闭总开关
Webhook	面板保存的密钥须与各执行器 `security.webhook_secret` 一致（改后需同步执行器 config）

列表保存在 runtime/order_executors.json，仅扫描端维护，执行器不会反向注册。
转发请求不走 proxy，直连 base_url（同机可用 127.0.0.1）。
详细设计见 docs/多执行器与信号转发归档.md。

8. 云服务器：关闭代理

本机开发若使用 Clash 等 SOCKS（proxy.enabled: true），迁到 可直连 Gate 的境外云主机 后应关闭代理。

8.1 扫描端 `config.yaml`

proxy:
  enabled: false
  url: "socks5h://127.0.0.1:1080"   # enabled=false 时可保留

修改后：pm2 restart onchain-scout（或你的 PM2 应用名）。

说明：

proxy 仅影响 Gate 行情 请求；企业微信、转发执行器均为直连。
自检：curl -I --max-time 15 https://api.gateio.ws 成功后再关代理。

8.2 执行器 `gate_order_executor/config.yaml`（每个实例）

proxy:
  enabled: false

每个执行器进程改完后分别 pm2 restart gate-order-executor（多实例用不同应用名/端口）。

8.3 同机典型拓扑

onchain_scout_gate :8088   proxy.enabled: false
gate_order_executor :8090  账户 A
gate_order_executor :8091  账户 B（第二份目录或第二 PM2 应用）

面板两条 Base URL 指向上述地址即可。

9. 常见问题

现象	处理
`配置文件校验失败` / 缺少 `gate`	将 `config.yaml` 中 `okx:` 改为本文 §3 的 `gate:` 段
ModuleNotFoundError	进入 `.venv` 后执行 `pip install -r requirements.txt`
拉不到行情	检查网络、`proxy`、防火墙；可选 `curl -I https://api.gateio.ws`
限流 / 周期过长	增大 `poll_interval_seconds` 或提高 `min_24h_quote_volume_usdt`
有 TRIGGER 但未下单	看面板执行器总开关、列表是否为空、webhook 是否一致；查运行日志 `order_executor_*`

10. 运维建议

公网建议 Nginx 反代 + HTTPS，8088 仅内网暴露。
定期备份：runtime/alerts.db、runtime/order_executors.json。
修改 config.yaml 后执行 pm2 restart onchain-scout（执行器列表以面板为准，已有 order_executors.json 不会被 yaml 覆盖）。

7.9 KiB Raw Blame History Unescape Escape