本文首發於公眾號：Hunter後端 原文鏈接：Django筆記四十三之使用uWSGI部署Django系統 目前部署 Django 的方式一般來說是使用 Nginx + uWSGI + Django 來實現。 處理流程是，當一個請求發送過來會先經過 Nginx，如果是靜態文件請求，Nginx 這一層直 ...
本文首發於公眾號：Hunter後端
目前部署 Django 的方式一般來說是使用 Nginx + uWSGI + Django 來實現。
處理流程是，當一個請求發送過來會先經過 Nginx，如果是靜態文件請求，Nginx 這一層直接處理，如果是後端動態介面，則會發送至 uWSGI，而 uWSGI 是一個 web 伺服器，它實現的操作是將 HTTP 請求轉換成 Python 支持的網路協議，比如 WSGI 協議。
以下是本篇筆記目錄：
- Nginx 和 uWSGI
- WSGI、uWSGI 和 uwsgi
- uWSGI 示例及啟動
- 配置項詳解
1、Nginx 和 uWSGI
使用 Nginx 相當於實現了一次反向代理，也可以通過使用 Nginx 實現負載均衡，將請求分配給不同的後端服務，同時靜態文件和動態介面分開請求，提高服務響應性能。
如果部署操作直接使用 uWSGI + Django，那麼 uWSGI 就相當於一個 web 伺服器，用於直接處理 HTTP 請求。如果是配合 Nginx 使用，相當於是一個中間件的作用，起到轉發來自 Nginx 請求的作用。
2、WSGI、uWSGI 和 uwsgi
接下來理解一下 uWSGI，WSGI 和 uwsgi 這幾個概念。
WSGI
web server gateway interface，web 伺服器網關介面，是一種協議規範，是用於 wsgi 伺服器（比如 uWSGI） 和 wsgi 應用（比如 Django）之間進行通信的規範。
uWSGI
web 伺服器，或者叫 wsgi 伺服器，實現 http 協議，用於接收 http 請求並能夠解析信息。要將信息發給 Django，必須要用到 WSGI 協議，所以同時也可以實現 WSGI 協議。
uwsgi
是 uWSGI 伺服器自有的線路協議，用於與 Nginx 等代理伺服器通信。
3、uWSGI 示例及啟動
我們可以通過 uWSGI 命令，將參數都寫入命令行直接運行，也可以將配置項寫入配置文件，用 uWSGI 直接獲取配置信息，這裡我們介紹都寫入配置文件的方法來操作。
1、uWSGI 安裝
首先我們需要安裝一下 uWSGI：
pip3 install uwsgi -i https://mirrors.aliyun.com/pypi/simple/
2、配置示例及啟動
假設我們的 Django 系統目錄為 /path/to/hunter/，我們在該目錄下創建一個文件 uwsgi.ini。
uwsgi.ini 內容如下：
# uwsgi.ini
[uwsgi]
http = :9898
chdir = /path/to/hunter/
wsgi-file = hunter/wsgi.py
master=true
processes = 4
threads = 2
以上是一個簡單的可運行 uwsgi.ini 配置示例。
接著我們運行一下：
uwsgi uwsgi.ini
可以看到在 shell 的前臺輸出下麵的信息：
*** Starting uWSGI 2.0.21 (64bit) on [Mon Mar 20 00:14:08 2023] ***
...
...
*** uWSGI is running in multiple interpreter mode ***
spawned uWSGI master process (pid: 16291)
spawned uWSGI worker 1 (pid: 16295, cores: 2)
spawned uWSGI worker 2 (pid: 16296, cores: 2)
spawned uWSGI worker 3 (pid: 16299, cores: 2)
spawned uWSGI worker 4 (pid: 16301, cores: 2)
表示 uWSGI 已經正常啟動，接著我們在瀏覽器訪問該地址的 9898 埠的 admin 頁面，可以看到沒有樣式的 admin 登錄頁面，如下：
4、配置項詳解
在這裡我們是直接使用 uWSGI + Django 的方式啟動，所以首行是 http=:9898，表示可以通過瀏覽器的方式訪問。
如果回頭我們使用 Nginx + uWSGI + Django 的方式啟動，這裡就要改成 socket=:9898。
chdir
chdir 參數指向的是我們項目根目錄
wsgi-file
這裡我們填寫的是相對地址，文件是 Django 系統在創建項目時自動創建的。
master
表示的是啟動的 uWSGI 主進程是否開啟
processes
表示啟動的是進程數，所以在啟動後輸出的信息里，會有主進程和四個進程的信息
threads
表示的線程數，在上面的進程數後面 cores: 2，輸出的就是線程信息。
除了上面這些參數，我們還可以定義一些其他的參數
daemonize
daemonize 的值為一個地址，用於記錄 uWSGI 運行的日誌，同時將服務在後臺運行。
daemonize = /var/log/uwsgi/xxx.log
static-map
static-map 參數作用是映射 Django 的靜態文件路徑，前面我們運行之後，訪問後臺 admin 界面，發現沒有前端樣式對不對，如果想要有樣式顯示，則需要先定義這個參數，然後將 Django 的 admin 樣式文件遷移到指定文件，操作步驟如下：
1.定義 STATIC_ROOT
首先，我們需要在 settings.py 里定義 STATIC_ROOT，這個參數是一個路徑，表示我們在下一步需要將靜態文件集中到的文件路徑，假設我們需要把文件都集中到 /var/static/ 目錄下：
# settings.py
STATIC_ROOT = "/var/static/"
2.collectstatic命令
接下來執行靜態文件集中的命令：
python3 manage.py collectstatic --no-input
本來前面的命令就可以了，但是執行的時候會有選擇項需要我們選擇，在後續部署的時候，我們可以加上 --no-input 表示不需要提示輸入信息。
3.定義static-map
接下來我們定義 static-map 就可以映射靜態文件的地址，這樣，我們使用 uWSGI 部署 Django 後也可以訪問 admin 的靜態文件里。
static-map = /static/=/var/static/
stats
stats 參數後面接的內容是埠，用於獲取 uWSGI 幾個 worker 的狀態信息。
如果想要到瀏覽器訪問的話還需要加一個 stats-http=true，如下：
stats = 127.0.0.1:9897
stats-http = true
timeout
關於 timeout 有兩個參數，一個是 http-timeout，一個是 socket-timeout。
前面介紹了開放埠的時候，如果是 uWSGI 單獨使用，就使用 http，那麼 timeout 就使用 http-timeout
如果是配合 Nginx 使用，那麼就使用 socket-timeout。
它的單位是秒.
http-socket=60 # 60秒超時時間
註意：上面的計算運行超時之後，會斷開與前端的連接，但是後端還是會繼續執行邏輯
harakiri
這個也是超時時間，但是與 timeout 不同的是，這個參數在超時之後斷開連接之後，同時後端也停止執行運算，具體的操作是重啟該請求所在的進程。
它的單位也是秒。
max-requests
重啟進程的最大請求數，比如我們設置：
max-requests=5000
那麼在某個 worker 進程處理 5000 個請求之後則會重啟。
以上就是使用 uWSGI 啟動 Django 系統的示例及介紹，在之後的筆記中會再介紹如何使用 Nginx 進行操作，包括使用 Nginx 進行反向代理和負載均衡的配置。
如果想獲取更多相關文章，可掃碼關註閱讀：
