Python Gunicorn 介绍

发布时间: 更新时间: 总字数:871 阅读时间:2m 作者: IP上海 分享 网址

Gunicorn(Green Unicorn) 是一个 UNIX 环境下的 Python WSGI HTTP Server。它是从 RubyUnicorn 项目移植的 pre-fork worker 模型。Gunicorn 服务器与众多 Web 框架广泛兼容,它具有实现简单、轻量级、响应速度快等特点。


pip install gunicorn


gunicorn --help
usage: gunicorn [OPTIONS] [APP_MODULE]

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  --proxy-protocol      Enable detect PROXY protocol (PROXY mode). [False]
  --worker-connections INT
                        The maximum number of simultaneous clients. [1000]
  --access-logfile FILE
                        The Access log file to write to. [None]
                        Disable redirect access logs to syslog. [False]
  --statsd-host STATSD_ADDR
                        ``host:port`` of the statsd server to log to. [None]
  --max-requests-jitter INT
                        The maximum jitter to add to the *max_requests*
                        setting. [0]
  --error-logfile FILE, --log-file FILE
                        The Error log file to write to. [-]
  -R, --enable-stdio-inheritance
                        Enable stdio inheritance. [False]
  -k STRING, --worker-class STRING
                        The type of workers to use. [sync]
  --ssl-version SSL_VERSION
                        SSL version to use (see stdlib ssl module's) [2]
                        Suppress ragged EOFs (see stdlib ssl module's) [True]
  --log-syslog-facility SYSLOG_FACILITY
                        Syslog facility name [user]
  --cert-reqs CERT_REQS
                        Whether client certificate is required (see stdlib ssl
                        module's) [0]
  --preload             Load application code before the worker processes are
                        forked. [False]
  --keep-alive INT      The number of seconds to wait for requests on a Keep-
                        Alive connection. [2]
  --no-sendfile         Disables the use of ``sendfile()``. [None]
  --reuse-port          Set the ``SO_REUSEPORT`` flag on the listening socket.
  -g GROUP, --group GROUP
                        Switch worker process to run as this group. [0]
  -m INT, --umask INT   A bit mask for the file mode on files written by
                        Gunicorn. [0]
  -w INT, --workers INT
                        The number of worker processes for handling requests.
  --graceful-timeout INT
                        Timeout for graceful workers restart. [30]
                        Whether to perform SSL handshake on socket connect
                        (see stdlib ssl module's) [False]
  --spew                Install a trace function that spews every line
                        executed by the server. [False]
  -n STRING, --name STRING
                        A base to use with setproctitle for process naming.
  --worker-tmp-dir DIR  A directory to use for the worker heartbeat temporary
                        file. [None]
                        Strip spaces present between the header name and the
                        the ``:``. [False]
  --limit-request-fields INT
                        Limit the number of HTTP headers fields in a request.
  --pythonpath STRING   A comma-separated list of directories to add to the
                        Python path. [None]
  --log-config FILE     The log config file to use. [None]
  --log-config-dict LOGCONFIG_DICT
                        The log config dictionary to use, using the standard
                        Python [{}]
  -c CONFIG, --config CONFIG
                        The Gunicorn config file. [None]
  -p FILE, --pid FILE   A filename to use for the PID file. [None]
  --check-config        Check the configuration. [False]
  --statsd-prefix STATSD_PREFIX
                        Prefix to use when emitting statsd metrics (a trailing
                        ``.`` is added, []
  --reload-engine STRING
                        The implementation that should be used to power
                        :ref:`reload`. [auto]
  --reload-extra-file FILES
                        Extends :ref:`reload` option to also watch and reload
                        on additional files [[]]
  -u USER, --user USER  Switch worker processes to run as this user. [0]
  --proxy-allow-from PROXY_ALLOW_IPS
                        Front-end's IPs from which allowed accept proxy
                        requests (comma separate). []
  --forwarded-allow-ips STRING
                        Front-end's IPs from which allowed to handle set
                        secure headers. []
  --chdir CHDIR         Chdir to specified directory before apps loading.
  -D, --daemon          Daemonize the Gunicorn process. [False]
  --paste STRING, --paster STRING
                        Load a PasteDeploy config file. The argument may
                        contain a ``#`` [None]
  --paste-global CONF   Set a PasteDeploy global config variable in
                        ``key=value`` form. [[]]
  --threads INT         The number of worker threads for handling requests.
  --max-requests INT    The maximum number of requests a worker will process
                        before restarting. [0]
  --limit-request-line INT
                        The maximum size of HTTP request line in bytes. [4094]
  --access-logformat STRING
                        The access log format. [%(h)s %(l)s %(u)s %(t)s
                        "%(r)s" %(s)s %(b)s "%(f)s" "%(a)s"]
  --certfile FILE       SSL certificate file [None]
  --log-level LEVEL     The granularity of Error log outputs. [info]
  --capture-output      Redirect stdout/stderr to specified file in
                        :ref:`errorlog`. [False]
  --log-syslog-to SYSLOG_ADDR
                        Address to send syslog messages. [udp://localhost:514]
  --log-syslog-prefix SYSLOG_PREFIX
                        Makes Gunicorn use the parameter as program-name in
                        the syslog entries. [None]
  --ciphers CIPHERS     Ciphers to use (see stdlib ssl module's) [TLSv1]
  --log-syslog          Send *Gunicorn* logs to syslog. [False]
  -b ADDRESS, --bind ADDRESS
                        The socket to bind. [['']]
  -e ENV, --env ENV     Set environment variable (key=value). [[]]
  --initgroups          If true, set the worker process's group access list
                        with all of the [False]
  --reload              Restart workers when code changes. [False]
  --limit-request-field_size INT
                        Limit the allowed size of an HTTP request header
                        field. [8190]
  -t INT, --timeout INT
                        Workers silent for more than this many seconds are
                        killed and restarted. [30]
  --keyfile FILE        SSL key file [None]
  --ca-certs FILE       CA certificates file [None]
  --backlog INT         The maximum number of pending connections. [2048]
  --logger-class STRING
                        The logger you want to use to log events in Gunicorn.



  • 一般和 supervisior 一起使用,前端通过 nginx 做前端。
  • gunicorn 多进程之间的 dict 不共享,可以使用 redis 或 memcache 实现共享
  • 优雅重启 kill -HUP <gunicorn-main-pid>


Home Archives Categories Tags Statistics
本文总阅读量 次 本站总访问量 次 本站总访客数