claude_dev
918bbed0fc
- 修复 deps.py 中 get_vn_service 的引用错误 (vn_service.vn_service -> vn_service) - 移除登录页面上的明文密码提示 - 改进前端错误处理，避免数据加载失败导致登录显示错误
123 lines
2.4 KiB
Markdown
123 lines
2.4 KiB
Markdown
# 部署文档
|
|
|
|
本目录包含 Sanguo VeighNa 平台的部署相关文档。
|
|
|
|
## 文档列表
|
|
|
|
### Docker 部署
|
|
|
|
- **[docker-deployment.md](./docker-deployment.md)** - Docker 容器部署指南
|
|
- 前置要求和安装
|
|
- 快速开始步骤
|
|
- 配置说明
|
|
- 生产部署建议
|
|
|
|
### Synology NAS 部署
|
|
|
|
- **[synology-nas.md](./synology-nas.md)** - Synology NAS 专用部署指南
|
|
- NAS 环境配置
|
|
- 数据持久化设置
|
|
- 自动备份配置
|
|
- 故障排除
|
|
|
|
## 快速链接
|
|
|
|
### 部署方式对比
|
|
|
|
| 方式 | 适用场景 | 难度 | 推荐度 |
|
|
|------|----------|------|--------|
|
|
| Docker Compose | 开发/测试/小规模部署 | 简单 | ⭐⭐⭐⭐⭐ |
|
|
| Synology NAS | 家庭 NAS 部署 | 中等 | ⭐⭐⭐⭐ |
|
|
| Kubernetes | 大规模/高可用部署 | 复杂 | ⭐⭐⭐ |
|
|
|
|
### 部署检查清单
|
|
|
|
- [ ] 硬件要求满足（内存、存储）
|
|
- [ ] Docker/Docker Compose 已安装
|
|
- [ ] 网络端口已开放
|
|
- [ ] 数据目录已创建
|
|
- [ ] 环境变量已配置
|
|
- [ ] SSL 证书已准备（生产环境）
|
|
- [ ] 备份策略已制定
|
|
|
|
## 配置文件
|
|
|
|
### 环境变量示例
|
|
|
|
```env
|
|
# 数据目录
|
|
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. 备份包含所有子目录
|
|
|
|
### 备份命令
|
|
|
|
```bash
|
|
# 创建备份
|
|
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 数量
|
|
|
|
## 相关文档
|
|
|
|
- [开发文档](../development.md)
|
|
- [运维文档](../operations/)
|
|
- [API 文档](../api/)
|
|
- [用户指南](../user_guide/)
|
|
|
|
---
|
|
|
|
**最后更新**: 2026-07-01
|