Python3 基于 Nginx 部署 Django 项目

一、原理图

二、项目环境

操作系统： Centos 7

编程语言： Python 3.5.2

Web 框架： Django 2.0.3

Web 服务器： uWSGI 2.0.17

Web 服务器： Nginx 1.10.3

具体的安装这里不做详述，Ubuntu 使用 apt-get 安装特别方便。

sudo yum install python3
sudo yum  install python3-pip
sudo yum  install nginx

127.0.0.1

三、uWSGI 安装配置

安装

sudo pip3 install uwsgi

测试

创建 test.py 文件

#!/usr/bin/env python3
# -*- coding: UTF-8 -*-

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

通过 uWSGI 运行该文件

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

127.0.0.1:8000

四、Django 与 uWSGI 之间的通信

安装 Django

sudo pip3 install Django==2.0.3

创建 Django 项目

django-admin startproject myweb

/home/setup/myweb

uwsgi --http:8000 --chdir /home/setup/myweb --wsgi-file myweb/wsgi.py 

常用选项

• http： 协议类型和端口号
• processes： 开启的进程数量
• workers： 开启的进程数量，等同于 processes
• chdir： 指定运行目录
• wsgi-file： 载入 wsgi-file
• stats： 在指定的地址上，开启状态服务
• threads： 运行线程。由于 GIL 的存在，我觉得这个真心没啥用。
• master： 允许主进程存在
• daemonize： 使进程在后台运行，并将日志打到指定的日志文件或者 udp 服务器（daemonize uWSGI）。实际上最常用的，还是把运行记录输出到一个本地文件上。
• pidfile： 指定pid文件的位置，记录主进程的pid号。
• vacuum： 当服务器退出的时候自动清理环境，删除 unix socket 文件和 pid 文件

五、Nginx、uWSGI、Django 之间的通信

接下来，我们要将三者结合起来

1. 配置 Django 和 uWSGI

先在 Django 项目根目录下新建一个 uWSGI 的配置文件 uwsgi.ini

cd myweb
touch uwsgi.ini

此时 Django 项目的目录文件结构如下：

myweb/
├── manage.py
├── myweb
│   ├── __init__.py
│   ├── __pycache__
│   │   ├── __init__.cpython-35.pyc
│   │   └── settings.cpython-35.pyc
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── uwsgi.ini

在我们通过 Django 创建 myweb 项目时，在子目录 myweb 下已经帮我们生成的 wsgi.py文件。所以，我们只需要再创建 uwsgi.ini 配置文件即可。

uwsgi 支持多种类型的配置文件，如 xml、ini 等。此处，使用 ini 类型的配置。

接下来打开刚刚创建好的配置文件 uwsgi.ini 添加如下配置：

[uwsgi]

http = :8000
chdir           = /home/setup/myweb
module          = myweb.wsgi
master          = true
processes       = 4
vacuum          = true

这个配置，其实就相当于在上一小节中通过 wsgi 命令，后面跟一堆参数的方式，给文件化了。

module = hello.wsgi

其它几个参数，可以参考上一小节中参数的介绍。

接下来，通过 uwsgi 命令读取 uwsgi.ini 文件启动项目

uwsgi --ini uwsgi.ini

运行结果：

setup@labideas-data:~/myweb$ uwsgi --ini uwsgi.ini
[uWSGI] getting INI configuration from uwsgi.ini
*** Starting uWSGI 2.0.17 (64bit) on [Tue Mar 20 11:11:30 2018] ***
compiled with version: 5.4.0 20160609 on 19 March 2018 09:13:12
os: Linux-4.4.0-105-generic #128-Ubuntu SMP Thu Dec 14 12:42:11 UTC 2017
nodename: labideas-data
machine: x86_64
clock source: unix
detected number of CPU cores: 4
current working directory: /home/setup/hello
detected binary path: /usr/local/bin/uwsgi
!!! no internal routing support, rebuild with pcre support !!!
chdir() to /home/setup/hello
your processes number limit is 64049
your memory page size is 4096 bytes
detected max file descriptor number: 65535
lock engine: pthread robust mutexes
thunder lock: disabled (you can enable it with --thunder-lock)
uwsgi socket 0 bound to TCP address :8888 fd 3
Python version: 3.5.2 (default, Nov 23 2017, 16:37:01)  [GCC 5.4.0 20160609]
*** Python threads support is disabled. You can enable it with --enable-threads ***
Python main interpreter initialized at 0x1f73aa0
your server socket listen backlog is limited to 100 connections
your mercy for graceful operations on workers is 60 seconds
mapped 364520 bytes (355 KB) for 4 cores
*** Operational MODE: preforking ***
WSGI app 0 (mountpoint='') ready in 0 seconds on interpreter 0x1f73aa0 pid: 7097 (default app)
*** uWSGI is running in multiple interpreter mode ***
spawned uWSGI master process (pid: 7097)
spawned uWSGI worker 1 (pid: 7099, cores: 1)
spawned uWSGI worker 2 (pid: 7100, cores: 1)
spawned uWSGI worker 3 (pid: 7101, cores: 1)
spawned uWSGI worker 4 (pid: 7102, cores: 1)

注意查看uwsgi的启动信息，如果有错，就要检查配置文件的参数是否设置有误。

2. 配置 Nginx

/etc/nginx

setup@labideas-data:/etc/nginx$ ll
total 64
drwxr-xr-x  6 root root 4096 Mar 20 09:37 ./
drwxr-xr-x 95 root root 4096 Mar 19 19:56 ../
drwxr-xr-x  2 root root 4096 Mar 19 20:13 conf.d/
-rw-r--r--  1 root root 1077 Feb 12  2017 fastcgi.conf
-rw-r--r--  1 root root 1007 Feb 12  2017 fastcgi_params
-rw-r--r--  1 root root 2837 Feb 12  2017 koi-utf
-rw-r--r--  1 root root 2223 Feb 12  2017 koi-win
-rw-r--r--  1 root root 3957 Feb 12  2017 mime.types
-rw-r--r--  1 root root 1919 Mar 20 09:33 nginx.conf
-rw-r--r--  1 root root  180 Feb 12  2017 proxy_params
-rw-r--r--  1 root root  636 Feb 12  2017 scgi_params
drwxr-xr-x  2 root root 4096 Mar 20 10:00 sites-available/
drwxr-xr-x  2 root root 4096 Mar 19 14:59 sites-enabled/
drwxr-xr-x  2 root root 4096 Mar 19 14:59 snippets/
-rw-r--r--  1 root root  664 Feb 12  2017 uwsgi_params
-rw-r--r--  1 root root 3071 Feb 12  2017 win-utf

/etc/nginx/sites-availabledefault/etc/nginx/nginx.conf

将原有配置文件进行备份，并打开 nginx 配置文件

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak
sudo vi /etc/nginx/sites-available/default

将默认的 80 端口号改成其它端口号，如 8080。因为默认的 80 端口号很容易被其它应用程序占用，而且我们配置我们自己的 Django 项目也需要用到默认端口。

# Django 2.0 项目部署
server {

    listen          80; 
    server_name     data.labideas.cn 
    charset         UTF-8;
    access_log      /var/log/nginx/myweb_access.log;
    error_log       /var/log/nginx/myweb_error.log;

    client_max_body_size 75M;

    location / { 

        include uwsgi_params;
        uwsgi_pass 127.0.0.1:8888;
        uwsgi_read_timeout 2;
    }   

    location /static {

        expires 30d;
        autoindex on; 
        add_header Cache-Control private;
        alias /home/setup/myweb/static/;
    }   
}

• listen： 指定的是 nginx 代理 uwsgi 对外的端口号。
• server_name： 网上大多资料都是设置的一个网址（例，www.baidu.com，如果指定的是 localhost 或 127.0.0.1 则只能在本机访问。

那么 nginx 到底是如何 uwsgi 产生关联的呢？现在看来大概最主要的就是这两行配置。

include uwsgi_params;
uwsgi_pass 127.0.0.1:8888;

includeuwsgi_paramsuwsgi_passmyweb_uwsgi.ini

现在重新启动 nginx

sudo /etc/init.d/nginx restart

127.0.0.1

Invalid HTTP_HOST header: 'data.labideas.cn'. You may need to add 'data.labideas.cn' to ALLOWED_HOSTS.
[pid: 7924|app: 0|req: 1/1] 114.249.204.30 () {40 vars in 658 bytes} [Tue Mar 20 06:16:28 2018] GET / => generated 54903 bytes in 41 msecs (HTTP/1.1 400) 1 headers in 53 bytes (1 switches on core 0)

在 uWSGI 后台就可以看到有信息输出。通过 IP 和端口号的指向，请求应该是先到 nginx 的，如果你在页面上执行一些请求，就会看到，这些请求最终会转到 uwsgi 来处理。

最后我们将 uWSGI 配置为开机自启

sudo vi /etc/rc.local

uwsgi --ini /home/setup/myweb/uwsgi.ini &

添加到文件中

exit 0&

六、遇到的问题

在配置过程中，总会遇到各种各样的问题，这里我将最常用的几项问题罗列出来，希望能帮到你。

1. Django 启动报错

setup@labideas-data:~/myweb$ python3 manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).

You have 14 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.

March 20, 2018 - 06:28:52
Django version 2.0.3, using settings 'myweb.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

创建一个新项目，利用 Django 本身的测试服务器启动，会出现上述的错误。这是因为你的项目中有些默认数据并没有迁移到数据库中。

解决办法：

将数据迁移到数据库中

python3 manage.py migrate

2. uwsgi 启动报错

在启动 uwsgi 的时候，在启动信息中如果有下面的错误提示：

!!! no internal routing support, rebuild with pcre support !!!

是依赖有问题

解决办法：

卸载 uwsgi，注意此时卸载，pip 会有缓存留在系统里

pip uninstall uwsgi

安装 pcre 依赖库

centos 安装

sudo yum install pcre pcre-devel pcre-static

ubuntu 安装

sudo apt-get install libpcre3 libpcre3-dev

重新安装 uwsgi，不走 pip 缓存

pip install uwsgi -I --no-cache-dir

!!! no internal routing support, rebuild with pcre support !!!

3. 端口报错

有时候进过多次配置，启动 Django 和 uWSGI 可能会出现如下报错

Error: That port is already in use

这是端口号已被占用，是 servr 已经在运行了，也有可能在后台运行或者是你停掉可 Django 但是，进程资源和端口号并没有释放掉。

解决办法：

找到该进程 kill 掉即可

sudo ps aux | grep uwsgi
sudo kill -9 PID

或者最简单的解决方法就是直接杀掉

sudo fuser -k 8000/tcp

这样和端口 8000 相关的进程就都死掉了

4. 公网端口安全组屏蔽

localhost

项目在正式的环境中上线，一定是在公网上的，有时候我们会选择云服务器，这里以阿里云服务器为例，我们需要为其开放对应的端口号。

uwsgi.ini8888

这是因为，阿里云的安全组规则端口是对外屏蔽的，我们 Nginx 和 uWSGI 之间通信的 socket 端口号 8888 是在内网环境中，所以不受影响。

5. 正式上线模式

因为我们在实际开发的时候，需要用到 DEBUG 模式，但是在正式上线的时候我们需要关闭 DEBUG 模式。

settings.py

将

DEBUG = True

修改为

DEBUG = False

将

ALLOWED_HOSTS = []

修改为

ALLOWED_HOSTS = ['data.labideas.cn']

或者

ALLOWED_HOSTS = ['*']

*

6. Admin 管理界面样式表丢失

曾几何时，Admin 是检验 Django 是否成功安装的标准。但是在正式环境中，经常会遇到样式表丢失的问题。为什么会这样呢？

这是因为 Nginx 在正式环境中，找不到 Django 项目中的静态文件。

解决办法：

static

settings.py

添加一行

STATIC_ROOT = '/home/setup/myweb/static/'

STATIC_ROOTstatic

STATIC_ROOTstatic

python3 manage.py collectstatic

需要注意的是，假如不做第 ① 步的话，直接运行这个命令会导致错误发生。

④ 修改 Nginx 配置文件

location /static {

    expires 30d;
    autoindex on; 
    add_header Cache-Control private;
    alias /home/setup/html/data/static/;
}

aliasstaticsettings.pySTATIC_ROOT

⑤ 重启 uWSGI 和 Nginx

# 杀掉 uwsgi.ini 进程
ps aux | grep uwsgi | grep -v grep | awk '{print $2}' | xargs kill -9
uwsgi --ini /home/setup/html/data/uwsgi.ini &

sudo /etc/init.d/nginx restart

好了，至此本教程也已完结。之所以选择 Django2.0 版和 Python3 部署，是因为从 Django2.0 开始只支持 Python3.4 以上的版本了，并不向下兼容。而且未来投身到这坑中的同学也越来越多，为此也算是为 Python 和 Django 社区做点微小贡献。

关于 Django 和 Nginx 部署的文章网上有很多，大多数都比较乱，有些太简单的看不懂，有些又太啰嗦的不知道核心的几步是什么，感觉那些人顺着自己的思路写的。有很多细节没有特别标注，导致怎么弄都是失败报错。经过 1 天时间的潜心摸索，把能踩得坑都踩了，总结出一篇比较清晰详细的教程，希望这篇文章能帮到你！