uWSGI 的安装及配置详解

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [zhuanlan.zhihu.com](https://zhuanlan.zhihu.com/p/366440889)

uWSGI 是一个 Python Web 服务器, 它实现了 WSGI 协议、uwsgi、http 等协议，常在部署 Django 或 Flask 开发的 Python Web 项目时使用，作为连接 Nginx 与应用程序之间的桥梁。本章总结了 uWSGI 服务器的作用以及在部署 Python Web 项目时如何安装和配置 uWSGI。

**为什么需要 uWSGI?**

在生产环境中部署 Python Web 项目时，uWSGI 负责处理 Nginx 转发的动态请求，并与我们的 Python 应用程序沟通，同时将应用程序返回的响应数据传递给 Nginx。

```
客户端 <-> Nginx <-> uWSGI <-> Python应用程序(Django, Flask)

```

或许你要问了，Nginx 本身就是 Web 服务器，我们为什么还需要 uWSGI 这个 Web 服务器呢? Django 不是自带 runserver 服务器? Flask 不是自带 Werkzeug 吗? 答案是 Nginx 处理静态文件非常优秀，却不能直接与我们的 Python Web 应用程序进行交互。Django 和 Flask 本身是 Web 框架，并不是 Web 服务器，它们自带的 runserver 和 Werkzeug 也仅仅用于开发测试环境，生产环境中处理并发的能力太弱。

为了解决 Web 服务器与应用程序之间的交互问题，就出现了 Web 服务器与应用程序之间交互的规范。最早出现的是 CGI, 后来又出现了改进 CGI 性能的 FasgCGI，Java 专用的 Servlet 规范。在 Python 领域，最知名的就是 WSGI 规范了。

WSGI 全称是 Web Server Gateway Interface，也就是 Web 服务器网关接口，是一个 web 服务器（如 uWSGI 服务器）与 web 应用（如用 Django 或 Flask 框架写的程序）通信的一种规范。WSGI 包含了很多自有协议，其中一个是 uwsgi，它用于定义传输信息的类型。

现在你清楚 uWSGI, WSGI 和 uwsgi 的区别了吗?

- uWSGI 是 Python Web 服务器，实现了 WSGI 通信规范和 uwsgi 协议；

- WSGI 全名 Web Server Gateway Interface，是一个 Web 服务器（如 uWSGI 服务器）与 web 应用（如用 Django 或 Flask 框架写的程序）通信的一种规范；

- uwsgi 是 WSGI 通信规范中的一种自有协议。

**uWSGI 的安装与启动**

```
pip install uwsgi

```

为了测试 uWSGI 安装是否成功，可以编写一个 test.py 的测试文件，添加如下代码：

```
def application(env, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    return [b"Hello World"]

```

然后使用如下命令启动 uWSGI Web 服务器, 端口 8080.

```
uwsgi --http :8080 --wsgi-file test.py

```

如果你已经有了一个现成的 Django 项目，你可以使用如下命令启动 Web 服务。

```
# 使用uwsgi命令行启动Django项目，端口8000
$ uwsgi --http :8000 --module myproject.wsgi

```

在生产环境中我们通常不会使用命令行启动 Python Web 项目，而是通常编辑好 uWSGI 配置文件 uwsgi.ini, 然后使用如下命令启动 Python Web 项目。

```
# 使用uwsgi.ini配置文件启动Django应用程序
$ uwsgi --ini uwsgi.ini
 
# 重启uWSGI服务器
$ sudo service uwsgi restart
 
# 查看所有uWSGI进程
$ ps aux | grep uwsgi
 
# 停止所有uWSGI进程
$ sudo pkill -f uwsgi -9

```

**uWSGI 常用配置**

uWSGI 常用配置选项如下所示，稍加修改 (项目名，项目根目录) 即可部署大部分 Python Web 项目。

```
[uwsgi]
uid=www-data # Ubuntu系统下默认用户名
gid=www-data # Ubuntu系统下默认用户组
project=mysite1  # 项目名
base = /home/user1 # 项目根目录
 
home = %(base)/Env/%(project) # 设置项目虚拟环境,Docker部署时不需要
chdir=%(base)/%(project) # 设置工作目录
module=%(project).wsgi:application # wsgi文件位置
 
master=True # 主进程
processes=2 # 同时进行的进程数，一般
 
# 以下uwsgi与nginx通信手段3选一即可
# 选项1, 使用unix socket与nginx通信，仅限于uwsgi和nginx在同一主机上情形
# Nginx配置中uwsgi_pass应指向同一socket文件
socket=/run/uwsgi/%(project).sock
 
 
# 选项2，使用TCP socket与nginx通信
# Nginx配置中uwsgi_pass应指向uWSGI服务器IP和端口
# socket=0.0.0.0:8000 或则 socket=:8000
 
 
# 选项3，使用http协议与nginx通信
# Nginx配置中proxy_pass应指向uWSGI服务器一IP和端口
# http=0.0.0.0:8000 
 
 
# socket权限设置
chown-socket=%(uid):www-data
chmod-socket=664
 
 
# 进程文件
pidfile=/tmp/%(project)-master.pid
 
 
# 以后台守护进程运行，并将log日志存于temp文件夹。
daemonize=/var/log/uwsgi/%(project).log 
 
 
# 服务停止时，自动移除unix socket和pid文件
vacuum=True
 
 
# 为每个工作进程设置请求数的上限。当处理的请求总数超过这个量，进程回收重启。
max-requests=5000
 
 
# 当一个请求花费的时间超过这个时间，那么这个请求都会被丢弃。
harakiri=60
 
 
#当一个请求被harakiri杀掉会输出一条日志
harakiri-verbose=true
 
 
# uWsgi默认的buffersize为4096，如果请求数据超过这个量会报错。这里设置为64k
buffer-size=65536
 
 
# 如果http请求体的大小超过指定的限制，打开http body缓冲，这里为64k
post-buffering=65536
 
 
#开启内存使用情况报告
memory-report=true
 
 
#设置平滑的重启（直到处理完接收到的请求）的长等待时间(秒)
reload-mercy=10
 
 
#设置工作进程使用虚拟内存超过多少MB就回收重启
reload-on-as=1024

```

注意：uWSGI 和 Nginx 之间有 3 种通信方式, unix socket，TCP socket 和 http。Nginx 的配置必须与 uwsgi 配置保持一致。

```
# 选项1, 使用unix socket与nginx通信
# 仅限于uwsgi和nginx在同一主机上情形
# Nginx配置中uwsgi_pass应指向同一socket文件地址
socket=/run/uwsgi/%(project).sock
 
 
# 选项2，使用TCP socket与nginx通信
# Nginx配置中uwsgi_pass应指向uWSGI服务器IP和端口
socket==0.0.0.0:8000 或则 socket=:8000
 
 
# 选项3，使用http协议与nginx通信
# Nginx配置中proxy_pass应指向uWSGI服务器IP和端口
http==0.0.0.0:8000

```

如果你的 nginx 与 uwsgi 在同一台服务器上，优先使用本地机器的 unix socket 进行通信，这样速度更快。此时 nginx 的配置文件如下所示：

```
location / {     
    include /etc/nginx/uwsgi_params;
    uwsgi_pass unix:/run/uwsgi/project.sock;
}

```

如果 nginx 与 uwsgi 不在同一台服务器上，两者使用 TCP socket 通信时，nginx 可使用如下配置：

```
location / {     
    include /etc/nginx/uwsgi_params;
    uwsgi_pass uWSGI_SERVER_IP:8000;
}

```

如果 nginx 与 uwsgi 不在同一台服务器上，两者使用 http 协议进行通信，nginx 配置应修改如下：

```
location / {     
    # 注意：proxy_pass后面http必不可少哦！
    proxy_pass http://uWSGI_SERVER_IP:8000;
}

```

**小结**

本文介绍了 uWSGI 的作用及其与 WSGI 和 uwgsi 的区别，并详解介绍了如何安装, 配置和使用它。Python Web 领域还有一个遵循 WSGI 通信规范的 Gunicorn，它同样优秀，我们后面再做介绍。

本文节选自大江狗个人技术博客 ([大江狗的博客](https://pythondjango.cn)), 点击原文阅读即可跳转。

[uWSGI 配置详解](https://pythondjango.cn/python/tools/6-uwsgi-configuration/)