eth_hedge_sim

独立自动对冲模拟盘：OKX 实盘只读行情 + 本地虚拟资金撮合。
与现网 crypto_monitor 无代码、进程、密钥共用。

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

文档

• 开发方案
• 代码结构

访问（测试机）

• 反代：https://dc.hyf2.cc → 本机 5155（PM2: eth-hedge-api）
• 默认登录：见服务器 /opt/eth_hedge_sim/.env 的 AUTH_USERNAME / AUTH_PASSWORD（示例 admin / admin123）
• 可在「系统设置」修改用户名/密码；前端固定同源 API，无 API 地址配置项

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

服务器目录：/opt/eth_hedge_sim
更新方式：只允许 git pull，然后构建并 pm2 startOrReload 本项目进程。

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

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

菜单：

1. 一键部署
2. 一键卸载（仅停删 eth-hedge-api，移走目录并备份 .env）
3. 更新（git pull + 构建 + reload）
4. 退出

已安装后也可：

bash /opt/eth_hedge_sim/deploy/manage.sh

本机触发远程更新

pip install paramiko
set DEPLOY_PASS=***   # Windows PowerShell: $env:DEPLOY_PASS='***'
python scripts/deploy_remote.py

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

本地开发

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

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

# 另开终端
cd frontend
npm ci
npm run dev

硬规则摘要

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