dekun
216 lines
5.5 KiB
Markdown
216 lines
5.5 KiB
Markdown
# 新机纯实盘部署指南（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，资金为交易所余额
|
||
- [ ] 小额开平冒烟通过
|
||
- [ ] 企业微信 / 监控按需开启
|
||
|
||
---
|
||
|
||
## 免责声明
|
||
|
||
实盘有亏损风险。请遵守当地法规与交易所条款；操作与资金安全自负。
|