Gunicorn 配置详解

config

-c CONFIG, --config CONFIG
Gunicorn配置文件路径，路径形式的字符串格式，如：

gunicorn -c gunicorn.conf main:app

bind

-b ADDRESS, --bind ADDRESS
Gunicorn绑定服务器套接字，Host形式的字符串格式。Gunicorn可绑定多个套接字，如：

gunicorn -b 127.0.0.1:8000 -b [::1]:9000 manager:app

backlog

--backlog
未决连接的最大数量，即等待服务的客户的数量。必须是正整数，一般设定在64~2048的范围内，一般设置为2048，超过这个数字将导致客户端在尝试连接时错误

workers

-w INT, --workers INT
用于处理工作进程的数量，为正整数，默认为1。worker推荐的数量为当前的CPU个数*2 + 1。计算当前的CPU个数方法：

import multiprocessing
print multiprocessing.cpu_count()

worker_class

-k STRTING, --worker-class STRTING
使用寿命工作模式，默认为sync。可使用下面的常用的工作模式:

• sync
• eventlet: 需要下载eventlet >= 0.9.7
• gevent: 需要下载gevent >= 0.13
• tornado: 需要下载tornado >= 0.2
• gthread
• gaiohttp：需要python 3.4和aiohttp>=0.21.5
• uvicorn: 需要下载uvicorn(部署fastAPI时使用, 下面举个例子)

# 举个例子(fastAPI)
gunicorn example:app -w 4 -k uvicorn.workers.UvicornWorker

threads

--threads INT
处理请求的工作线程数，使用指定数量的线程运行每个worker。为正整数，默认为1。

worker_connections

--worker-connections INT
最大客户端并发数量，默认情况下这个值为1000。此设置将影响gevent和eventlet工作模式

max_requests

--max-requests INT
重新启动之前，工作将处理的最大请求数。默认值为0。

timeout

-t INT, --timeout INT
超过这么多秒后工作将被杀掉，并重新启动。一般设定为30秒

keepalive

--keep-alive INT
在keep-alive连接上等待请求的秒数，默认情况下值为2。一般设定在1~5秒之间。

limit_request_line

--limit-request-line INT
HTTP请求行的最大大小，此参数用于限制HTTP请求行的允许大小，默认情况下，这个值为4094。该值的范围为0~8190。此参数可以防止任何DDOS攻击

limit_request_fields

--limit-request-fields INT
限制HTTP请求中请求头字段的数量。此字段用于限制请求头字段的数量以防止DDOS攻击，与limit-request-field-size一起使用可以提高安全性。默认情况下，这个值为100，这个值不能超过32768

limit_request_field_size

--limit-request-field-size INT
限制HTTP请求中请求头的大小，默认情况下这个值为8190。值是一个整数或者0，当该值为0时，表示将对请求头大小不做限制

reload

--reload
代码更新时将重启工作，默认为False。此设置一般用于开发，每当应用程序发生更改时，都会导致工作重新启动。

reload_engine

--reload-engine STRTING
选择重载的引擎，支持的有三种：

• auto
• pull
• inotity：需要下载

check_config

--check-config
显示现在的配置，默认值为False，即显示。

preload_app

--preload
在工作进程被复制(派生)之前加载应用程序代码，默认为False。通过预加载应用程序，你可以节省RAM资源，并且加快服务器启动时间。

chdir

--chdir
加载应用程序之前将chdir目录指定到指定目录

daemon

--daemon
守护Gunicorn进程，默认False

raw_env

-e ENV, --env ENV
设置环境变量(key=value)，将变量传递给执行环境，如：

gunicorin -b 127.0.0.1:8000 -e abc=123 manager:app

在配置文件中写法：

raw_env=["abc=123"]

pidfile

-p FILE, --pid FILE
设置pid文件的文件名，如果不设置将不会创建pid文件

worker_tmp_dir

--worker-tmp-dir DIR
设置工作临时文件目录，如果不设置会采用默认值。

accesslog

--access-logfile FILE
要写入的访问日志目录

access_log_format

--access-logformat STRING
要写入的访问日志格式。如：

access_log_format = '%(h)s %(l)s %(u)s %(t)s'

常见格式说明：
| 识别码 | 说明 |
| —- | —- |
| h |远程地址 |
| l |“-“ |
| u |用户名 |
| t |时间 |
| r |状态行，如：GET /test HTTP/1.1 |
| m |请求方法 |
| U |没有查询字符串的URL |
| q |查询字符串 |
| H |协议 |
| s |状态码 |
| B |response长度 |
| b |response长度(CLF格式) |
| f |参考 |
| a |用户代理 |
| T |请求时间，单位为s |
| D |请求时间，单位为ms |
| p |进程id |
| {Header}i | 请求头 |
| {Header}o | 相应头 |
| {Variable}e | 环境变量 |

errorlog

--error-logfile FILE, --log-file FILE
要写入错误日志的文件目录。

loglevel

--log-level LEVEL
错误日志输出等级。

支持的级别名称为:

• debug
• info
• warning
• error
• critical

更多配置：http://docs.gunicorn.org/en/stable/settings.html#server-mechanics