【经验分享】使用Gunicorn在Linux直接部署Flask服务

ELIX2025-07-162025-07-18

前言

之前也在ubuntu上部署过python项目，使用的是docker方式，虽然解决了依赖的问题，但维护起来很麻烦。

于是这次直接在虚拟环境上部署flask，意外的顺利运行起来了。

后来了解到Flask自带的服务器性能很差，官方也明文强烈禁止使用开发服务器运行项目，原因如下：

1.安全性。开发服务器未内置 Web 应用防火墙（WAF）、请求过滤等安全机制，易受 DDoS、SQL 注入等攻击。

2.性能。Flask 开发服务器基于 Werkzeug，默认只能同时处理一个请求，无法利用多核 CPU，无法扩展工作进程。

3.稳定性。无自动恢复机制，且长时间运行可能出现内存泄漏。

4.功能缺失。静态文件处理低效，缺乏请求日志、错误追踪等运维必需功能。

因此这次采用Gunicorn + Nginx的方式进行部署。

项目运行

1.先编译好Flask程序，本地运行成功后，使用第三方工具来获取requirements.txt，这里面包含了当前项目所有依赖包，方便服务器环境构建。

pip install pipreqs

pipreqs .

2.将项目上传到服务器，构建虚拟环境并测试项目运行。

# 安装 pip
sudo apt update
sudo apt install python3-pip
#创建虚拟环境
sudo apt install python3-venv  # 安装虚拟环境工具
cd your_flask_project          # 进入项目目录
python3 -m venv project_name           # 创建虚拟环境
source venv/bin/activate       # 激活环境（退出用 deactivate）
#安装 Flask 和依赖
pip install flask
pip install -r requirements.txt
#指定 Flask 应用入口文件
export FLASK_APP=app.py       # 替换为你的主文件=》就是python程序的文件名字，如main.py这种
export FLASK_ENV=development  # 开发模式（生产环境需移除）
#运行 Flask 开发服务器
flask run --host=0.0.0.0 --port=8088

3.运行成功后，即可进行生产环境迁移了。

生产环境部署

1.安装WSGI服务器依赖并尝试运行测试

1 2	pip install flask gunicorn gunicorn --bind 0.0.0.0:5010 savehistory:app

2.创建系统服务配置sudo nano /etc/systemd/system/savehistory.service

[Unit]
Description=SaveHistory Flask App
After=network.target

[Service]
User=root
#改为你项目的地址，一定要仔细
WorkingDirectory=/usr/amedia/end/AIend
Environment="PATH=/usr/amedia/end/AIend/aiend/bin"
ExecStart=/usr/amedia/end/AIend/aiend/bin/gunicorn --workers 2 --bind 0.0.0.0:5010 savehistory:app

[Install]
WantedBy=multi-user.target

3.运行服务

sudo systemctl daemon-reload
sudo systemctl start savehistory
sudo systemctl stop savehistory #如果是想重启（更新）服务
sudo systemctl enable savehistory
#验证服务运行状态
sudo systemctl status savehistory  # 应显示active (running)
sudo journalctl -u savehistory -f  # 查看实时日志

4.启用nginx代理sudo nano /etc/nginx/sites-available/savehistory

server {
    listen 80;
    server_name 154.201.66.xxx;

    location / {
        proxy_pass http://127.0.0.1:5010;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}