206 lines
3.4 KiB
Markdown
206 lines
3.4 KiB
Markdown
# Windows 生产环境部署指南
|
||
|
||
## 📋 概述
|
||
|
||
本指南介绍如何在 Windows 环境下部署 Flask 提示词大师应用的生产环境。
|
||
|
||
## 🎯 部署方案
|
||
|
||
### 方案一：Waitress 服务器（推荐）
|
||
|
||
Waitress 是一个纯 Python 的 WSGI 服务器，完全兼容 Windows 环境。
|
||
|
||
#### 1. 安装依赖
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
#### 2. 启动生产环境
|
||
|
||
**方法一：使用 Python 脚本**
|
||
```bash
|
||
python run_production.py
|
||
```
|
||
|
||
**方法二：使用批处理文件**
|
||
```bash
|
||
start_production.bat
|
||
```
|
||
|
||
#### 3. 停止服务器
|
||
|
||
**方法一：Ctrl+C**
|
||
在运行窗口按 `Ctrl+C` 停止服务器
|
||
|
||
**方法二：使用批处理文件**
|
||
```bash
|
||
stop_production.bat
|
||
```
|
||
|
||
## ⚙️ 配置说明
|
||
|
||
### 环境变量配置
|
||
|
||
生产环境需要设置以下环境变量：
|
||
|
||
```bash
|
||
# 设置生产环境
|
||
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` 中）：
|
||
|
||
```python
|
||
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 环境）
|
||
|
||
## 🔧 故障排除
|
||
|
||
### 常见问题
|
||
|
||
1. **端口被占用**
|
||
```bash
|
||
netstat -ano | findstr :5000
|
||
taskkill /PID <进程ID> /F
|
||
```
|
||
|
||
2. **数据库连接失败**
|
||
- 检查数据库服务状态
|
||
- 验证连接字符串
|
||
- 确认网络连接
|
||
|
||
3. **API 调用失败**
|
||
- 检查 API 密钥配置
|
||
- 验证网络连接
|
||
- 查看错误日志
|
||
|
||
### 日志分析
|
||
|
||
```bash
|
||
# 查看应用日志
|
||
type logs\app.log
|
||
|
||
# 查看错误日志
|
||
type logs\error.log
|
||
|
||
# 实时监控日志
|
||
Get-Content logs\app.log -Wait
|
||
```
|
||
|
||
## 📞 技术支持
|
||
|
||
如遇到问题，请：
|
||
|
||
1. 查看日志文件
|
||
2. 检查配置参数
|
||
3. 验证环境变量
|
||
4. 联系技术支持
|
||
|
||
---
|
||
|
||
**版本**: 1.0
|
||
**更新日期**: 2025-08-17
|
||
**维护者**: 开发团队
|