claude_dev
1a88954126
- v1 data_platform 脚本复制到 v2/scripts/data_platform/ 维护 - daily_all_update.py: 路径用 STOCK_MOUNT env(SSH模式) + STOCK_LIMIT(验证) - run_daily_update.sh: rsync拉NAS→本地 + v1增量 + 推NAS(SSH key免密,不挂载) - launchd com.sanguo.data-update 每日15:30(替代crontab,macOS FDA限制) - 验证: STOCK_LIMIT=2 updated=2 records=24 拉到当天 - 文档 docs/deployment/data-download.md
部署文档
本目录包含 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