MoFin/docs/QUICKSTART.md

MoFin — 快速操作手册

生产环境: Linux 192.168.1.246 | 端口: API 8899 / Dashboard 8899

---

日常检查

# 打开 Dashboard 看全局
http://192.168.1.246:8899

# 命令行快速状态
ssh hmo@192.168.1.246 "curl -s http://127.0.0.1:8899/api/services | python3 -m json.tool | head -20"

---

Dashboard

# 查看状态
ssh hmo@192.168.1.246 "sudo systemctl status mofin-dashboard"

# 重启
ssh hmo@192.168.1.246 "sudo systemctl restart mofin-dashboard"

# 查看日志（API+Dashboard 一体，日志走 journald）
ssh hmo@192.168.1.246 "sudo journalctl -u mofin-dashboard -n 50"

---

MoFin API

⚠️ API 与 Dashboard 已合并为 mofin-dashboard.service（:8899），无独立 mofin-api 服务。

# 查看状态（用 mofin-dashboard）
ssh hmo@192.168.1.246 "sudo systemctl status mofin-dashboard"

# 重启（用 mofin-dashboard）
ssh hmo@192.168.1.246 "sudo systemctl restart mofin-dashboard"

# 测试 API
curl http://192.168.1.246:8899/api/portfolio

---

健康检查

# 查看定时任务
ssh hmo@192.168.1.246 "crontab -l | grep health"

# 手动运行（无输出 = 全正常）
ssh hmo@192.168.1.246 "cd ~/MoFin && python3 agents_health_check.py"

# 查看最近报告
ssh hmo@192.168.1.246 "cat ~/MoFin/gateway/temp/last_health_check.json | python3 -m json.tool"

---

部署更新

正确工作流：本地开发 → push Gitea → 246 pull 部署（不直接在 246 上改代码，避免 deploy_guard 拦截）

# 1. 本地开发环境提交并推送（D:\...\projects\MoFin）
git add . && git commit -m '说明'
git push origin master

# 2. 246 部署：拉取最新代码
ssh hmo@192.168.1.246 "cd ~/MoFin && git pull --rebase"

# 3. 重启受影响的服务
ssh hmo@192.168.1.246 "sudo systemctl restart mofin-dashboard"

# 4. 验证
ssh hmo@192.168.1.246 "curl -s http://127.0.0.1:8899/api/health"

---

常见问题

现象	操作
Dashboard 不响应	ssh hmo@246 sudo systemctl restart mofin-dashboard
F Tab 定时任务显示"未部署"	ssh hmo@246 crontab -l | grep health 确认
MoFin API 不响应	ssh hmo@246 sudo systemctl restart mofin-dashboard（API+Dashboard 一体）
数据库查询失败	ssh hmo@246 'ls -la /home/hmo/MoFin/data/mofin.db'