本文首發于公眾號：Hunter后端

原文鏈接：Django筆記四十三之使用uWSGI部署Django系統

目前部署 Django 的方式一般來說是使用 Nginx + uWSGI + Django 來實現。

處理流程是，當一個請求發送過來會先經過 Nginx，如果是靜態文件請求，Nginx 這一層直接處理，如果是后端動態接口，則會發送至 uWSGI，而 uWSGI 是一個 web 服務器，它實現的操作是將 HTTP 請求轉換成 Python 支持的網絡協議，比如 WSGI 協議。

以下是本篇筆記目錄：

1. Nginx 和 uWSGI
2. WSGI、uWSGI 和 uwsgi
3. uWSGI 示例及啟動
4. 配置項詳解

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 進行反向代理和負載均衡的配置。

如果想獲取更多相關文章，可掃碼關注閱讀：

總結

以上是生活随笔為你收集整理的Django笔记四十三之使用uWSGI部署Django系统的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。