在之前的文章中有记录WSGI容器的作用,以及我们知道常见的容器就只有的uWSGI和Gunicorn,在之前的文章中有记录他们的特性及优缺点,在这就不在多做描述。接下来将着重记录一下Gunicorn的一些配置:
-c CONFIG, --config CONFIG
Gunicorn配置文件路径,路径形式的字符串格式,如:
gunicorn -c gunicorn.conf manager:app
-b ADDRESS, --bind ADDRESS
Gunicorn绑定服务器套接字,Host形式的字符串格式。Gunicorn可绑定多个套接字,如:
gunicorn -b 127.0.0.1:8000 -b [::1]:9000 manager:app
--backlog
未决连接的最大数量,即等待服务的客户的数量。必须是正整数,一般设定在64~2048的范围内,一般设置为2048,超过这个数字将导致客户端在尝试连接时错误
-w INT, --workers INT
用于处理工作进程的数量,为正整数,默认为1。worker
推荐的数量为当前的CPU个数*2 + 1。计算当前的CPU个数方法:
import multiprocessing
print multiprocessing.cpu_count()
-k STRTING, --worker-class STRTING
要使用的工作模式,默认为sync
。可引用以下常见类型“字符串”作为捆绑类:
--threads INT
处理请求的工作线程数,使用指定数量的线程运行每个worker。为正整数,默认为1。
--worker-connections INT
最大客户端并发数量,默认情况下这个值为1000。此设置将影响gevent
和eventlet
工作模式
--max-requests INT
重新启动之前,工作将处理的最大请求数。默认值为0。
--max-requests-jitter INT
要添加到max_requests
的最大抖动。抖动将导致每个工作的重启被随机化,这是为了避免所有工作被重启。randint(0,max-requests-jitter)
-t INT, --timeout INT
超过这么多秒后工作将被杀掉,并重新启动。一般设定为30秒
--graceful-timeout INT
优雅的人工超时时间,默认情况下,这个值为30。收到重启信号后,工作人员有那么多时间来完成服务请求。在超时(从接收到重启信号开始)之后仍然活着的工作将被强行杀死。
--keep-alive INT
在keep-alive
连接上等待请求的秒数,默认情况下值为2。一般设定在1~5秒之间。
--limit-request-line INT
HTTP请求行的最大大小,此参数用于限制HTTP请求行的允许大小,默认情况下,这个值为4094。值是0~8190的数字。此参数可以防止任何DDOS攻击
--limit-request-fields INT
限制HTTP请求中请求头字段的数量。此字段用于限制请求头字段的数量以防止DDOS攻击,与limit-request-field-size
一起使用可以提高安全性。默认情况下,这个值为100,这个值不能超过32768
--limit-request-field-size INT
限制HTTP请求中请求头的大小,默认情况下这个值为8190。值是一个整数或者0,当该值为0时,表示将对请求头大小不做限制
--reload
代码更新时将重启工作,默认为False。此设置用于开发,每当应用程序发生更改时,都会导致工作重新启动。
--reload-engine STRTING
选择重载的引擎,支持的有三种:
--spew
打印服务器执行过的每一条语句,默认False。此选择为原子性的,即要么全部打印,要么全部不打印
--check-config
显示现在的配置,默认值为False,即显示。
--preload
在工作进程被复制(派生)之前加载应用程序代码,默认为False。通过预加载应用程序,你可以节省RAM资源,并且加快服务器启动时间。
--chdir
加载应用程序之前将chdir
目录指定到指定目录
--daemon
守护Gunicorn进程,默认False
-e ENV, --env ENV
设置环境变量(key=value),将变量传递给执行环境,如:
gunicorin -b 127.0.0.1:8000 -e abc=123 manager:app
在配置文件中写法:
raw_env=["abc=123"]
-p FILE, --pid FILE
设置pid文件的文件名,如果不设置将不会创建pid文件
--worker-tmp-dir DIR
设置工作临时文件目录,如果不设置会采用默认值。
--access-logfile FILE
要写入的访问日志目录
--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 | 环境变量 |
--error-logfile FILE, --log-file FILE
要写入错误日志的文件目录。
--log-level LEVEL
错误日志输出等级。
支持的级别名称为:
更多配置:http://docs.gunicorn.org/en/stable/settings.html#server-mechanics