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
# 并行进程数
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'
启动
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代理配置
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
%(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