Files

T

dekun ea58a4778e 新增新机纯实盘部署文档，并与部署/使用说明互相链接。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-09-15 12:28:16 +08:00

5.5 KiB

Raw Permalink Blame History

新机纯实盘部署指南（crypto_okx）

适用场景：新开一台服务器，直接接 OKX 实盘 API，不做同机模拟→实盘切换。

当前推荐用法：

机器	用途
现有模拟机	不接 API Key，本地模拟撮合 + 公开行情
本机（新机）	只跑实盘，从部署起就是 `live`

与主仓 crypto_monitor 隔离：请用独立子账户 / 独立 API Key，避免双实例同 Key 抢仓。

通用安装步骤见部署文档.md；页面操作见使用说明.md。

1. 上线前准备

OKX 实盘账户（非演示盘），建议专用子账户、小资金。
API Key 权限：交易（期权 + 如需币本位则含现货）；按需开提现（一般不必）。
IP 白名单绑定到新机公网 IP。
确认持仓模式 / 保证金模式与下文 .env 一致（如双向 + 全仓）。
确认本机或经 SOCKS 能访问 https://www.okx.com。

2. 一键部署

新机 root：

curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash

菜单选 1. 一键部署。默认路径 /opt/crypto_okx，端口 5004。

或手动：

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` 必改项

编辑：

nano /opt/crypto_okx/.env

3.1 模式：直接 live（不要 sim）

# 启动即实盘（不要写成 sim）
SIM_DEFAULT_MODE=live

# 允许真实下单
LIVE_TRADING_ENABLED=true

说明：

新机不要依赖页面「切换到实盘」；部署时就把 SIM_DEFAULT_MODE=live 写好。
期权路径主要认 API Key；LIVE_TRADING_ENABLED 仍建议保持 true，与文档口径一致。

3.2 实盘 API（必填）

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 交易模式与预算（按策略改）

单独期权（常见起步）：

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，并打开：

HEDGE_PLAN_LIVE_ORDER=true

起步建议先 HEDGE_PLAN_LIVE_ORDER=false 或页面 dry_run，跑通单独期权后再开对冲真下单。

3.4 代理（按网络需要）

若服务器直连 OKX 不稳定：

OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080

并先在本机建好 SSH SOCKS（见部署文档）。

4. 启动与确认

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

核对：

能登录。
顶栏为实盘（okx_live），没有「模拟」徽章。
资金条能读到交易所余额（不是本地模拟钱包初始值）。
系统设置 → 模拟资金：当前模式应为 live（勿再切回 sim）。

可用接口自检：

curl -s -u '用户名:密码' http://127.0.0.1:5004/api/sim/status
# 期望含 "mode":"live"

5. 小额冒烟（必做）

在真钱前用 最小张数 / 最小预算：

/options 开 1 张（或最小允许张数）→ 看交易所成交与本地记录。
持仓出现在页面监控。
平仓 → 余额变化符合预期。
若币本位：确认买币桥 → 开期权 → 平 → 卖回（或按你策略保留币）。
/options/review：复盘列表有记录；可选勾选自动 K 线（公开行情，有 Key 也可画）。

任一步异常：先停手，查 pm2 logs crypto_okx，不要加大仓位。

6. 与模拟机、主仓的隔离

不要做	原因
模拟机与实盘机共用同一 API Key	双实例监控/下单互相干扰
与正在跑的 `crypto_monitor` 共用同一 Key	同上
在实盘机再切回 sim「玩玩」	易混仓、混认知；模拟请继续用旧模拟机
把 `.env` 提交进 Git	泄密

7. 日常更新（实盘机）

cd /opt/crypto_okx
git pull
pm2 restart crypto_okx --update-env
git log -1 --oneline

或：

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，资金为交易所余额
小额开平冒烟通过
企业微信 / 监控按需开启

免责声明

实盘有亏损风险。请遵守当地法规与交易所条款；操作与资金安全自负。

5.5 KiB Raw Permalink Blame History Unescape Escape