Python Web框架在Ubuntu上如何部署

在 Ubuntu 上部署 Python Web 框架的标准流程

面向 Flask、Django 等主流框架，生产环境通常采用 WSGI 服务器（Gunicorn 或 uWSGI）+ Nginx 反向代理，并通过 systemd 守护进程保证常驻运行。若使用 ASGI 框架（如 FastAPI、Starlette），应改用 Uvicorn/Hypercorn 作为 ASGI 服务器，Nginx 配置思路一致。该组合可提供静态资源高效服务、并发处理与进程守护能力。

一、准备与部署通用步骤

系统更新与基础工具
- 执行：sudo apt update && sudo apt install -y python3 python3-pip python3-venv git build-essential libssl-dev libffi-dev
上传或克隆代码
- Git：git clone <repo> && cd <project>
- SCP：scp -r <本地目录> <user>@<ip>:/path/to/app
创建虚拟环境与依赖
- python3 -m venv venv && source venv/bin/activate
- pip install -r requirements.txt
开放防火墙与端口
- UFW：sudo ufw allow 'Nginx Full'（同时保证 22 端口用于 SSH）
注意
- 生产环境不要使用框架自带的开发服务器（如 Flask 的 app.run()）。

二、以 Gunicorn + Nginx 部署（Flask 示例）

安装与试运行
- pip install gunicorn
- 假设入口为 app.py，应用对象为 app：gunicorn -w 4 app:app（先在本地或内网验证）

配置 systemd 守护进程

新建：sudo nano /etc/systemd/system/myflaskapp.service

示例：

[Unit]
Description=My Flask Application
After=network.target

[Service]
User=ubuntu
Group=www-data
WorkingDirectory=/path/to/your/flask/app
Environment="PATH=/path/to/your/flask/app/venv/bin"
ExecStart=/path/to/your/flask/app/venv/bin/gunicorn -w 4 app:app

[Install]
WantedBy=multi-user.target

启动与开机自启：sudo systemctl daemon-reload && sudo systemctl start myflaskapp && sudo systemctl enable myflaskapp

配置 Nginx 反向代理

安装：sudo apt install nginx
编辑：sudo nano /etc/nginx/sites-available/default

示例：

server {
    listen 80;
    server_name your_domain_or_ip;

    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;
    }
}

校验与生效：sudo nginx -t && sudo systemctl reload nginx

访问验证
- 浏览器访问 http://your_domain_or_ip，应看到应用页面。

三、以 uWSGI + Nginx 部署（Django 示例）

安装与准备
- pip install uwsgi
- 收集静态文件（Django）：python manage.py collectstatic --noinput

配置 uWSGI（INI 示例）

新建：nano myapp_uwsgi.ini

示例：

[uwsgi]
module = myproject.wsgi:application
master = true
processes = 4
socket = /run/gunicorn.sock
chmod-socket = 660
vacuum = true
die-on-term = true

配置 systemd 守护 uWSGI

新建：sudo nano /etc/systemd/system/myuwsgi.service

示例：

[Unit]
Description=uWSGI instance to serve myproject
After=network.target

[Service]
User=ubuntu
Group=www-data
WorkingDirectory=/path/to/myproject
Environment="PATH=/path/to/myproject/venv/bin"
ExecStart=/path/to/myproject/venv/bin/uwsgi --ini myapp_uwsgi.ini

[Install]
WantedBy=multi-user.target

启动：sudo systemctl daemon-reload && sudo systemctl start myuwsgi && sudo systemctl enable myuwsgi

配置 Nginx

示例：

server {
    listen 80;
    server_name myproject.example.com;

    location / {
        include uwsgi_params;
        uwsgi_pass unix:/run/gunicorn.sock;
    }

    location /static {
        alias /path/to/myproject/static;
    }
}

启用与生效：sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled/ && sudo nginx -t && sudo systemctl reload nginx

访问验证
- 浏览器访问 http://myproject.example.com，静态资源由 Nginx 直接服务，动态请求由 uWSGI 处理。

四、可选优化与安全加固

启用 HTTPS（Let’s Encrypt）
- 安装：sudo apt install certbot python3-certbot-nginx -y
- 申请并自动配置：sudo certbot --nginx -d yourdomain.com
进程管理替代方案
- 亦可使用 Supervisor 管理 Gunicorn/uWSGI 进程，步骤包括安装 Supervisor、编写 program 配置、启动与设置开机自启。
日志与排错
- 查看服务日志：sudo journalctl -u myflaskapp -f、sudo journalctl -u myuwsgi -f
- Nginx 日志：/var/log/nginx/access.log、/var/log/nginx/error.log
静态文件与媒体文件
- Django 将 STATIC_ROOT 收集后由 Nginx 的 location /static 提供服务；用户上传的 MEDIA_ROOT 亦建议由 Nginx 直接托管并设置合适的访问权限。

最新问答

相关标签