Files
sanguo_vnpy_v2/docs/deployment
claude_dev 918bbed0fc fix: 修复登录500错误和移除明文密码提示
- 修复 deps.py 中 get_vn_service 的引用错误 (vn_service.vn_service -> vn_service)
- 移除登录页面上的明文密码提示
- 改进前端错误处理,避免数据加载失败导致登录显示错误
2026-07-02 12:23:55 +08:00
..

部署文档

本目录包含 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 中,请确保:

  1. 该目录有足够的存储空间
  2. 定期备份该目录
  3. 备份包含所有子目录

备份命令

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

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

故障排除

常见问题

  1. 容器无法启动

    • 检查端口占用: netstat -tulpn | grep :8000
    • 查看日志: docker-compose logs vnpy
  2. 数据丢失

    • 确保使用绑定挂载
    • 检查 DATA_DIR 配置
  3. 性能问题

    • 调整资源限制
    • 增加 Worker 数量

相关文档


最后更新: 2026-07-01