那些比你走得远的人,并不比你聪慧,只是每天多走了一点。坚持,是最强大的力量。

Gunicorn参数说明

一、前言

gunicorn是目前使用最广泛的高性能的Python WSGI(WEB Server Gateway interface)服务器,移植自Ruby的Unicorn项目,使用pre-fork worker模式,具有简单、易用、轻量级、低资源消耗和高性能等特点。

二、参数说明

2.1 启动参数说明

配置 说明
-c CONFIG, --config=CONFIG 指定配置文件
-b BIND, --bind=BIND 绑定运行的主机加端口
-w INT, --workers INT 用于处理工作进程的数量,整数,默认为1
-k STRTING, --worker-class STRTING 要使用的工作模式,默认为sync异步,类型:sync, eventlet, gevent, tornado, gthread, gaiohttp
--threads INT 处理请求的工作线程数,使用指定数量的线程运行每个worker。为正整数,默认为1
--worker-connections INT 最大客户端并发数量,默认1000
--backlog int 等待连接的最大数,默认2048
-p FILE, --pid FILE 设置pid文件的文件名,如果不设置将不会创建pid文件
--access-logfile FILE 日志文件路径
--access-logformat STRING 日志格式,--access_log_format '%(h)s %(l)s %(u)s %(t)s'
--error-logfile FILE, --log-file FILE 错误日志文件路径
--log-level LEVEL 日志输出等级
--limit-request-line INT 限制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时,表示将对请求头大小不做限制
-t INT, --timeout INT 超过设置后工作将被杀掉并重新启动,默认30s,nginx默认60s
--reload 在代码改变时自动重启,默认False
--daemon 是否以守护进程启动,默认False
--chdir 在加载应用程序之前切换目录
--graceful-timeout INT 默认30,在超时(从接收到重启信号开始)之后仍然活着的工作将被强行杀死;一般默认
--keep-alive INT 在keep-alive连接上等待请求的秒数,默认情况下值为2。一般设定在1~5秒之间
--spew 打印服务器执行过的每一条语句,默认False。此选择为原子性的,即要么全部打印,要么全部不打印
--check-config 显示当前的配置,默认False,即显示
-e ENV, --env ENV 设置环境变量

2.2 配置文件示例

-c CONFIG, --config=CONFIG

配置文件方式
vim gunicorn.conf

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 并行进程数
workers = 4

# 指定每个工作的线程数
threads = 2

# 监听端口8000
bind = '127.0.0.1:8000'

# 守护进程,将进程交给supervisor管理
daemon = 'false'

# 工作模式协程
worker_class = 'gevent'

# 最大并发量
worker_connections = 2000

# 进程文件
pidfile = '/var/run/gunicorn.pid'

# 访问日志和错误日志
accesslog = '/var/log/gunicorn_acess.log'
errorlog = '/var/log/gunicorn_error.log'

# 日志级别
loglevel = 'debug'

启动

1
gunicorn -c gunicorn.conf app:app

2.3 日志格式说明

--access-logformat

识别码 说明
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 环境变量

2.3.1 获取客户端真实IP

Nginx代理配置
1
2
3
4
proxy_set_header  Host              $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://127.0.0.1:8080;
logformat
1
%(h)s %(l)s %(u)s %(t)s "%(r)s" %(s)s %(b)s "%(f)s" "%(a)s" "%({X-Real-IP}i)s"

通过配置环境变量”X-Real-IP”获取客户端IP