使用 gunicorn 搭建一個高併發的 web 服務

歡迎關注本人公衆號【Python編程與實戰】瞭解更多

用過 Python web 框架的朋友都知道，Flask 自帶的 wsgi 性能低下，不支持高併發。只適合你開發調試的時候用，因此在線上通常都使用 Nginx + gunicorn 才能得到更強的性能和更高的安全性!

gunicorn 是一個 python Wsgi http server，只支持在 Unix 系統上運行，下面咱們來熟悉一下以 gunicorn 的配置與使用。

1、gunicorn 的安裝

注意 gunicorn 不能在 windows 環境下使用

pip install gunicorn

好比有如下一個 app 的 py 文件

from flask import Flask  
  
app = Flask(__name__)  

  
@app.route('/') 
def index():  
    return 'hello world!' 

if __name__ == '__main__':  
    app.run()   
複製代碼

那麼咱們在 flask 的項目的目錄下如何使用 gunicorn 來啓動呢? 命令以下：

gunicorn -w 4 -b 0.0.0.0:8000 app:app
複製代碼

其中： 第一個 app 指的是 app.py 文件； 第二個指的是 flask 應用的名字，app = Flask(name)

2、gunicorn 的參數詳解

經過 gunicorn -h 咱們能夠看到 gunicorn 有很是多的配置項，我將他們的參數配置項都列出來了，供你們參考：

-c CONFIG  : CONFIG,配置文件的路徑，經過配置文件啓動；生產環境使用；

-b ADDRESS : ADDRESS，ip加端口，綁定運行的主機；

-w INT,  --workers INT用於處理工做進程的數量，爲正整數，默認爲1；

-k STRTING, --worker-class STRTING要使用的工做模式，默認爲sync異步，能夠下載eventlet和gevent並指定
--threads INT：處理請求的工做線程數，使用指定數量的線程運行每一個worker。爲正整數，默認爲1。

--worker-connections INT：最大客戶端併發數量，默認狀況下這個值爲1000。

--backlog int：未決鏈接的最大數量，即等待服務的客戶的數量。默認2048個，通常不修改；

-p FILE, --pid FILE：設置pid文件的文件名，若是不設置將不會建立pid文件

--access-logfile FILE  ： 要寫入的訪問日誌目錄

--access-logformat STRING：要寫入的訪問日誌格式

--error-logfile FILE, --log-file FILE ：  要寫入錯誤日誌的文件目錄。

--log-level LEVEL  ：  錯誤日誌輸出等級。

--limit-request-line INT ： HTTP請求頭的行數的最大大小，此參數用於限制HTTP請求行的容許大小，默認狀況下，這個值爲4094。值是0~8190的數字。

--limit-request-fields INT ： 限制HTTP請求中請求頭字段的數量。此字段用於限制請求頭字段的數量以防止DDOS攻擊，默認狀況下，這個值爲100，這個值不能超過32768

--limit-request-field-size INT ： 限制HTTP請求中請求頭的大小，默認狀況下這個值爲8190字節。值是一個整數或者0，當該值爲0時，表示將對請求頭大小不作限制

-t INT, --timeout INT：超過這麼多秒後工做將被殺掉，並從新啓動。通常設定爲30秒；

--daemon：是否以守護進程啓動，默認false；

--chdir ：在加載應用程序以前切換目錄；

--graceful-timeout INT：默認狀況下，這個值爲30，在超時(從接收到重啓信號開始)以後仍然活着的工做將被強行殺死；通常使用默認；

--keep-alive INT：在keep-alive鏈接上等待請求的秒數，默認狀況下值爲2。通常設定在1~5秒之間。

--reload：默認爲False。此設置用於開發，每當應用程序發生更改時，都會致使工做從新啓動。

--spew：打印服務器執行過的每一條語句，默認False。此選擇爲原子性的，即要麼所有打印，要麼所有不打印；

--check-config  ：顯示如今的配置，默認值爲False，即顯示。

-e ENV,  --env ENV： 設置環境變量；
複製代碼

是否是以爲gunicorn 的參數不少？在部署的時候輸入這麼大一串命令，就算是對參數很熟悉的人，也有可能會輸錯！那麼，有沒有更方便的方法呢？固然，那就是用以配置文件的方式啓動！

3、以配置文件的方式啓動

配置文件的方式啓動，通常這個配置文件名是 gunicorn.conf.py。 代碼以下:

# 並行工做進程數
workers = 4

# 指定每一個工做者的線程數
threads = 2

# 端口 5000
bind = '0.0.0.0:5000'

# 設置守護進程,將進程交給supervisor管理
daemon = 'false'

# 工做模式協程
worker_class = 'gevent'

# 設置最大併發量
worker_connections = 2000

# 設置進程文件目錄
pidfile = '/var/run/gunicorn.pid'

# 設置訪問日誌和錯誤信息日誌路徑
accesslog = "log/access.log"
errorlog = "log/debug.log"
loglevel = "debug"

# 設置日誌記錄水平
loglevel = 'warning'
複製代碼

代碼裏面的註釋都很詳細了，可是仍是有幾點須要說明的：

1.日誌

配置文件中指定了日誌文件的輸出目錄，須要注意的是：

• 須要log目錄存在，若是不存在，啓動會報錯
• accesslog 是訪問日誌，能夠經過 access_log_format 設置訪問日誌格式
• loglevel 用於控制 errorlog 的信息級別

不過更建議使用 logging 模塊來管理日誌

2. workers

• worker_class 是指開啓的每一個工做進程的模式類型，默認爲 sync 模式，這個使用 gevent 模式，gevent 是 python 的一個高併發庫
• workers 是並行工做進程數 ，在上述配置文件中，取的是服務器的 CPU 的數量。須要注意的是，這個數字不是越大越好，由於咱們還要注意部署機器的性能，不能無限制多開。通常是根據服務器的 CPU核心數來肯定的！

workers = multiprocessing * cpu_count() * 2 + 1
複製代碼

配置文件搞定以後，啓動命令就很簡單了。啓動 gunicorn 命令以下

gunicorn -c gunicorn.conf app:app
複製代碼

感謝您的關注！