Python Web项目部署:Django/Flask云服务器实战2026

WeHosts技术团队·2026年4月4日·更新于 2026年10月21日

快速结论

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华为云ECS200元+

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.0

2. 服务器环境安装

# 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.txt

3. 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:app

4. 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 myapp

5. 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.com

Django部署实战

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.py

Django 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
异步WorkerIO密集提升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怎么排查?

  1. 检查Gunicorn是否在运行:supervisorctl status
  2. 检查端口:ss -tlnp | grep 8000
  3. 查看Gunicorn日志:cat /var/log/myapp/error.log
  4. 确认Nginx代理地址正确

Q:静态文件404?

Django:确保运行了collectstatic且Nginx的alias路径正确。Flask:检查static文件夹路径。

Q:上传大文件失败?

Nginx默认限制1MB,修改:client_max_body_size 50m;


推荐方案

场景方案年费
Flask小项目阿里云轻量2核2G + Gunicorn38元
Django企业项目腾讯云CVM 2核4G + Docker200元起
高并发API华为云ECS 4核8G + uvicorn500元起

一句话:Gunicorn+Nginx+Supervisor是Python Web部署的黄金三角,30分钟搞定生产级部署。

延伸阅读

本文可能含联盟推广链接,购买不增加你的价格,详见联盟披露。

文中提到的云平台当前活动价

文中价格均来自各平台公开活动页。想直接对比在售机型,可以先看下面这些:价格核实日期与台账一致,以活动页为准。