MoFin/docs/DEPLOY.md

MoFin — 部署指南

版本: v1.0 | 部署目标: Linux 192.168.1.246

---

部署概览

组件	守护方式	端口	说明
server.py	systemd mofin-api	8899	持仓情报 API（已有，不动）
dashboard.py	systemd mofin-dashboard	5804	管理门户（新增）
health_check	crontab */5 * * * *	—	Tier1 健康检查（新增）

---

1. Dashboard 部署

1.1 创建 systemd 服务

sudo tee /etc/systemd/system/mofin-dashboard.service << 'EOF'
[Unit]
Description=MoFin Dashboard
After=network.target

[Service]
Type=simple
User=hmo
WorkingDirectory=/home/hmo/MoFin
Environment=MOFIN_ROOT=/home/hmo/MoFin
ExecStart=/usr/bin/python3 /home/hmo/MoFin/dashboard.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

1.2 启动

sudo systemctl daemon-reload
sudo systemctl enable --now mofin-dashboard
sudo systemctl status mofin-dashboard

1.3 验证

curl http://127.0.0.1:5804/api/health
curl http://127.0.0.1:5804/api/services | python3 -m json.tool
# 浏览器访问: http://192.168.1.246:5804

---

2. 健康管线部署

# 添加到 crontab
(crontab -l 2>/dev/null; echo '# MoFin health pipeline'; echo '*/5 * * * * cd /home/hmo/MoFin && /usr/bin/python3 agents_health_check.py >> gateway/logs/health_check_cron.log 2>&1') | crontab -

# 验证
crontab -l | grep health

---

3. 防火墙

sudo ufw status | grep -E '8899|5804'
# 如果未开放:
# sudo ufw allow 5804/tcp

---

4. 部署后验证清单

• curl http://127.0.0.1:5804/api/health → {"status":"ok"}
• curl http://127.0.0.1:5804/api/services → 返回 5 个服务状态
• 浏览器打开 http://192.168.1.246:5804 → Services Tab 显示服务状态
• Dashboard F 健康 Tab → 定时任务状态显示正常
• 点击各模块 ?§ 按钮 → 弹出 spec 帮助内容
• python3 agents_health_check.py → 无输出（全正常）

---

5. 故障恢复

问题	命令
Dashboard 挂了	ssh hmo@246 'sudo systemctl restart mofin-dashboard'
健康检查不运行	ssh hmo@246 'crontab -l | grep health'
MoFin API 挂了	ssh hmo@246 'sudo systemctl restart mofin-api'
知微 Gateway 挂了	ssh hmo@246 'sudo systemctl restart hermes-gateway@zhiwei'