Files

T

claude_dev f6ca85e937 docs(audit): 文档审计吸收批——P0×2+P1×4 修复 [nas]

- P0-2 触及面矩阵修正(three-env §12): sanguo_api+frontend→🔴——VPS 常驻
  sanguo-api 生产控制台(runbook §7.1/§7.6 09-25 勘误「本就常驻跑纯 API」,
  vps-deploy.yml 每次部署重启 sanguo-api 实证)+公网前端 dist; sanguo_web=legacy
  平行后端非「前端」; orchestrator→🟡 随 api 常驻加载(app.py:15 import 实证)。
  同病 .claude/CLAUDE.md 判定行+reload 节一并修正(两处)
- P0-1 README 入口: 生产命令勘误(勿起 sanguo_web legacy 后端,架构审计 P0-3
  定性危险)+admin123 凭据指引删除+api/user_guide 断链节改指文档中心
- P1 reload 旧任务名 sanguo-bs-eod→sanguo-bs-daily(three-env §4+session-guide
  §6, 2026-08-20 重组遗留)
- P1 session-guide: smoke_e2e.py 死引用(da32cca 审计卫生批已删)→CI nas-verify
  手动等效探针(免凭据版);dispatch 样例补 confirm 必填字段
- P1 nas-deploy-plan §四: docker run 补 --init+数据挂载/删 8080(现役容器
  docker inspect 实证 Init=true 仅 8000 双挂载);§五外网链路标废(首尔入口 502)
- env-version-matrix VPS 角色+ops-README BRIDGE_URL: miniQMT/FastAPI-bridge
  退役标注(09-08)
- three-env §1 NAS 路径 stock→homes/admin(promote.sh:19 实证)+§3.1 模块
  计数 13→15

审计源: audit/20261001_docs_audit/(P0-1/P0-2/P1-1~4) +
audit/20261001_architecture_code_audit/(P0-1)

Co-Authored-By: Claude Code <notify@anthropic.com>

2026-10-01 09:08:18 +08:00

3.3 KiB

Raw Blame History

部署文档

本目录包含 Sanguo VeighNa 平台的部署相关文档。

文档列表

Docker 部署

docker-deployment.md - Docker 容器部署指南
- 前置要求和安装
- 快速开始步骤
- 配置说明
- 生产部署建议

Synology NAS 部署

synology-nas.md - Synology NAS 专用部署指南
- NAS 环境配置
- 数据持久化设置
- 自动备份配置
- 故障排除

快速链接

部署方式对比

方式	适用场景	难度	推荐度
Docker Compose	开发/测试/小规模部署	简单	⭐⭐⭐⭐⭐
Synology NAS	家庭 NAS 部署	中等	⭐⭐⭐⭐
Kubernetes	大规模/高可用部署	复杂	⭐⭐⭐

部署检查清单

硬件要求满足（内存、存储）
Docker/Docker Compose 已安装
网络端口已开放
数据目录已创建
环境变量已配置
SSL 证书已准备（生产环境）
备份策略已制定

配置文件

环境变量示例

# 数据目录
DATA_DIR=/volume1/docker/stock/sanguo_vnpy

# 端口配置
HTTP_PORT=8000
WS_PORT=8080

# 时区
TZ=Asia/Shanghai

# 日志级别
VNPY_LOG_LEVEL=INFO

# 安全配置
JWT_SECRET_KEY=your-secure-secret-key

目录结构

{DATA_DIR}/
├── data/           # 数据库和数据文件
├── logs/           # 运行日志
├── config/         # 配置文件
├── temp/           # 临时文件
├── redis/          # Redis 持久化
└── nginx/          # Nginx 相关

数据备份

重要提示

所有重要数据都存储在配置的 DATA_DIR 中，请确保：

备份命令

# 创建备份
tar czf vnpy_backup_$(date +%Y%m%d).tar.gz {DATA_DIR}

# 恢复备份
tar xzf vnpy_backup_YYYYMMDD.tar.gz -C /

故障排除

常见问题

容器无法启动
- 检查端口占用: netstat -tulpn | grep :8000
- 查看日志: docker-compose logs vnpy
数据丢失
- 确保使用绑定挂载
- 检查 DATA_DIR 配置
性能问题
- 调整资源限制
- 增加 Worker 数量

部署历史

Phase 1 后端部署 (2026-07-04)

部署内容：

✅ 修复 VeighNa 模块加载问题
✅ 修复循环导入问题
✅ 成交监控 API (4 个端点)
✅ 资金监控 API (3 个端点)
✅ 全局配置 API (2 个端点)

部署文件：

sanguo_web/api/__init__.py - 注册新路由
sanguo_web/api/deps.py - 修复循环导入
sanguo_web/services/main_service.py - 添加 offset 和 gateway_name 字段
sanguo_web/api/routes/trades.py - 成交监控路由
sanguo_web/api/routes/accounts.py - 资金监控路由
sanguo_web/api/routes/settings.py - 全局配置路由
run_web.py - 添加 vnpy_v4.4.0 路径

备份位置： ~/.sanguo_projects/sanguo_vnpy_v2/backup_20260704_170319/

验证结果：

总路由数：52
Trades 路由：4 个
Accounts 路由：3 个
Settings 路由：2 个

最后更新: 2026-07-04

3.3 KiB Raw Blame History