# 比特骆驼自动化对冲系统（eth_hedge_sim）

**产品名：比特骆驼自动化对冲系统**  
工程仓库 / 目录名：`eth_hedge_sim`（与产品名分离，部署路径不变）。

独立自动对冲系统：OKX / 币安行情 + 本地 SIM 撮合，可选 LIVE 实盘。  
与现网 `crypto_monitor` **无代码、进程、密钥共用**。

仓库：<https://git.bz121.com/dekun/eth_hedge_sim.git>

## 运行环境

| 项 | 约定 |
|----|------|
| 操作系统 | **Ubuntu 22.04** LTS |
| 进程管理 | PM2（`eth-hedge-api`） |
| 安装目录 | `/opt/eth_hedge_sim` |
| 端口 | **5155** |
| 云服务器（推荐） | **2 vCPU / 2 GB / 40 GB SSD**；地域优先香港、新加坡等低延迟区 |

云服务器最低/推荐/余量规格、地域与带宽选择见 **[开发方案 §6.0 云服务器配置选择说明](docs/开发方案.md#60-云服务器配置选择说明)**。

## 文档

- [开发方案](docs/开发方案.md)
- [代码结构](docs/代码结构.md)
- [商业化与授权方案](docs/商业化与授权方案.md)
- [策略说明](docs/策略说明.md)
- [实盘策略说明](docs/实盘策略说明.md)
- [中控 Fleet 说明](docs/中控Fleet说明.md)（本地中控：多机监控 / 启停 / 更新 / 免密登录）
- [更新说明](docs/更新说明.md)（每次发版追加）

## 访问（测试机）

- 反代：[`https://dc.hyf2.cc`](https://dc.hyf2.cc) → 本机 `5155`（PM2: `eth-hedge-api`）
- 登录账号：见服务器 `/opt/eth_hedge_sim/.env` 的 `AUTH_USERNAME` / `AUTH_PASSWORD`
- 可在「系统设置」修改用户名/密码；前端固定同源 API，无 API 地址配置项
- **本地中控**：`http://<局域网IP>:5160`（PM2: `eth-hedge-control`）；说明见 [中控 Fleet 说明](docs/中控Fleet说明.md)

## 一键部署 / 更新（禁止 scp 传代码）

目标机：**Ubuntu 22.04**，目录 `/opt/eth_hedge_sim`。  
更新方式：**只允许 `git pull`**，然后构建并 `pm2 startOrReload` 本项目进程。

### 推荐：curl 一键管理器（菜单）

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

菜单：

1. 一键部署策略机  
2. 一键部署中控机  
3. 一键卸载  
4. 更新策略机  
5. 更新中控机  
0. 退出  

已安装后也可：

```bash
bash /opt/eth_hedge_sim/deploy/manage.sh
```

### 从开发机触发远程更新（可选）

在能 SSH 到 Ubuntu 服务器的机器上：

```bash
pip install paramiko
export DEPLOY_PASS='***'
python scripts/deploy_remote.py          # 策略机
# python scripts/deploy_control.py       # 中控（需 CONTROL_HOST / CONTROL_PASS）
```

PM2 进程名：`eth-hedge-api`（端口 **5155**）、`eth-hedge-control`（端口 **5160**）。禁止 `pm2 restart all`。

## 服务器上本地开发 / 调试（Ubuntu 22.04）

```bash
cd /opt/eth_hedge_sim
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

python scripts/smoke_market.py
cd backend
uvicorn app.main:app --host 0.0.0.0 --port 5155 --reload

# 另开终端
cd /opt/eth_hedge_sim/frontend
npm ci
npm run dev
```

## 硬规则摘要

- 模拟阶段零交易类 API
- 永续市价；期权只吃买卖一；滑点 = 1×手续费
- 仓位：永续 1 ETH，期权 2 ETH 名义
- 部署更新只用 git pull，不用 scp
- 部署环境固定为 Ubuntu 22.04