2026年5月31日 · Web 服务器 · 2分钟阅读

Gunicorn 本地 Python Web 开发指南

使用 Gunicorn 在 localhost 运行 Django、Flask 等 Python WSGI 应用，默认绑定 127.0.0.1:8000。

Gunicorn（Green Unicorn）是 Python WSGI HTTP 服务器，生产环境常配合 Nginx 使用。本地开发 Django、Flask 时可直接用 Gunicorn 模拟生产部署。

默认 localhost 访问

用途	地址
默认绑定	http://127.0.0.1:8000
localhost 等价	http://localhost:8000

默认监听 8000 端口，仅本机可访问（127.0.0.1）。

pip install gunicorn

Flask 示例

gunicorn -w 4 -b 127.0.0.1:8000 app:app

Django 示例

gunicorn myproject.wsgi:application -b localhost:8000

-w 4 表示 4 个 worker 进程。

日常开发 Django/Flask 更常用内置服务器：

python manage.py runserver    # Django → http://localhost:8000
flask run                     # Flask → http://localhost:5000

Gunicorn 适合上线前本地压测或与 Nginx 联调。

gunicorn -b 0.0.0.0:8080 app:app

局域网可访问；本机仍用 **http://localhost:8080**。

ModuleNotFoundError
确认虚拟环境已激活，且 app:app 模块路径正确。

Address already in use
更换 -b 端口或结束占用 8000 的进程。

Gunicorn 本地默认 **http://localhost:8000**，用于 Python WSGI 应用的生产级本地运行。