快速结论
Python生产部署标准组合:Gunicorn(WSGI服务器)+ Nginx(反向代理)+ Supervisor(进程管理)。推荐阿里云轻量或腾讯云轻量,2核2G即可运行Flask/Django项目。
部署架构
用户请求 → Nginx(80/443) → Gunicorn(8000) → Flask/Django应用
↓
静态文件直接返回为什么不能用Flask/Django自带的开发服务器?
| 问题 | 开发服务器 | Gunicorn |
|---|---|---|
| 并发处理 | 单进程/单线程 | 多Worker进程 |
| 性能 | 极低 | 生产级 |
| 稳定性 | 可能崩溃 | 自动重启Worker |
| 安全性 | 无任何防护 | 配合Nginx安全加固 |
| 静态文件 | Python处理(慢) | Nginx处理(快) |
服务器选择
| 项目规模 | 配置 | 推荐 | 年费 |
|---|---|---|---|
| 个人/学习 | 2核2G | 阿里云轻量 | 38元 |
| 小型项目 | 2核4G | 腾讯云轻量 | 88元 |
| 企业项目 | 4核8G | 华为云ECS | 200元+ |
Python比Java省内存,2GB就能跑起来。
Flask部署实战
1. 准备项目
# app.py
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return 'Hello, World!'
# 不要在生产环境用 app.run()# requirements.txt
flask==3.0.0
gunicorn==21.2.02. 服务器环境安装
# SSH连接服务器
ssh root@你的服务器IP
# 安装Python和依赖
sudo apt update
sudo apt install python3 python3-pip python3-venv nginx supervisor -y
# 创建项目目录
mkdir -p /opt/myapp
cd /opt/myapp
# 上传代码(或git clone)
git clone https://github.com/your/project.git .
# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt3. Gunicorn配置
# gunicorn.conf.py
bind = '127.0.0.1:8000'
workers = 4 # 推荐 CPU核心数 × 2 + 1
threads = 2
timeout = 120
accesslog = '/var/log/myapp/access.log'
errorlog = '/var/log/myapp/error.log'
loglevel = 'info'测试运行:
gunicorn -c gunicorn.conf.py app:app4. Supervisor进程管理
# /etc/supervisor/conf.d/myapp.conf
[program:myapp]
directory=/opt/myapp
command=/opt/myapp/venv/bin/gunicorn -c gunicorn.conf.py app:app
user=www-data
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/myapp/supervisor.log
environment=FLASK_ENV="production"# 创建日志目录
mkdir -p /var/log/myapp
# 加载并启动
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start myapp
# 管理命令
sudo supervisorctl status myapp
sudo supervisorctl restart myapp
sudo supervisorctl tail -f myapp5. Nginx反向代理
# /etc/nginx/sites-available/myapp
server {
listen 80;
server_name yourdomain.com;
# 静态文件
location /static/ {
alias /opt/myapp/static/;
expires 30d;
}
# 代理到Gunicorn
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 60;
proxy_read_timeout 120;
}
}# 启用站点
ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
# 配置SSL
certbot --nginx -d yourdomain.comDjango部署实战
Django特殊配置
# settings/production.py
DEBUG = False
ALLOWED_HOSTS = ['yourdomain.com', 'www.yourdomain.com']
STATIC_URL = '/static/'
STATIC_ROOT = '/opt/myapp/staticfiles'
MEDIA_URL = '/media/'
MEDIA_ROOT = '/opt/myapp/media'
# 数据库(使用PostgreSQL)
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'mydb',
'USER': 'dbuser',
'PASSWORD': 'dbpass',
'HOST': 'localhost',
'PORT': '5432',
}
}Django部署命令
# 激活虚拟环境
source /opt/myapp/venv/bin/activate
# 收集静态文件
python manage.py collectstatic --noinput
# 数据库迁移
python manage.py migrate
# Gunicorn启动Django
gunicorn myproject.wsgi:application -c gunicorn.conf.pyDjango Nginx配置
server {
listen 443 ssl http2;
server_name yourdomain.com;
# SSL配置...
# Django静态文件
location /static/ {
alias /opt/myapp/staticfiles/;
expires 30d;
}
# 用户上传的媒体文件
location /media/ {
alias /opt/myapp/media/;
expires 7d;
}
# 代理到Django
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}Docker部署方案
Docker 与 Compose 的基础用法见Docker 部署指南。
Dockerfile
FROM python:3.12-slim
WORKDIR /app
# 安装依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
# 复制代码
COPY . .
# 收集静态文件(Django)
RUN python manage.py collectstatic --noinput 2>/dev/null || true
EXPOSE 8000
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "4", "app:app"]Docker Compose
version: '3.8'
services:
web:
build: .
ports:
- "8000:8000"
environment:
- FLASK_ENV=production
- DATABASE_URL=postgresql://user:pass@db:5432/mydb
depends_on:
- db
restart: always
db:
image: postgres:16-alpine
environment:
POSTGRES_DB: mydb
POSTGRES_USER: user
POSTGRES_PASSWORD: pass
volumes:
- pgdata:/var/lib/postgresql/data
restart: always
volumes:
pgdata:性能优化
上线后的指标观测与告警配置见服务器监控指南。
| 优化项 | 效果 | 做法 |
|---|---|---|
| Gunicorn Workers | 并发提升 | workers = CPU × 2 + 1 |
| 异步Worker | IO密集提升 | gevent/uvicorn |
| Redis缓存 | 减少DB查询 | Flask-Caching/django-redis |
| 数据库连接池 | 减少连接开销 | SQLAlchemy pool |
| CDN静态资源 | 减轻服务器压力 | 阿里云CDN |
异步部署(FastAPI/ASGI)
如果用FastAPI或Django ASGI:
# 使用uvicorn
pip install uvicorn
# FastAPI
uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4
# Django ASGI
uvicorn myproject.asgi:application --host 0.0.0.0 --port 8000 --workers 4常见问题
Q:502 Bad Gateway怎么排查?
- 检查Gunicorn是否在运行:
supervisorctl status - 检查端口:
ss -tlnp | grep 8000 - 查看Gunicorn日志:
cat /var/log/myapp/error.log - 确认Nginx代理地址正确
Q:静态文件404?
Django:确保运行了collectstatic且Nginx的alias路径正确。Flask:检查static文件夹路径。
Q:上传大文件失败?
Nginx默认限制1MB,修改:client_max_body_size 50m;
推荐方案
| 场景 | 方案 | 年费 |
|---|---|---|
| Flask小项目 | 阿里云轻量2核2G + Gunicorn | 38元 |
| Django企业项目 | 腾讯云CVM 2核4G + Docker | 200元起 |
| 高并发API | 华为云ECS 4核8G + uvicorn | 500元起 |
一句话:Gunicorn+Nginx+Supervisor是Python Web部署的黄金三角,30分钟搞定生产级部署。