当前位置：首页 > news >正文

使用 Nginx 和 Gunicorn 部署 Flask 项目详细教程

news 2025/7/26 18:08:13

使用 Nginx 和 Gunicorn 部署 Flask 项目详细教程

在这篇文章中，我们将介绍如何使用 Nginx 和 Gunicorn 来部署一个 Flask 项目。这种部署方式非常适合在生产环境中使用，因为它能够提供更好的性能和更高的稳定性。

1. Flask 项目简介

假设你已经有了一个简单的 Flask 应用。如果还没有，你可以使用以下代码创建一个简单的 Flask 项目：

# 文件名: app.py
from flask import Flaskapp = Flask(__name__)@app.route('/')
def hello():return 'Hello, this is a Flask app!'if __name__ == '__main__':app.run()

这个项目的目标是通过 Nginx 和 Gunicorn 将它部署到生产服务器上，确保它能够高效处理请求，并且在服务器重启时自动启动。

2. 环境准备

在开始部署之前，确保你的服务器已经安装了以下组件：

步骤 1：更新服务器并安装 Python 和 pip

sudo apt update
sudo apt upgrade
sudo apt install python3 python3-pip python3-venv

步骤 2：创建 Python 虚拟环境并激活

在你的项目目录中创建一个虚拟环境，并激活它：

# 进入你的项目目录
cd /path/to/your/flask/project# 创建虚拟环境
python3 -m venv myenv# 激活虚拟环境
source myenv/bin/activate

步骤 3：安装 Flask 和 Gunicorn

在激活的虚拟环境下安装 Flask 和 Gunicorn：

pip install flask gunicorn

3. Gunicorn 配置

Gunicorn 是一个 WSGI 服务器，用于运行 Flask 应用，并将其作为后台服务。我们可以通过以下命令启动 Flask 应用：

gunicorn --workers 3 app:app

参数解释：

--workers 3：表示使用 3 个工作线程来处理请求。
app:app：第一个 app 是指 app.py 文件的名字，第二个 app 是 Flask 应用实例的名字。

4. 使用 Systemd 管理 Gunicorn 服务

为了让 Gunicorn 在服务器启动时自动启动，我们可以使用 Systemd 来管理 Gunicorn 服务。

步骤 1：创建 Gunicorn 服务文件

sudo nano /etc/systemd/system/flask_app.service

在文件中添加以下内容：

[Unit]
Description=Gunicorn instance to serve Flask app
After=network.target[Service]
User=your_username  # 替换为你的服务器用户名
Group=www-data
WorkingDirectory=/path/to/your/flask/project  # 替换为你的 Flask 应用目录
ExecStart=/path/to/your/flask/project/myenv/bin/gunicorn --workers 3 --bind unix:flask_app.sock -m 007 app:app[Install]
WantedBy=multi-user.target

步骤 2：启动 Gunicorn 服务

启动 Gunicorn 服务并将其设置为开机自启：

# 启动服务
sudo systemctl start flask_app# 设置为开机自启
sudo systemctl enable flask_app

步骤 3：检查 Gunicorn 服务状态

sudo systemctl status flask_app

如果服务启动成功，你应该能看到类似如下的输出：

● flask_app.service - Gunicorn instance to serve Flask appLoaded: loaded (/etc/systemd/system/flask_app.service; enabled; vendor preset: enabled)Active: active (running)

5. 配置 Nginx 作为反向代理

Nginx 作为反向代理，将所有来自外部的请求转发到 Gunicorn 来处理。

步骤 1：安装 Nginx

在服务器上安装 Nginx：

sudo apt install nginx

步骤 2：为 Flask 项目创建 Nginx 配置文件

创建 Nginx 配置文件：

sudo nano /etc/nginx/sites-available/flask_app

在文件中添加以下内容：

server {listen 80;server_name your_domain_or_IP;  # 替换为你的域名或服务器的IP# 处理静态文件location /static/ {alias /path/to/your/flask/project/static/;  # Flask 的静态文件目录}# 处理应用的请求location / {proxy_pass http://unix:/path/to/your/flask/project/flask_app.sock;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;}# 日志配置（可选）access_log /var/log/nginx/flask_app.access.log;error_log /var/log/nginx/flask_app.error.log;
}

步骤 3：激活 Nginx 配置

使用符号链接将配置文件链接到 sites-enabled：

sudo ln -s /etc/nginx/sites-available/flask_app /etc/nginx/sites-enabled

步骤 4：检查 Nginx 配置是否正确

sudo nginx -t

步骤 5：重启 Nginx

sudo systemctl restart nginx

现在，你可以通过服务器的 IP 或域名来访问你的 Flask 应用了。

6. 配置防火墙

如果你的服务器使用了 UFW 作为防火墙工具，确保允许 Nginx 的 HTTP 和 HTTPS 流量：

sudo ufw allow 'Nginx Full'

7. 使用 SSL 启用 HTTPS（可选）

为了保护用户数据，可以使用 Let’s Encrypt 配置免费的 SSL 证书。

步骤 1：安装 Certbot

Certbot 是一个自动化工具，用来获取免费的 SSL 证书：

sudo apt install certbot python3-certbot-nginx

步骤 2：获取 SSL 证书

运行以下命令为你的域名获取 SSL 证书：

sudo certbot --nginx -d your_domain

Certbot 会自动更新你的 Nginx 配置并启用 SSL。

步骤 3：设置证书自动更新

Let’s Encrypt 的 SSL 证书默认有效期为 90 天，你可以通过设置自动更新来保持证书有效：

sudo certbot renew --dry-run

8. 总结

通过使用 Gunicorn 和 Nginx，你可以轻松地将 Flask 项目部署到生产服务器中。Gunicorn 作为 WSGI 服务器处理 Python 请求，Nginx 作为反向代理处理静态文件和请求路由。通过 Systemd，你可以管理 Gunicorn 服务，确保它在服务器重启时自动启动。最后，通过 Let’s Encrypt 配置 SSL 证书，你可以启用 HTTPS 提升安全性。

这种方式适用于小型和中型 Flask 应用的生产环境部署，希望这篇文章能帮助你快速、高效地部署 Flask 项目。

查看全文

http://www.lryc.cn/news/451196.html