Django项目部署：使用uwsgi和nginx的方式

小程序：扫一扫查出行
【扫一扫了解最新限行尾号】
复制小程序

一、背景

前两天制作的个人博客网站基本完工，大致功能具备。但是在部署环节却也处处碰壁，这里也来总结以下，以备将来不时查看以及完善。

二、前提

2.1 需要的知识

django

Django是一个基于python开发的web开发框架，内容丰满，功能相比于它的同行flask、webpy要健全的多，具有丰富的第三方库。

uWSGI

uWSGI是一个实现WSGI协议、uwsgi协议、http协议的web服务器。这里我们要区分一下WSGI、uWSGI、uwsgi： WSGI：是一种通信协议； uwsgi：是一种线路协议而不是通信协议，在此常用于在uWSGI服务器与其他网络服务器的数据通信，属于uWSGI自有的协议； uWSGI：是实现了uwsgi和WSGI两种协议的Web服务器。

nginx

相比Apache，是具有后起之秀的高性能代理服务器。

wsgi.py

它是Django项目自带的一个接口文件，与uWSGI通信。

2.2 项目流程

以上每个部分都具有什么作用呢？

首先客户端发起服务资源请求； nginx作为本项目直接对外的服务接口，会优先接收到客户端发过来的http请求，并进行分析；若请求的资源为静态文件，那么直接根据nginx配置文件.conf中的静态文件指定地址来返回请求的资源；若为动态请求，nginx则会通过.conf文件中配置将请求发送给uWSGI；uWSGI将接收到的包进行处理，再转发给wsgi； wsgi则根据请求调用Django项目的某个文件或函数，处理完后，Django将返回值给wsgi； wsgi将返回值打包返回给uWSGI； uWSGI再将其转发给nginx，nginx最终将资源返回给客户端；

作用：

nginx在整个项目中其实并非必须，直接用uWSGI也是可以的，但是在部署项目时Django要将debug设置为False，这时Django对静态文件的处理不是很好，所以需要nginx来处理会更高效；
除此之外，nginx上可以做一些安全上的设置，保障网站运行的安全性；
uWSGI本身是内网接口，开启多个work和processes的话也可能会不够用，但是nginx可以代理多个uWSGI完成uWSGI的负载均衡；

三、安装与配置

默认您已经有了Django项目，当然如果您还没有Django项目的话，可以临时通过django-admin startproject 项目名称，来创建一个临时的项目；并确保您的项目是可运行的，python manange.py runserver 0.0.0.0:8000来检验。

我用的云服务器默认安装的是root权限，普通用户权限的最好安装时加上sudo，下面不一一列出。

Step1，安装uWSGI：

针对你使用的python版本来安装，我的是python3.6： pip3 install uwsgi

安装完成后，测试uWSGI，在你自定义的目录下新建test.py，内容可自定义，我参考官网如下：

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

运行：

uwsgi --http :8000 --wsgi-file test.py

访问127.0.0.1:8000，运行结果，正常显示：

如果此处有提示你的端口被占用，可以换一个端口(陌生不常见的)，或者通过端口查看pid，杀死占用端口的进程：

1. lsof -i :8000

然后根据pid号，用kill命令杀死进程：

kill -9 pid

然后再去执行，就应该会看到结果了。

Step2，安装nginx：

apt-get install nginx

安装完后，先不用忙着配置，可以先启动nginx看看是否安装成功，启动命令如下：

通常这三种方式，任意其一都可以使用： 1、service nginx start # 停止对应stop，重启restart，状态查看status 2、systemctl start nginx.service # 停止对应stop，重启restart，状态查看status 3、/etc/init.d/nginx start 停止对应stop，重启restart，状态查看status

访问127.0.0.1:80，会看到：

说明nginx也已经成功安装了。

Step3配置uWSGI：

先任意找一个位置，最好和你的项目同一个位置，创建存放uwsgi配置文件的文件夹，然后再开始进行相关配置：

第一步：创建uwsgi文件夹，命令：

mkdir uwsgi

第二步：进入文件夹，命令：

cd uwsgi

第三步：创建xxx.ini文件，文件名字自定义，我用uwsgi.ini；命令：

touch uwsgi.ini

第四步：对ini文件进行参数配置，内容如下，仅供参考：

[uwsgi] chdir=/home/work_blog # 项目地址 home=/root/myblog # 虚拟环境地址（如果你的项目部署在虚拟环境中，那么这一步是必须的，否则会报错） module=work_blog.wsgi:application # wsgi文件地址，不能像home和chdir那样写，这个写法官网固定，例如我这种(wsgi.py文件的父目录).wsgi:application workers=4 # 子进程，也可以用processes=4这样来写 pidfile = /home/uwsgi/master.pid # 在uwsgi文件夹下自动创建pid文件 harakiri=30 # 30s后重启进程，值可自定义 max-requests=5000 # 设置最大请求数 master=true # 开启主进程 uid=root gid=root thunder-lock=true post-buffering=4096 daemonize = /home/uwsgi/myblog.log # 在uwsgi文件夹下自动创建log日志文件 vacuum=true enable-threads=true socket=0:9000 # socket通信，主要用来和nginx通信使用 chmod-socket=666

然后保存退出:wq

第五步：启动该ini配置

uwsgi --ini uwsgi.ini

这时候你去用ps -aux | grep uwsgi命令查看uwsgi，会发现有多个进程：

如果进程没启动，可能需要重载一下uwsgi目录下的pid文件，即uwsgi --reload xxx.pid，通常就可以了。

关闭这些进程，使用uwsgi --stop xxx.pid命令执行。

重启ini配置时，使用uwsgi --reload xxx.pid的命令；不要使用uwsgi --ini uwsgi.ini，因为这样会导致生成很多新的子进程，如果生成过多子进程，请使用:

killall -9 uwsgi

然后再重新加载ini配置。

注：如果遇见uwsgi有这样的错误日志的：!!!no internal routing support, rebuild with pcre support!!!

有以下解决方法推荐，我的这样解决了，不一定对你也适用，故推荐：

①centos：1、pip/pip3 uninstall uwsgi 2、yum install pcre pcre-dedvel pcre-static 3、pip/pip3 install uwsgi -I --no-cache-dir ②ubuntu：1、pip/pip3 uninstall uwsgi 2、apt-get install libpcre3-devel 3、pip/pip3 install uwsgi -I --no-cache-dir

这样做完后，重新去执行ini文件，应该就可以了。。。

Step4配置nginx：

nginx的配置，首先进入/ect/nginx/路径下。有的人是直接在nginx.conf文件改的，有的是在sites-available/default文件中修改的，不过我这里是在sites-available下新创建了mysite.conf文件，并在其中进行配置。

server { listen 80; # 设置监听端口，也即为你用外网访问你的项目的端口 server_name www.runstone.top; # 你的项目域名 charset utf-8; # 设置字符集为utf-8 client_max_body_size 75M; # 最大上传大小 location /media { # 项目media路径指引 alias /home/work_blog/media; } location /favicon.ico { # 网站图标路径指引，该项不为必须项 alias /home/work_blog/favicon.ico; } location /static { # 项目静态文件static路径指引，所有的js、css、image等资源都在这下面 alias /home/work_blog/static_collected; } location / { include /etc/nginx/uwsgi_params; # uwsgi_params文件路径，通常会在/etc/nginx下面； uwsgi_pass 0:9000; # socket通信端口，对应于uwsgi.ini中的socket的设置 uwsgi_connect_timeout 30; # 可不配置 uwsgi_read_timeout 1800; # 可不配置 uwsgi_send_timeout 300; # 可不配置 proxy_read_timeout 300; # 可不配置 } }

配置完后，要对该文件做一个软链接，ln -s /etc/nginx/sites-available/mysite.conf /etc/nginx/sites-enabled/mysite.conf。
重新启动nginx，service nginx restart
上述配置中没有注明nginx的log文件地址，默认的地址为：/var/log/nginx/access.log以及/var/log/nginx/error.log。当然这两个文件的路径你也可以给设置到项目路径下，在上述文件中添加：

access_log xxx/your project/project_access.log; error_log xxx/your project/project_error.log;

即可。这样方便日后项目多时，日志查看与项目维护。