Python的gunicorn服务器配置

Gunicorn 指南

什么是 Gunicorn？

Gunicorn（Green Unicorn）是一个兼容 WSGI 协议的 Python Web 服务器，广泛用于部署如 Flask、Django 等 Python Web 框架。其核心功能包括：

• 启动 Web 服务
• 管理多个工作进程
• 解决 Python 原生并发性能不足问题
• 常与 Nginx 组合部署，形成 Nginx + Gunicorn 的架构

安装 Gunicorn

pip install gunicorn
gunicorn -h  # 查看帮助

使用 Gunicorn 启动 Flask 应用

1. 创建一个最基本的 Flask 应用

# app.py
from flask import Flask      

def create_app():       
    app = Flask(__name__)       
    return app   

app = create_app()      

@app.route('/')   
def index():       
    return 'hello world!'   

if __name__ == '__main__':       
    app.run()    

2. 使用 Gunicorn 启动服务

在项目根目录下运行：

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

说明：

• 第一个 app 是文件名 app.py
• 第二个 app 是 Flask 实例名 app

Gunicorn 常用参数详解

参数	说明
-c CONFIG	使用配置文件（适合生产环境）
-b ADDRESS	绑定的地址与端口，例如 0.0.0.0:8000
-w, --workers	工作进程数，正整数，默认 1
-k, --worker-class	工作模式，如 sync（默认）、gevent、eventlet
--threads	每个 worker 的线程数，默认 1
--worker-connections	最大客户端并发数，默认 1000
--backlog	待处理连接队列最大长度，默认 2048
-p, --pid	设置 PID 文件路径
--access-logfile	访问日志路径
--access-logformat	日志格式
--error-logfile / --log-file	错误日志路径
--log-level	日志等级，默认 info，可设为 debug/warning/error
--limit-request-line	请求行最大长度（默认 4094）
--limit-request-fields	请求头最大字段数（默认 100）
--limit-request-field-size	请求头字段最大字节数（默认 8190）
-t, --timeout	请求超时时间，单位秒，默认 30 秒
--daemon	是否以守护进程运行，默认 False
--chdir	切换工作目录
--graceful-timeout	优雅退出时间，默认 30 秒
--keep-alive	Keep-alive 连接等待时间，默认 2 秒
--reload	开发模式：代码变更时自动重载
--spew	打印服务器执行的所有语句
--check-config	显示当前配置
-e, --env	设置环境变量

使用配置文件启动 Gunicorn

示例配置文件：gunicorn.conf.py

# 并行工作进程数 
workers = 4 

# 每个工作进程线程数 
threads = 2 

# 监听内网端口 
bind = '127.0.0.1:5000' 

# 是否以守护进程运行 
daemon = 'false' 

# 工作模式 
worker_class = 'gevent' 

# 最大并发连接数 
worker_connections = 2000 

# PID 文件路径 
pidfile = '/var/run/gunicorn.pid' 

# 日志路径 
accesslog = '/var/log/gunicorn_access.log' 
errorlog = '/var/log/gunicorn_error.log' 

# 日志级别 
loglevel = 'warning' 

启动命令

gunicorn -c gunicorn.conf.py app:app

注意事项

• Gunicorn 不支持 Windows 平台
  在 Windows 下运行可能出现以下错误：

  ImportError: No module named _curses / fcntl
  

  解决方法：
  • 尝试自行下载缺失模块（如 fcntl.py）
  • 推荐在 Linux、WSL 或 Docker 环境中部署

推荐部署组合

生产环境中推荐以下组合：

• Nginx + Gunicorn + Flask/Django
  • Nginx：作为前端反向代理和静态资源服务
  • Gunicorn：处理 Python 后端应用
  • Supervisor：管理 Gunicorn 的守护进程运行