Linux服务器部署Flask应用时,如何配置WSGI服务并验证进程托管?
在 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



