chore: 优化 Docker 配置，添加生产环境部署脚本和文档

2026-03-18 22:48:36 +08:00
parent f655aa0ede
commit e3a620b395
8 changed files with 610 additions and 43 deletions
--- a/DEPLOY.md
+++ b/DEPLOY.md
@@ -0,0 +1,249 @@
+# 创赢未来报名评分系统 - 生产环境部署指南
+
+## 📋 部署前准备
+
+### 系统要求
+- **操作系统**: Ubuntu 20.04+ / CentOS 7+ / Debian 10+
+- **内存**: 至少 2GB RAM
+- **磁盘**: 至少 20GB 可用空间
+- **Docker**: 20.10+
+- **Docker Compose**: 2.0+
+
+### 安装 Docker
+```bash
+# Ubuntu/Debian
+curl -fsSL https://get.docker.com | sh
+sudo usermod -aG docker $USER
+
+# 安装 Docker Compose
+sudo apt-get install -y docker-compose-plugin
+# 或
+pip install docker-compose
+```
+
+## 🚀 快速部署
+
+### 1. 拉取代码
+```bash
+git clone https://gitea.tangledup-ai.com/quant-speed-AI/Scoring-System.git
+cd Scoring-System
+```
+
+### 2. 配置环境变量
+```bash
+# 复制环境变量模板
+cp .env.example .env
+
+# 编辑 .env 文件，填入您的实际配置
+vim .env
+```
+
+**必须配置的项目：**
+- `SECRET_KEY`: Django 安全密钥（必须修改！）
+- `DB_PASSWORD`: 数据库密码
+- `WECHAT_*`: 微信支付相关配置（如需支付功能）
+- `ALIYUN_*`: 阿里云 OSS 和 AI 服务配置（如需语音转写和 AI 评估）
+
+### 3. 执行部署脚本
+```bash
+# 给脚本添加执行权限
+chmod +x deploy.sh
+
+# 执行部署
+./deploy.sh
+```
+
+## 🔧 手动部署（高级）
+
+### 1. 构建镜像
+```bash
+docker-compose build --no-cache
+```
+
+### 2. 启动服务
+```bash
+# 后台启动
+docker-compose up -d
+
+# 查看日志
+docker-compose logs -f
+
+# 查看特定服务日志
+docker-compose logs -f backend
+docker-compose logs -f frontend
+```
+
+### 3. 执行数据库迁移
+```bash
+docker-compose exec backend python manage.py migrate
+docker-compose exec backend python manage.py createsuperuser
+```
+
+### 4. 收集静态文件
+```bash
+docker-compose exec backend python manage.py collectstatic --noinput
+```
+
+## 🌐 Nginx 反向代理配置（推荐）
+
+如果需要使用域名和 HTTPS，在服务器上安装 Nginx：
+
+```nginx
+# /etc/nginx/sites-available/scoring-system
+server {
+    listen 80;
+    server_name your-domain.com;
+    
+    location / {
+        proxy_pass http://localhost:80;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+启用配置：
+```bash
+sudo ln -s /etc/nginx/sites-available/scoring-system /etc/nginx/sites-enabled/
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+## 🔒 HTTPS 配置（Let's Encrypt）
+
+```bash
+# 安装 Certbot
+sudo apt-get install -y certbot python3-certbot-nginx
+
+# 申请证书
+sudo certbot --nginx -d your-domain.com
+
+# 自动续期
+sudo certbot renew --dry-run
+```
+
+## 📊 常用命令
+
+```bash
+# 查看运行状态
+docker-compose ps
+
+# 停止服务
+docker-compose down
+
+# 重启服务
+docker-compose restart
+
+# 重启单个服务
+docker-compose restart backend
+
+# 进入容器
+docker-compose exec backend bash
+docker-compose exec frontend sh
+
+# 查看容器日志
+docker-compose logs -f --tail=100 backend
+
+# 清理未使用的镜像
+docker image prune -f
+
+# 更新部署（拉取最新代码并重启）
+git pull
+./deploy.sh
+```
+
+## 🔍 故障排查
+
+### 问题1: 端口被占用
+```bash
+# 检查端口占用
+sudo netstat -tlnp | grep 8000
+sudo netstat -tlnp | grep 80
+
+# 修改 docker-compose.yml 中的端口映射
+```
+
+### 问题2: 数据库连接失败
+```bash
+# 检查数据库配置
+docker-compose exec backend python manage.py dbshell
+
+# 查看后端日志
+docker-compose logs backend | grep -i error
+```
+
+### 问题3: 静态文件无法访问
+```bash
+# 重新收集静态文件
+docker-compose exec backend python manage.py collectstatic --noinput
+
+# 检查权限
+ls -la backend/static/
+ls -la backend/media/
+```
+
+### 问题4: 容器无法启动
+```bash
+# 查看详细日志
+docker-compose logs --no-color
+
+# 检查配置
+docker-compose config
+```
+
+## 💾 数据备份
+
+### 数据库备份
+```bash
+# 进入容器执行备份
+docker-compose exec backend python manage.py dumpdata > backup_$(date +%Y%m%d).json
+
+# 或使用 PostgreSQL 直接备份
+docker exec scoring_system_db pg_dump -U postgres scoring_system > db_backup_$(date +%Y%m%d).sql
+```
+
+### 媒体文件备份
+```bash
+# 备份上传的文件
+tar -czvf media_backup_$(date +%Y%m%d).tar.gz backend/media/
+```
+
+## 🔄 自动部署（CI/CD）
+
+使用 Gitea Actions 或 Jenkins 实现自动部署：
+
+```yaml
+# .gitea/workflows/deploy.yaml
+name: Deploy to Production
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to Server
+        uses: appleboy/ssh-action@master
+        with:
+          host: ${{ secrets.HOST }}
+          username: ${{ secrets.USERNAME }}
+          password: ${{ secrets.PASSWORD }}
+          script: |
+            cd ~/Scoring-System
+            git pull
+            ./deploy.sh
+```
+
+## 📞 技术支持
+
+- **项目仓库**: https://gitea.tangledup-ai.com/quant-speed-AI/Scoring-System
+- **问题反馈**: 在仓库提交 Issue
+
+---
+
+**部署完成后访问地址：**
+- 🌐 前端页面: http://your-server-ip/
+- 🔧 后台管理: http://your-server-ip:8000/admin/
+- 📚 API 文档: http://your-server-ip:8000/api/docs/