# 新机纯实盘部署指南（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，资金为交易所余额
- [ ] 小额开平冒烟通过
- [ ] 企业微信 / 监控按需开启

---

## 免责声明

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