本文首发于公众号:Hunter后端

原文链接:

目前部署 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 进行反向代理和负载均衡的配置。