Python的gunicorn服務(wù)器配置方式
更新時間：2025年07月29日 17:07:22 作者：Littlewith
Gunicorn是Python WSGI服務(wù)器,用于部署Flask/Django等框架,解決原生并發(fā)性能不足,常與Nginx搭配,支持配置參數(shù)及守護進程管理,推薦在Linux/WSL/Docker環(huán)境中使用,生產(chǎn)環(huán)境建議Nginx+Gunicorn+Supervisor組合
Gunicorn 指南
什么是 Gunicorn？
Gunicorn（Green Unicorn）是一個兼容 WSGI 協(xié)議的 Python Web 服務(wù)器，廣泛用于部署如 Flask、Django 等 Python Web 框架。
其核心功能包括：
- 啟動 Web 服務(wù)
- 管理多個工作進程
- 解決 Python 原生并發(fā)性能不足問題
- 常與 Nginx 組合部署，形成 Nginx + Gunicorn 的架構(gòu)
安裝 Gunicorn
pip install gunicorn gunicorn -h # 查看幫助
使用 Gunicorn 啟動 Flask 應(yīng)用
1. 創(chuàng)建一個最基本的 Flask 應(yīng)用
# app.py
from flask import Flask
def create_app():
app = Flask(__name__)
return app
app = create_app()
@app.route('/')
def index():
return 'hello world!'
if __name__ == '__main__':
app.run()
2. 使用 Gunicorn 啟動服務(wù)
在項目根目錄下運行：
gunicorn -w 4 -b 0.0.0.0:8000 app:app
說明：
- 第一個
app是文件名app.py - 第二個
app是 Flask 實例名app
Gunicorn 常用參數(shù)詳解
| 參數(shù) | 說明 |
|---|---|
| -c CONFIG | 使用配置文件（適合生產(chǎn)環(huán)境） |
| -b ADDRESS | 綁定的地址與端口，例如 0.0.0.0:8000 |
| -w, --workers | 工作進程數(shù)，正整數(shù)，默認(rèn) 1 |
| -k, --worker-class | 工作模式，如 sync（默認(rèn)）、gevent、eventlet |
| --threads | 每個 worker 的線程數(shù)，默認(rèn) 1 |
| --worker-connections | 最大客戶端并發(fā)數(shù)，默認(rèn) 1000 |
| --backlog | 待處理連接隊列最大長度，默認(rèn) 2048 |
| -p, --pid | 設(shè)置 PID 文件路徑 |
| --access-logfile | 訪問日志路徑 |
| --access-logformat | 日志格式 |
| --error-logfile / --log-file | 錯誤日志路徑 |
| --log-level | 日志等級，默認(rèn) info，可設(shè)為 debug/warning/error |
| --limit-request-line | 請求行最大長度（默認(rèn) 4094） |
| --limit-request-fields | 請求頭最大字段數(shù)（默認(rèn) 100） |
| --limit-request-field-size | 請求頭字段最大字節(jié)數(shù)（默認(rèn) 8190） |
| -t, --timeout | 請求超時時間，單位秒，默認(rèn) 30 秒 |
| --daemon | 是否以守護進程運行，默認(rèn) False |
| --chdir | 切換工作目錄 |
| --graceful-timeout | 優(yōu)雅退出時間，默認(rèn) 30 秒 |
| --keep-alive | Keep-alive 連接等待時間，默認(rèn) 2 秒 |
| --reload | 開發(fā)模式：代碼變更時自動重載 |
| --spew | 打印服務(wù)器執(zhí)行的所有語句 |
| --check-config | 顯示當(dāng)前配置 |
| -e, --env | 設(shè)置環(huán)境變量 |
使用配置文件啟動 Gunicorn
- 示例配置文件：gunicorn.conf.py
# 并行工作進程數(shù) workers = 4 # 每個工作進程線程數(shù) threads = 2 # 監(jiān)聽內(nèi)網(wǎng)端口 bind = '127.0.0.1:5000' # 是否以守護進程運行 daemon = 'false' # 工作模式 worker_class = 'gevent' # 最大并發(fā)連接數(shù) worker_connections = 2000 # PID 文件路徑 pidfile = '/var/run/gunicorn.pid' # 日志路徑 accesslog = '/var/log/gunicorn_access.log' errorlog = '/var/log/gunicorn_error.log' # 日志級別 loglevel = 'warning'
- 啟動命令
gunicorn -c gunicorn.conf.py app:app
注意事項
Gunicorn 不支持 Windows 平臺
- 在 Windows 下運行可能出現(xiàn)以下錯誤：
ImportError: No module named _curses / fcntl
解決方法：
- 嘗試自行下載缺失模塊（如
fcntl.py） - 推薦在 Linux、WSL 或 Docker 環(huán)境中部署
推薦部署組合
生產(chǎn)環(huán)境中推薦以下組合：
Nginx + Gunicorn + Flask/Django
Nginx：作為前端反向代理和靜態(tài)資源服務(wù)Gunicorn：處理 Python 后端應(yīng)用Supervisor：管理 Gunicorn 的守護進程運行
總結(jié)
以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關(guān)文章
這篇文章主要介紹了pandas如何實現(xiàn)兩個dataframe相減方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-02-02
基于Keras中Conv1D和Conv2D的區(qū)別說明
這篇文章主要介紹了基于Keras中Conv1D和Conv2D的區(qū)別說明，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-06-06
python實現(xiàn)會員信息管理系統(tǒng)(List)
這篇文章主要為大家詳細介紹了python實現(xiàn)會員信息管理系統(tǒng)，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-03-03
Python使用execjs執(zhí)行包含中文參數(shù)的JavaScript
爬蟲的開發(fā)過程中,往往需要對JS進行模擬,簡單或者通用的還可以在Python中模擬或者找到對應(yīng)的第三方庫,但是復(fù)雜的就可能不好實現(xiàn)了,下面這篇文章主要給大家介紹了關(guān)于Python使用execjs執(zhí)行包含中文參數(shù)的JavaScript的相關(guān)資料,需要的朋友可以參考下2022-03-03
matplotlib是常見的繪圖庫，本文主要介紹了matplotlib繪制甘特圖的萬能模板案例，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-04-04
這篇文章主要為大家詳細介紹了如何使用Django實現(xiàn)接口token檢測,文中的示例代碼簡潔易懂,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2025-03-03
Python OpenCV 使用滑動條來調(diào)整函數(shù)參數(shù)的方法
這篇文章主要介紹了Python OpenCV 使用滑動條來調(diào)整函數(shù)參數(shù)的方法，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-07-07
本篇文章主要介紹了Django 導(dǎo)出 Excel 代碼的實例詳解，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-08-08
今天小編就為大家分享一篇Python 多線程不加鎖分塊讀取文件的方法，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-12-12
這篇文章主要介紹了詳解Python中time()方法的使用的教程,是Python入門學(xué)習(xí)中的基礎(chǔ)知識,需要的朋友可以參考下2015-05-05