Linux服务器部署Flask应用时,如何配置WSGI服务并验证进程托管?

发布人:A5数据发布时间:2026-10-26 12:19阅读量:116

在 Linux 服务器上部署 Flask,通常由 Gunicorn 等 WSGI 服务器接收请求,再由 systemd 负责启动、停止、重启和异常拉起进程。Flask 自带的开发服务器适合本机调试,不应作为生产环境的常驻服务。下面以使用 systemd 的 Ubuntu 22.04/24.04 或 Debian 服务器为例,部署一个由 Gunicorn 托管的 Flask 应用,并通过服务状态、进程、日志和 HTTP 请求逐项验证。

示例使用域名 example.com、应用目录 /srv/flaskapp 和本机端口 127.0.0.1:8000。这些值需要替换为实际环境中的配置。若服务器使用其他发行版或没有 systemd,应先核实其包管理器与服务管理方式,不能直接照搬命令。

准备条件

开始前确认:

  • 有可通过 SSH 登录的服务器账号,并具备 sudo 权限。
  • 系统使用 systemd;可以用 systemctl --version 检查。
  • Flask 应用代码及依赖清单已准备好。以下示例假设入口模块为 wsgi.py,其中提供名为 app 的 Flask 应用对象。
  • 如果要对外提供 HTTP/HTTPS 服务,需另行准备域名解析、防火墙规则和 Nginx 等入口配置。本文先验证应用服务本身,再说明 Nginx 的基本接入方式。
  • 通过 SSH 管理服务器时,不要为了本次部署随意修改 SSH 端口或相关防火墙规则,以免中断管理连接。

先核对系统与可用磁盘空间:

cat /etc/os-release
systemctl --version
df -h /srv

如 /srv 尚不存在,df 命令仍可用于检查根分区空间。安装前确认系统盘有足够空间存放 Python 环境、应用文件和日志。

创建运行账号并准备应用

为应用创建专用系统账号,避免以 root 身份运行 Web 服务。以下命令不会删除已有文件;如果 /srv/flaskapp 已经存在,先检查其中内容及属主,再决定是否复用。

sudo adduser --system --group --home /srv/flaskapp --no-create-home flaskapp
sudo mkdir -p /srv/flaskapp
sudo chown flaskapp:flaskapp /srv/flaskapp

安装 Python 虚拟环境所需软件包。若服务器使用其他发行版,应改用该系统对应的软件包管理命令。

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

将应用代码放到 /srv/flaskapp。例如,一个最小的应用可以采用以下结构:

/srv/flaskapp/
├── app.py
├── requirements.txt
└── wsgi.py

app.py 示例:

from flask import Flask

app = Flask(__name__)

@app.get("/health")
def health():
    return {"status": "ok"}

wsgi.py 示例:

from app import app

requirements.txt 至少应列出应用实际使用的依赖。例如:

Flask
gunicorn

安装依赖时,使用虚拟环境隔离项目包。生产部署时应将依赖版本固定在项目维护的清单中,避免每次重新安装都解析到不同版本。

sudo -u flaskapp python3 -m venv /srv/flaskapp/.venv
sudo -u flaskapp /srv/flaskapp/.venv/bin/pip install --upgrade pip
sudo -u flaskapp /srv/flaskapp/.venv/bin/pip install -r /srv/flaskapp/requirements.txt

验证:确认 Gunicorn 和 Flask 已安装,并且入口模块能够导入:

sudo -u flaskapp /srv/flaskapp/.venv/bin/gunicorn --version
sudo -u flaskapp bash -c 'cd /srv/flaskapp && .venv/bin/python -c "from wsgi import app; print(app.name)"'

第一条命令应显示 Gunicorn 版本;第二条应输出 Flask 应用名称。如果导入失败,先检查文件名、依赖和工作目录,不要继续配置 systemd。

配置 WSGI 服务

WSGI 是 Python Web 应用与 Web 服务器之间的接口约定。Gunicorn 按照 wsgi:app 加载 wsgi.py 中的 app 对象,并负责接收请求、分配工作进程;systemd 则管理 Gunicorn 主进程的生命周期。两者分工不同:systemd 不是 WSGI 服务器,Gunicorn 也不负责服务器开机时的服务编排。

创建 systemd 单元文件:

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

写入以下内容:

[Unit]
Description=Gunicorn service for Flask application
After=network.target

[Service]
Type=simple
User=flaskapp
Group=flaskapp
WorkingDirectory=/srv/flaskapp
Environment="PATH=/srv/flaskapp/.venv/bin"
ExecStart=/srv/flaskapp/.venv/bin/gunicorn --workers 2 --bind 127.0.0.1:8000 --access-logfile - --error-logfile - wsgi:app
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target

这里的 127.0.0.1 表示只接受服务器本机连接,适合由同机 Nginx 转发请求;不要为了方便改成 0.0.0.0 并直接暴露应用端口,除非已明确评估访问控制和部署架构。--workers 2 只是启动示例,不是适用于所有应用的固定值。工作进程数应结合 CPU、内存、应用耗时和并发情况评估;内存有限时,进程过多可能导致资源耗尽。

示例把 Gunicorn 的访问日志和错误日志输出到标准输出、标准错误,systemd 会将其收集到 journal。应用若还要读取密钥或数据库配置,可将环境变量放在权限受控的独立文件中,再通过 EnvironmentFile= 加载;不要把真实密钥写入公开代码或可被其他用户读取的文件。

验证配置语法并启动:

sudo systemd-analyze verify /etc/systemd/system/flaskapp.service
sudo systemctl daemon-reload
sudo systemctl enable --now flaskapp
sudo systemctl status flaskapp --no-pager

daemon-reload 让 systemd 重新读取新建的服务文件;enable 设置开机启动,--now 则立即启动服务。正常情况下,状态应显示 active (running)。如果 systemd-analyze verify 报错,先修正单元文件,不要跳过验证直接启动。

Flask 应用通过 Gunicorn 承载 WSGI 请求,持续运行也需要适配的服务器资源作为基础。A5数据提供香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,覆盖常规建站及 AMD 计算等配置,配有 SSD 或 NVMe 存储,并提供不同网络线路方案。无论是部署应用服务、承载业务后台,还是配合数据库运行,都可按访问地区、程序负载与数据需求选择相应资源。

验证请求与进程托管

先从服务器本机请求 Gunicorn。此测试不依赖域名、Nginx 或 HTTPS,可以把应用进程问题与入口配置问题分开判断。

curl -i http://127.0.0.1:8000/health

示例响应应包含 HTTP 200 和 JSON 内容,例如:

HTTP/1.1 200 OK
...
{"status":"ok"}

响应格式可能随 Flask 和 Gunicorn 版本略有差别;关键是状态码为 200,且内容符合应用预期。若连接被拒绝,检查服务是否启动、监听地址和端口是否一致;若返回 500,查看应用错误日志。

接着检查 systemd 管理状态、监听端口和进程关系:

sudo systemctl is-enabled flaskapp
sudo systemctl show flaskapp -p MainPID -p ActiveState -p SubState
sudo ss -ltnp | grep ':8000'
ps -eo pid,ppid,user,cmd | grep '[g]unicorn'

预期结果包括:

  • is-enabled 输出 enabled,表示已设置开机启动。
  • ActiveState=active、SubState=running,表示服务当前运行。
  • ss 显示 127.0.0.1:8000 正在监听,而不是意外监听到所有网卡。
  • Gunicorn 进程以 flaskapp 用户运行,且可看到主进程及其工作进程。

Gunicorn 有多个进程并不等于发生了重复托管:主进程会管理工作进程,属于正常结构。判断是否由 systemd 托管,应结合 systemctl status、MainPID 和进程父子关系检查,而不是只按进程数量判断。

验证请求与进程托管配图

再验证 systemd 能否控制服务:

sudo systemctl restart flaskapp
sudo systemctl status flaskapp --no-pager
curl -i http://127.0.0.1:8000/health

重启后服务应重新进入 active (running),健康检查仍返回 200。生产环境的重启可能造成短暂请求中断,应在可接受的时间窗口执行。

查看服务日志:

sudo journalctl -u flaskapp -n 50 --no-pager
sudo journalctl -u flaskapp -f

第一条查看最近日志,第二条持续跟踪日志,按 Ctrl+C 退出跟踪。重启服务器属于维护操作,会影响同机其他服务;不要为了验证开机启动而在业务高峰随意重启。可先确认开机启用状态,并在计划维护窗口完成重启后的检查。

需要对外提供访问时接入 Nginx

Gunicorn 绑定在回环地址时,外部用户不能直接访问 127.0.0.1:8000。常见做法是由 Nginx 在公网入口接收 HTTP/HTTPS 请求,再转发到本机 Gunicorn。以下仅为 HTTP 示例;正式启用 HTTPS 前,还需配置有效证书及续期流程。

在 Nginx 站点配置中,将域名替换为实际域名:

server {
    listen 80;
    server_name example.com;

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

保存配置后,先测试语法,再重载 Nginx:

sudo nginx -t
sudo systemctl reload nginx

验证:先在服务器上请求域名,并确认域名解析指向此服务器:

curl -i http://example.com/health

如果本机直连 Gunicorn 正常,但域名访问失败,问题更可能位于 Nginx 配置、域名解析或防火墙入口,而非 Flask 的 WSGI 导入。若 Nginx 与应用不在同一台服务器,127.0.0.1 指向的是 Nginx 所在机器,应改为受控的应用服务器地址,并相应配置网络访问限制。

常见异常及判断顺序

服务无法启动或很快退出

先查看 systemd 状态和错误日志:

sudo systemctl status flaskapp --no-pager
sudo journalctl -u flaskapp -n 100 --no-pager

常见原因包括虚拟环境路径错误、依赖未安装、WorkingDirectory 不正确、wsgi:app 与实际模块或对象名称不一致。日志中若出现 ModuleNotFoundError,检查依赖和导入路径;若出现权限错误,检查应用目录与文件属主,不要直接用 chmod -R 777 放宽权限。

服务运行,但本机请求失败

检查服务绑定地址、端口和监听状态:

sudo ss -ltnp | grep ':8000'

若没有监听,回到服务日志查启动错误;若监听端口不是 8000,核对 ExecStart 与测试地址;若监听在其他地址,确认是否修改过 --bind。不要只靠反复重启掩盖端口占用或配置错误。

Gunicorn 返回 500

查看最近的服务日志:

sudo journalctl -u flaskapp -n 100 --no-pager

500 通常表示请求已到达应用,但应用处理过程中发生异常。检查堆栈、环境变量、数据库连接和应用自身配置。不要向公网直接返回调试堆栈,也不要在生产环境启用 Flask 调试模式。

本机正常,域名访问失败

若 curl http://127.0.0.1:8000/health 返回正常,而域名请求失败,依次检查 Nginx 服务状态、nginx -t 结果、站点 server_name、域名解析和服务器入站规则。若 Nginx 返回 502 Bad Gateway,常见原因是 Gunicorn 未运行、上游地址或端口不匹配,或 Nginx 无法连接到上游。

回滚与验收检查

若新部署未通过验证,先保留日志和当前配置,再停止服务。回滚前确认操作范围仅涉及本应用,尤其不要覆盖其他服务正在使用的 Nginx 配置。

sudo systemctl stop flaskapp
sudo cp -a /etc/systemd/system/flaskapp.service /etc/systemd/system/flaskapp.service.failed

随后将应用代码恢复到已知可用版本;若修改过 Nginx 站点配置,也先备份当前文件,再恢复此前保存的版本。重新加载服务管理配置并启动旧版本:

sudo systemctl daemon-reload
sudo systemctl start flaskapp
sudo systemctl status flaskapp --no-pager
curl -i http://127.0.0.1:8000/health

确认旧版本服务正常后,再处理失败版本和备份文件;不要在未核对路径、文件用途及备份可用性的情况下执行递归删除。

上线验收时逐项确认:

  • flaskapp.service 已启用,状态为 active (running)。
  • Gunicorn 使用专用账号运行,绑定地址与预期一致。
  • 本机健康检查返回预期状态码和内容。
  • systemd 重启服务后,进程能够重新启动并继续响应请求。
  • 服务日志可通过 journalctl -u flaskapp 查看,且没有持续出现启动错误或应用异常。
  • 若已配置 Nginx,nginx -t 通过,域名请求能到达应用;HTTPS 证书与续期应另行验证。
  • 回滚所需的旧代码、服务配置及 Nginx 配置备份可用;回滚后再次完成状态和请求检查。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5873.html

相关推荐