Python的gunicorn服务器配置方式

更新时间：2025年07月29日 17:07:22 作者：Littlewith

Gunicorn是Python WSGI服务器,用于部署Flask/Django等框架,解决原生并发性能不足,常与Nginx搭配,支持配置参数及守护进程管理,推荐在Linux/WSL/Docker环境中使用,生产环境建议Nginx+Gunicorn+Supervisor组合

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 环境中部署

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

pandas如何实现两个dataframe相减
这篇文章主要介绍了pandas如何实现两个dataframe相减方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-02-02
基于Keras中Conv1D和Conv2D的区别说明
这篇文章主要介绍了基于Keras中Conv1D和Conv2D的区别说明，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-06-06
python实现会员信息管理系统(List)
这篇文章主要为大家详细介绍了python实现会员信息管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-03-03
Python使用execjs执行包含中文参数的JavaScript
爬虫的开发过程中,往往需要对JS进行模拟,简单或者通用的还可以在Python中模拟或者找到对应的第三方库,但是复杂的就可能不好实现了,下面这篇文章主要给大家介绍了关于Python使用execjs执行包含中文参数的JavaScript的相关资料,需要的朋友可以参考下
2022-03-03
matplotlib绘制甘特图的万能模板案例
matplotlib是常见的绘图库，本文主要介绍了matplotlib绘制甘特图的万能模板案例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-04-04
Django实现接口token检测的方法详解
这篇文章主要为大家详细介绍了如何使用Django实现接口token检测,文中的示例代码简洁易懂,感兴趣的小伙伴可以跟随小编一起学习一下
2025-03-03
Python OpenCV 使用滑动条来调整函数参数的方法
这篇文章主要介绍了Python OpenCV 使用滑动条来调整函数参数的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-07-07
Django 导出 Excel 代码的实例详解
本篇文章主要介绍了Django 导出 Excel 代码的实例详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-08-08
Python 多线程不加锁分块读取文件的方法
今天小编就为大家分享一篇Python 多线程不加锁分块读取文件的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-12-12
详解Python中time()方法的使用的教程
这篇文章主要介绍了详解Python中time()方法的使用的教程,是Python入门学习中的基础知识,需要的朋友可以参考下
2015-05-05