3.4 KiB
3.4 KiB
Windows 生产环境部署指南
📋 概述
本指南介绍如何在 Windows 环境下部署 Flask 提示词大师应用的生产环境。
🎯 部署方案
方案一：Waitress 服务器（推荐）
Waitress 是一个纯 Python 的 WSGI 服务器，完全兼容 Windows 环境。
1. 安装依赖
pip install -r requirements.txt
2. 启动生产环境
方法一：使用 Python 脚本
python run_production.py
方法二：使用批处理文件
start_production.bat
3. 停止服务器
方法一：Ctrl+C
在运行窗口按 Ctrl+C 停止服务器
方法二：使用批处理文件
stop_production.bat
⚙️ 配置说明
环境变量配置
生产环境需要设置以下环境变量：
# 设置生产环境
set FLASK_ENV=production
# 数据库配置
set DATABASE_URL=mysql+pymysql://root:123456@localhost:3306/pro_db?charset=utf8mb4
# API 配置
set LLM_API_URL=https://api.deepseek.com/v1
set LLM_API_KEY=your-actual-api-key
# 微信小程序配置
set WX_APPID=your-wx-appid
set WX_SECRET=your-wx-secret
# 安全配置
set SECRET_KEY=your-secret-key
服务器配置
Waitress 服务器配置（在 run_production.py 中）：
serve(
app,
host='0.0.0.0', # 监听所有网络接口
port=5000, # 端口号
threads=4, # 线程数
connection_limit=1000, # 连接限制
cleanup_interval=30, # 清理间隔
channel_timeout=120, # 通道超时
max_request_body_size=1073741824, # 最大请求体大小（1GB）
)
📊 性能优化
1. 数据库优化
- 使用连接池
- 配置适当的索引
- 定期清理日志表
2. 缓存策略
- 启用 Redis 缓存
- 配置模板缓存
- 实现 API 响应缓存
3. 日志管理
- 配置日志轮转
- 设置日志级别
- 监控错误日志
🔒 安全配置
1. 网络安全
- 配置防火墙规则
- 使用 HTTPS
- 限制访问 IP
2. 应用安全
- 启用 CSRF 保护
- 配置 CORS 策略
- 输入验证和过滤
3. 数据安全
- 数据库访问控制
- 敏感信息加密
- 定期备份
📈 监控和维护
1. 健康检查
访问健康检查接口：
GET http://localhost:5000/health
2. 日志监控
- 应用日志：
logs/app.log - 访问日志：
logs/access.log - 错误日志：
logs/error.log
3. 性能监控
- CPU 使用率
- 内存使用情况
- 响应时间
- 并发连接数
🚀 部署脚本
启动脚本
start_production.bat - 生产环境启动脚本
停止脚本
stop_production.bat - 生产环境停止脚本
部署脚本
deploy.sh - 自动化部署脚本（Linux 环境）
🔧 故障排除
常见问题
-
端口被占用
netstat -ano | findstr :5000 taskkill /PID <进程ID> /F -
数据库连接失败
- 检查数据库服务状态
- 验证连接字符串
- 确认网络连接
-
API 调用失败
- 检查 API 密钥配置
- 验证网络连接
- 查看错误日志
日志分析
# 查看应用日志
type logs\app.log
# 查看错误日志
type logs\error.log
# 实时监控日志
Get-Content logs\app.log -Wait
📞 技术支持
如遇到问题，请：
- 查看日志文件
- 检查配置参数
- 验证环境变量
- 联系技术支持
版本: 1.0
更新日期: 2025-08-17
维护者: 开发团队