diff --git a/使用说明.md b/使用说明.md index 474e3f3..922db56 100644 --- a/使用说明.md +++ b/使用说明.md @@ -4,7 +4,7 @@ 基于 Flask 的 **OKX 期权 / 对冲** Web 控制台.与中控、其它交易所实例无关. -**部署 / PM2 / SOCKS** 见 **[部署文档.md](./部署文档.md)**: +**部署 / PM2 / SOCKS** 见 **[部署文档.md](./部署文档.md)**;**新机纯实盘**见 **[新机纯实盘部署.md](./新机纯实盘部署.md)**: ```bash curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash diff --git a/新机纯实盘部署.md b/新机纯实盘部署.md new file mode 100644 index 0000000..713f872 --- /dev/null +++ b/新机纯实盘部署.md @@ -0,0 +1,215 @@ +# 新机纯实盘部署指南(crypto_okx) + +适用场景:**新开一台服务器,直接接 OKX 实盘 API,不做同机模拟→实盘切换**。 + +当前推荐用法: + +| 机器 | 用途 | +|------|------| +| 现有模拟机 | 不接 API Key,本地模拟撮合 + 公开行情 | +| **本机(新机)** | 只跑实盘,从部署起就是 `live` | + +与主仓 `crypto_monitor` **隔离**:请用独立子账户 / 独立 API Key,避免双实例同 Key 抢仓。 + +通用安装步骤见 [部署文档.md](./部署文档.md);页面操作见 [使用说明.md](./使用说明.md)。 + +--- + +## 1. 上线前准备 + +1. OKX **实盘**账户(非演示盘),建议专用子账户、小资金。 +2. API Key 权限:交易(期权 + 如需币本位则含现货);按需开提现(一般不必)。 +3. IP 白名单绑定到新机公网 IP。 +4. 确认持仓模式 / 保证金模式与下文 `.env` 一致(如双向 + 全仓)。 +5. 确认本机或经 SOCKS 能访问 `https://www.okx.com`。 + +--- + +## 2. 一键部署 + +新机 root: + +```bash +curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash +``` + +菜单选 **1. 一键部署**。默认路径 `/opt/crypto_okx`,端口 `5004`。 + +或手动: + +```bash +cd /opt +git clone https://git.bz121.com/dekun/crypto_okx.git crypto_okx +cd /opt/crypto_okx +cp -n .env.example .env +bash deploy/setup_env.sh --install-system-deps +``` + +--- + +## 3. 纯实盘 `.env` 必改项 + +编辑: + +```bash +nano /opt/crypto_okx/.env +``` + +### 3.1 模式:直接 live(不要 sim) + +```env +# 启动即实盘(不要写成 sim) +SIM_DEFAULT_MODE=live + +# 允许真实下单 +LIVE_TRADING_ENABLED=true +``` + +说明: + +- 新机不要依赖页面「切换到实盘」;部署时就把 `SIM_DEFAULT_MODE=live` 写好。 +- 期权路径主要认 API Key;`LIVE_TRADING_ENABLED` 仍建议保持 `true`,与文档口径一致。 + +### 3.2 实盘 API(必填) + +```env +OKX_API_KEY=你的实盘Key +OKX_API_SECRET=你的实盘Secret +OKX_API_PASSPHRASE=你的Passphrase +OKX_OPTIONS_ENABLED=true +EXCHANGE_DISPLAY_NAME=OKX·实盘 +``` + +不要用演示盘 Key;本仓库未接 `x-simulated-trading`。 + +### 3.3 交易模式与预算(按策略改) + +单独期权(常见起步): + +```env +OKX_TRADE_MODE=options +OKX_OPTIONS_MARGIN_MODE=coin +OKX_OPTIONS_COIN_BUDGET_USDT=10 +OKX_OPTIONS_TRADE_BUDGET_USDC=10 +``` + +若做对冲,再改为 `perp_options` / `options_options`,并打开: + +```env +HEDGE_PLAN_LIVE_ORDER=true +``` + +起步建议先 `HEDGE_PLAN_LIVE_ORDER=false` 或页面 dry_run,跑通单独期权后再开对冲真下单。 + +### 3.4 代理(按网络需要) + +若服务器直连 OKX 不稳定: + +```env +OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080 +``` + +并先在本机建好 SSH SOCKS(见部署文档)。 + +--- + +## 4. 启动与确认 + +```bash +cd /opt/crypto_okx +pm2 restart crypto_okx --update-env +# 若尚未创建进程,用一键脚本或: +# pm2 start ecosystem.config.cjs +pm2 status +pm2 logs crypto_okx --lines 50 +``` + +打开:`http://<新机IP>:5004` + +核对: + +1. 能登录。 +2. 顶栏为 **实盘**(`okx_live`),**没有**「模拟」徽章。 +3. 资金条能读到交易所余额(不是本地模拟钱包初始值)。 +4. 系统设置 → 模拟资金:当前模式应为 **live**(勿再切回 sim)。 + +可用接口自检: + +```bash +curl -s -u '用户名:密码' http://127.0.0.1:5004/api/sim/status +# 期望含 "mode":"live" +``` + +--- + +## 5. 小额冒烟(必做) + +在真钱前用 **最小张数 / 最小预算**: + +1. `/options` 开 1 张(或最小允许张数)→ 看交易所成交与本地记录。 +2. 持仓出现在页面监控。 +3. 平仓 → 余额变化符合预期。 +4. 若币本位:确认买币桥 → 开期权 → 平 → 卖回(或按你策略保留币)。 +5. `/options/review`:复盘列表有记录;可选勾选自动 K 线(公开行情,有 Key 也可画)。 + +任一步异常:**先停手**,查 `pm2 logs crypto_okx`,不要加大仓位。 + +--- + +## 6. 与模拟机、主仓的隔离 + +| 不要做 | 原因 | +|--------|------| +| 模拟机与实盘机共用同一 API Key | 双实例监控/下单互相干扰 | +| 与正在跑的 `crypto_monitor` 共用同一 Key | 同上 | +| 在实盘机再切回 sim「玩玩」 | 易混仓、混认知;模拟请继续用旧模拟机 | +| 把 `.env` 提交进 Git | 泄密 | + +--- + +## 7. 日常更新(实盘机) + +```bash +cd /opt/crypto_okx +git pull +pm2 restart crypto_okx --update-env +git log -1 --oneline +``` + +或: + +```bash +bash /opt/crypto_okx/deploy/pull_and_restart.sh +``` + +`git pull` **不会**覆盖 `.env`。大版本更新前可:`cp .env .env.backup.$(date +%Y%m%d)`。 + +--- + +## 8. 故障快速对照 + +| 现象 | 排查 | +|------|------| +| 顶栏仍显示模拟 | `.env` 是否 `SIM_DEFAULT_MODE=live`;是否重启 `--update-env`;设置页是否被改回 sim | +| 读不到余额 / 下单失败 | Key、权限、IP 白名单、SOCKS、OKX 账户是否实盘 | +| 能开单但监控不对 | 是否与其它实例同 Key;持仓模式是否与 `OKX_POS_MODE` 一致 | +| 复盘无自动 K 线 | 服务器能否访问 OKX 公开行情;看日志是否画图失败 | + +--- + +## 9. 推荐启动清单(可打印) + +- [ ] 新机已部署 `/opt/crypto_okx` +- [ ] `SIM_DEFAULT_MODE=live` +- [ ] `LIVE_TRADING_ENABLED=true` +- [ ] 实盘 `OKX_API_*` 已填,且非演示盘 +- [ ] Key 与主仓 / 模拟机隔离 +- [ ] 顶栏确认 live,资金为交易所余额 +- [ ] 小额开平冒烟通过 +- [ ] 企业微信 / 监控按需开启 + +--- + +## 免责声明 + +实盘有亏损风险。请遵守当地法规与交易所条款;操作与资金安全自负。 diff --git a/部署文档.md b/部署文档.md index a1e9c28..57954aa 100644 --- a/部署文档.md +++ b/部署文档.md @@ -4,6 +4,8 @@ **功能与页面操作**见同目录 **[使用说明.md](./使用说明.md)**.脚本细节见 **[deploy/README.md](./deploy/README.md)**. +**新开服务器、直接接 API 跑实盘(不与模拟同机切换)**见 **[新机纯实盘部署.md](./新机纯实盘部署.md)**. + --- ## 一键部署(推荐)