uwsgi + nginx 部署Django 项目

一、uwsgi 介绍

首先区分一下WSGI / uwsgi / uWSGI 这三个概念。

• WSGI，是一种通信协议。
• uwsgi同WSGI一样是一种通信协议。
• uWSGI是实现了uwsgi和WSGI两种协议的Web服务器。
  具体介绍如下：

1.1、WSGI

WSGI是Web服务器网关接口（Web Server Gateway Interface）的缩写，是Python Web应用程序和Web服务器之间的标准接口。它定义了一种规范的接口，用于连接Web应用程序和Web服务器之间的通信。WSGI允许开发人员使用Python编写Web应用程序，并且可以在不同的Web服务器上运行，从而实现应用程序的可移植性。WSGI是Python Web应用程序开发中的重要组成部分。

WSGI 的官方定义是，the Python Web Server Gateway Interface。从名字就可以看出来，这东西是一个Gateway，也就是网关。网关的作用就是在协议之间进行转换。

WSGI 是作为 Web 服务器与 Web 应用程序或应用框架之间的一种低级别的接口，以提升可移植 Web 应用开发的共同点。WSGI 是基于现存的 CGI 标准而设计的。

很多框架都自带了 WSGI server ，比如 Flask，webpy，Django、CherryPy等等。当然性能都不好，自带的 web server 更多的是测试用途，发布时则使用生产环境的 WSGI server或者是联合 nginx 做 uwsgi 。

也就是说，WSGI就像是一座桥梁，一边连着web服务器，另一边连着用户的应用。但是呢，这个桥的功能很弱，有时候还需要别的桥来帮忙才能进行处理。WSGI 的作用如图所示：

1.2、WSGI 作用

WSGI有两方：“服务器”或“网关”一方，以及“应用程序”或“应用框架”一方。服务方调用应用方，提供环境信息，以及一个回调函数（提供给应用程序用来将消息头传递给服务器方），并接收Web内容作为返回值。

所谓的 WSGI中间件同时实现了API的两方，因此可以在WSGI服务和WSGI应用之间起调解作用：从WSGI服务器的角度来说，中间件扮演应用程序，而从应用程序的角度来说，中间件扮演服务器。“中间件”组件可以执行以下功能：

• 重写环境变量后，根据目标URL，将请求消息路由到不同的应用对象。
• 允许在一个进程中同时运行多个应用程序或应用框架。
• 负载均衡和远程处理，通过在网络上转发请求和响应消息。
• 进行内容后处理，例如应用XSLT样式表。

1.3、uWSGI

uWSGI是一个Web服务器，它实现了WSGI协议、uwsgi、http等协议。Nginx中HttpUwsgiModule的作用是与uWSGI服务器进行交换。uWSGI是一个全栈的、快速的、开源的Web服务器和应用服务器，它支持多种协议和语言，比如Python、Ruby、Perl、PHP、Java等。uWSGI 是一个C语言编写的、高度模块化、可扩展的Web服务器，它提供了一个WSGI协议的实现，可以将Python Web应用与Web服务器连接起来。uWSGI支持多线程、异步和协程等特性，可以处理高并发的Web请求和高负载的Web应用程序。同时，uWSGI还提供了许多高级功能，如负载均衡、自动缓存、多进程管理等，可以帮助开发人员构建高效、稳定、可扩展的Web应用程序。

为什么有了uWSGI为什么还需要nginx？因为nginx具备优秀的静态内容处理能力，然后将动态内容转发给uWSGI服务器，这样可以达到很好的客户端响应。

1.4、uwsgi

uwsgi协议是一个uWSGI服务器自有的协议，它用于定义传输信息的类型（type of information），每一个uwsgi packet前4byte为传输信息类型描述，它与WSGI相比是两样东西。

二、Django 项目使用

2.1、安装uwsgi

pip install uwsgi

2.2、配置ini文件

在项目目录（即settings.py所在目录）下新建配置文件 uwsgi.ini,内容如下：

# 开头必须是[uwsgi]
[uwsgi]

# 现在还没有配置nginx所以暂时使用http
http=127.0.0.1:8007

# 配置项目路径，项目的所在目录**必须是：绝对路径**
chdir=/Users/wei/python_project/pyhon_testing/Mars

# 启动uwsgi的用户名和用户组
uid=root
gid=root

# 配置wsgi接口模块文件路径，**相对路径**
wsgi-file=Mars/wsgi.py

# 指向自己Django项目目录下的wsgi文件
module=uwsgi_test.wsgi:application

# 指定sock的文件路径
socket=/opt/uwsgi_test/script/uwsigi.sock      # sock文件是由uwsgi.ini文件启动>之后自动生成

# 进程个数
workers=5

# 自动移除unix Socket和pid文件当服务停止的时候
vacuum=true

# 序列化接受的内容，如果可能的话
thunder-lock=true

 # 启用线程
enable-threads=true

# 设置自中断时间
harakiri=30

# 设置缓冲
post-buffering=4096

# 设置请求的最大大小 (排除request-body)，这一般映射到请求头的大小。默认情况下，它是4k，大cookies的情况下需要加大该配置
buffer-size=65535

# 设置每个工作进程处理请求的上限，达到上限时，将回收（重启）进程，可以预防内存泄漏
max-requests=5000

# 配置启动的进程数，这个多配无意，按照自己电脑核去配置
processes=4

# 配置每个进程的线程数
threads=2

# 配置启动管理主进程
master=True

# 配置存放主进程的进程号文件，启动uwsgi后**uwsgi.pid文件会自动生成**
pidfile=uwsgi.pid

# 配置dump日志记录
daemonize=uwsgi.log

2.3、启动运行uwsgi

在uwsgi.ini目录下

uwsgi --ini uwsgi.ini
[uWSGI] getting INI configuration from uwsgi.ini

查看是否启动

ps aux | grep uwsgi.ini

admin      2597  0.0  1.1 283820 47924 ?        S    Mar27   0:10 uwsgi --ini uwsgi.ini
admin      2671  0.0  1.3 450764 55532 ?        Sl   Mar27   0:00 uwsgi --ini uwsgi.ini
admin      2672  0.0  1.0 288940 42880 ?        S    Mar27   0:00 uwsgi --ini uwsgi.ini

2.4、停止运行

uwsgi --stop uwsgi.pid

2.4、重新启动

uwsgi --reload uwsgi.pid　

三、与nginx 结合使用

3.1、安装nginx

yum install nginx

查看nginx 版本

nginx -v
nginx version: nginx/1.10.2

3.2、修改nginx.conf

查找nginx 配置文件位置

whereis nginx
nginx: /usr/sbin/nginx /usr/lib64/nginx /etc/nginx /usr/share/nginx /usr/share/man/man8/nginx.8.gz /usr/share/man/man3/nginx.3pm.gz

find / -name nginx.conf
/etc/nginx/nginx.conf

新增内容如下：

server {
        listen       80 default_server;
        listen       [::]:80 default_server;
        server_name  _;
        root         /usr/share/nginx/html;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;
        location / {
            uwsgi_pass 127.0.0.1:5050;
            include /etc/nginx/uwsgi_params; # uwsgi_params文件的地址 
        }

        #error_page 404 /404.html;
        #    location = /40x.html {
        #}

        #error_page 500 502 503 504 /50x.html;
        #    location = /50x.html {
        #}
    }

验证配置是否正确

nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

3.3、修改uwsgi.ini

http 修改为socket,如下：

[uwsgi]
#http=127.0.0.1:5050
socket=127.0.0.1:5050
...

启动uwsgi

uwsgi --ini uwsgi.ini

3.4、启动nginx

systemctl start nginx

四、参考文档

1、https://blog.51cto.com/u_13597899/5328281

2、https://blog.csdn.net/weixin_43690525/article/details/120518943

3、https://www.runoob.com/django/django-nginx-uwsgi.html