gunicorn配置详解

Gunicorn是基于unix系统,被广泛应用的高性能的Python WSGI HTTP Server。用来解析HTTP请求的网关服务。
它通常是在进行反向代理(如nginx),或者进行负载均衡(如 AWS ELB)和一个web 应用(比如 Django 或者 Flask)之间。
它的运行模型基于pre-fork worker 模型,即就是支持eventlet,也支持greenlet

我们先来看看gunicorn支持哪些参数

01.
-c CONFIG:CONFIG,配置文件的路径,通过配置文件启动;生产环境使用;
02.
-b ADDRESS:ADDRESS,ip加端口,绑定运行的主机;
03.
-w INT, --workers INT:用于处理工作进程的数量,为正整数,默认为1;
04.
-k STRTING, --worker-class STRTING:要使用的工作模式,默认为sync异步,可以下载eventlet和gevent并指定
05.
--threads INT:处理请求的工作线程数,使用指定数量的线程运行每个worker。为正整数,默认为1。
06.
--worker-connections INT:最大客户端并发数量,默认情况下这个值为1000。
07.
--backlog int:未决连接的最大数量,即等待服务的客户的数量。默认2048个,一般不修改;
08.
-p FILE, --pid FILE:设置pid文件的文件名,如果不设置将不会创建pid文件
09.
--access-logfile FILE:要写入的访问日志目录
10.
--access-logformat STRING:要写入的访问日志格式
11.
--error-logfile FILE, --log-file FILE:要写入错误日志的文件目录。
12.
--log-level LEVEL:错误日志输出等级。
13.
--limit-request-line INT:HTTP请求头的行数的最大大小,此参数用于限制HTTP请求行的允许大小,默认情况下,这个值为4094。值是0~8190的数字。
14.
--limit-request-fields INT:限制HTTP请求中请求头字段的数量。此字段用于限制请求头字段的数量以防止DDOS攻击,默认情况下,这个值为100,这个值不能超过32768
15.
--limit-request-field-size INT:限制HTTP请求中请求头的大小,默认情况下这个值为8190字节。值是一个整数或者0,当该值为0时,表示将对请求头大小不做限制
16.
-t INT, --timeout INT:超过这么多秒后工作将被杀掉,并重新启动。一般设定为30秒;
17.
--daemon:是否以守护进程启动,默认false;
18.
--chdir:在加载应用程序之前切换目录;
19.
--graceful-timeout INT:默认情况下,这个值为30,在超时(从接收到重启信号开始)之后仍然活着的工作将被强行杀死;一般使用默认;
20.
--keep-alive INT:在keep-alive连接上等待请求的秒数,默认情况下值为2。一般设定在1~5秒之间。
21.
--reload:默认为False。此设置用于开发,每当应用程序发生更改时,都会导致工作重新启动。
22.
--spew:打印服务器执行过的每一条语句,默认False。此选择为原子性的,即要么全部打印,要么全部不打印;
23.
--check-config:显示现在的配置,默认值为False,即显示;
24.
-e ENV, --env ENV:设置环境变量;

我们通常使用这类方式来启动flask写好的web程序

01.
gunicorn -w 4 -b 0.0.0.0:9090 manager:app

同时gunicorn也支持从文件读取配置,这种就是在配置比较复杂的情况下使用

gunicorn.conf

01.
# gunicorn.conf
02.
# coding:utf-8
03.
import multiprocessing
04.
# 并行工作进程数, int,cpu数量*2+1 推荐进程数
05.
workers = multiprocessing.cpu_count() * 2 + 1  
06.
# 指定每个进程开启的线程数
07.
threads = 4 
08.
# 绑定的ip与端口
09.
bind = '0.0.0.0:9090' 
10.
# 设置守护进程,将进程交给supervisor管理
11.
daemon = 'false'
12.
# 工作模式协程,默认的是sync模式
13.
worker_class = 'gevent'
14.
# 设置最大并发量(每个worker处理请求的工作线程数,正整数,默认为1)
15.
worker_connections = 2000
16.
# 最大客户端并发数量,默认情况下这个值为1000。此设置将影响gevent和eventlet工作模式
17.
max_requests = 2000
18.
# 设置进程文件目录
19.
pidfile = './gunicorn.pid'
20.
# 设置访问日志和错误信息日志路径
21.
accesslog = './gunicorn_acess.log'
22.
errorlog = './gunicorn_error.log'
23.
# 日志级别,这个日志级别指的是错误日志的级别,而访问日志的级别无法设置
24.
loglevel = 'info' 
25.
# 设置gunicorn访问日志格式,错误日志无法设置
26.
access_log_format = '%(t)s %(p)s %(h)s "%(r)s" %(s)s %(L)s %(b)s %(f)s" "%(a)s"'
27.
# 监听队列
28.
backlog = 512                
29.
#进程名
30.
proc_name = 'gunicorn_process'   
31.
# 设置超时时间120s,默认为30s。按自己的需求进行设置timeout = 120
32.
timeout = 120      
33.
# 超时重启
34.
graceful_timeout = 300
35.
# 在keep-alive连接上等待请求的秒数,默认情况下值为2。一般设定在1~5秒之间。
36.
keepalive = 3
37.
# HTTP请求行的最大大小,此参数用于限制HTTP请求行的允许大小,默认情况下,这个值为4094。
38.
# 值是0~8190的数字。此参数可以防止任何DDOS攻击
39.
limit_request_line = 5120
40.
# 限制HTTP请求中请求头字段的数量。
41.
#  此字段用于限制请求头字段的数量以防止DDOS攻击,与limit-request-field-size一起使用可以提高安全性。
42.
# 默认情况下,这个值为100,这个值不能超过32768
43.
limit_request_fields = 101
44.
# 限制HTTP请求中请求头的大小,默认情况下这个值为8190。
45.
# 值是一个整数或者0,当该值为0时,表示将对请求头大小不做限制
46.
limit_request_field_size = 8190
47.
# 设置gunicorn使用的python环境
48.
pythonpath='/usr/bin/python3'

启动方式如下

01.
gunicorn -c gunicorn.conf test:app

gunicorn的配置文件必须为一个python文件,只是将命令行中的参数写进py文件中而已,如果需要设置哪个参数,则在py文件中为该参数赋值即可

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://sulao.cn/post/319

评论列表