一、什么是 Gunicorn？

Gunicorn是一個(gè)純Python的WSGI HTTP服務(wù)器，用于運(yùn)行Python Web應(yīng)用程序。它簡(jiǎn)單易用，性能良好，是部署Flask、Django等WSGI兼容應(yīng)用的流行選擇。

WSGI是 Python 定義的一個(gè)標(biāo)準(zhǔn)接口，用于規(guī)范 Web 服務(wù)器（如 Nginx、Apache）與 Python Web 應(yīng)用（如 Flask、Django）之間的通信方式。

它的核心作用是讓不同的 Web 服務(wù)器和 Python Web 框架能夠無(wú)縫協(xié)作。

二、為什么需要Gunicorn？

開(kāi)發(fā)服務(wù)器（如Flask內(nèi)置的app.run()）雖然方便，但有嚴(yán)重限制。

三、安裝Gunicorn

pip install gunicorn

四、基本使用

啟動(dòng)最簡(jiǎn)單的Gunicorn服務(wù)器

假設(shè)你的Flask應(yīng)用主文件是app.py，其中包含一個(gè)名為app的Flask實(shí)例：

gunicorn -w 4 -b 127.0.0.1:8000 app:app

參數(shù)說(shuō)明

• -w 4: 使用4個(gè)worker進(jìn)程
• -b 127.0.0.1:8000: 綁定到127.0.0.1的8000端口
• app:app: 第一個(gè)app是模塊名（app.py），第二個(gè)app是Flask實(shí)例名

app = Flask(__name__)  # 這個(gè)變量名`app`就是第二個(gè)`app`所指的對(duì)象

如果你的文件是myapp.py且實(shí)例變量名為application，則命令應(yīng)為：

gunicorn -w 4 -b 127.0.0.1:8000 myapp:application

常用命令行參數(shù)

五、Worker類型

Gunicorn支持多種worker類型，適用于不同場(chǎng)景：

• sync (默認(rèn)): 同步worker，每個(gè)請(qǐng)求一個(gè)進(jìn)程，適合CPU密集型任務(wù)
• gevent: 基于協(xié)程的異步worker，適合IO密集型應(yīng)用
• eventlet: 類似gevent的異步worker
• tornado: 使用Tornado框架的異步worker
• gthread: 使用線程的worker，需要關(guān)注線程安全問(wèn)題

選擇建議

• CPU密集型: sync或增加worker數(shù)量
• IO密集型: gevent或eventlet

gunicorn -k gevent -w 4 app:app

• Worker 之間相互隔離，一個(gè) Worker 崩潰不會(huì)直接影響其他 Worker（主進(jìn)程會(huì)重啟崩潰的 Worker）。
• Gunicorn 的主進(jìn)程（Master）負(fù)責(zé)監(jiān)聽(tīng)端口、管理 Worker，并將請(qǐng)求輪詢分配給空閑的 Worker。
• Worker 是實(shí)際干活的進(jìn)程，數(shù)量（-w）和類型（-k）直接影響并發(fā)能力。

六、配置文件

對(duì)于更復(fù)雜的配置，可以使用配置文件（通常命名為gunicorn.conf.py）：

# gunicorn.conf.py

bind = "0.0.0.0:8000"
workers = 4
worker_class = "gevent"
timeout = 120
accesslog = "-"  # 輸出到stdout
errorlog = "-"   # 輸出到stdout

然后使用配置文件啟動(dòng)：

gunicorn -c gunicorn.conf.py app:app

七、與Flask結(jié)合實(shí)踐

1. 項(xiàng)目結(jié)構(gòu)建議

myapp/
├── app/              # 應(yīng)用包
│   ├── __init__.py   # 創(chuàng)建app實(shí)例
│   ├── views.py      # 路由和視圖
│   └── ...
├── gunicorn.conf.py  # Gunicorn配置
└── wsgi.py           # WSGI入口點(diǎn)

2. 創(chuàng)建WSGI入口文件

wsgi.py內(nèi)容：

from app import create_app  # 假設(shè)你的app工廠函數(shù)名為create_app

app = create_app()

if __name__ == "__main__":
    app.run()

3. 使用Gunicorn啟動(dòng)

gunicorn -c gunicorn.conf.py wsgi:app

八、性能調(diào)優(yōu)

Worker數(shù)量計(jì)算

經(jīng)驗(yàn)公式：

workers = (2 * CPU核心數(shù)) + 1

內(nèi)存考慮

每個(gè)worker都會(huì)加載完整的Python應(yīng)用，確保服務(wù)器有足夠內(nèi)存：

總內(nèi)存 ≈ (worker數(shù)量 × 單個(gè)worker內(nèi)存) + 系統(tǒng)開(kāi)銷

超時(shí)設(shè)置

根據(jù)應(yīng)用響應(yīng)時(shí)間調(diào)整：

timeout = 120  # 秒

九、日志配置

訪問(wèn)日志

accesslog = "/var/log/gunicorn/access.log"
access_log_format = '%(h)s %(l)s %(u)s %(t)s "%(r)s" %(s)s %(b)s "%(f)s" "%(a)s"'

錯(cuò)誤日志

errorlog = "/var/log/gunicorn/error.log"
loglevel = "info"
capture_output = True  # 捕獲stdout/stderr

十、常見(jiàn)問(wèn)題解決

Worker超時(shí)

錯(cuò)誤信息:

[CRITICAL] WORKER TIMEOUT

解決方案:

• 增加timeout值
• 優(yōu)化應(yīng)用性能
• 考慮使用異步worker

內(nèi)存泄漏

現(xiàn)象：內(nèi)存使用持續(xù)增長(zhǎng)

解決方案：

• 定期重啟worker
• 使用max_requests和max_requests_jitter參數(shù)

502 Bad Gateway

可能原因：

• Gunicorn未運(yùn)行
• Nginx配置錯(cuò)誤
• 端口不匹配

檢查步驟：

• 確認(rèn)Gunicorn是否運(yùn)行：ps aux | grep gunicorn
• 檢查Nginx錯(cuò)誤日志：/var/log/nginx/error.log
• 確認(rèn)端口配置一致

十一、高級(jí)特性

• 熱重載

開(kāi)發(fā)時(shí)自動(dòng)重載代碼變化，但生產(chǎn)環(huán)境中不建議使用這個(gè)功能，因?yàn)樗鼤?huì)影響性能。

gunicorn --reload app:app

十二、監(jiān)控與維護(hù)

• 查看運(yùn)行狀態(tài)

pstree -ap | grep gunicorn

• 優(yōu)雅重啟

kill -HUP <master_pid>

• 優(yōu)雅停止

kill -TERM <master_pid>

十三、生產(chǎn)環(huán)境建議

• 不要使用root運(yùn)行：創(chuàng)建專用用戶
• 使用進(jìn)程管理器：如systemd或supervisor
• 配置日志輪轉(zhuǎn)：使用logrotate
• 設(shè)置資源限制：防止內(nèi)存泄漏影響系統(tǒng)

十四、總結(jié)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。