nginx + uWSGI + Django部署

2020-12-16 22:04:46 编辑 2 阅读量:1046

将nginx作为服务器最前端，它将接收WEB的所有请求，统一管理请求。nginx把所有静态请求自己来处理（这是NGINX的强项）。然后，NGINX将所有非静态请求通过uwsgi传递给Django，由Django来进行处理，从而完成一次WEB请求。可见，uwsgi的作用就类似一个桥接器。起到桥梁的作用。
    NOTE：不使用nginx，只使用uwsgi+django也是可以实现WEB服务的。uwsgi也可以直接处理WEB请求。

一、安装nginx、uwsgi
    安装nginx（此处安装后为1.4.6版本， 版本查看命令nginx -v）：
    1、安装
在ubuntu shell下输入：

```
sudo apt-get install nginx

# 启动nginx
sudo /etc/init.d/nginx start  # 还有stop, restart
```

2、查看nginx配置
进入目录 /etc/nginx可以看到nginx.conf，这是nginx最关键的配置。打开文件（sudo vim nginx.conf），部分内容如下：

```
user www-data;
worker_processes 4;
pid /run/nginx.pid;

events {
	worker_connections 768;
	# multi_accept on;
}

http {
       # 定义一个名称为zone的存储区域，内容为binary_remote_add(远程IP地址),大小>为10M（一定要在第一行）
        limit_conn_zone $binary_remote_addr zone=one:10m;

##
	# Basic Settings
	##

sendfile on;
	tcp_nopush on;
	tcp_nodelay on;
	keepalive_timeout 65;
	types_hash_max_size 2048;
	# server_tokens off;

# server_names_hash_bucket_size 64;
	# server_name_in_redirect off;

include /etc/nginx/mime.types;
	default_type application/octet-stream;

##
	# Logging Settings
	##

access_log /var/log/nginx/access.log;
	error_log /var/log/nginx/error.log;

##
	# Gzip Settings
	##

gzip on;
	gzip_disable "msie6";

# gzip_vary on;
	# gzip_proxied any;
	# gzip_comp_level 6;
	# gzip_buffers 16 8k;
	# gzip_http_version 1.1;
	# gzip_types text/plain text/css application/json application/x-javascript text/xml application/xml application/xml+rss text/javascript;

##
	# nginx-naxsi config
	##
	# Uncomment it if you installed nginx-naxsi
	##

#include /etc/nginx/naxsi_core.rules;

##
	# nginx-passenger config
	##
	# Uncomment it if you installed nginx-passenger
	##
	
	#passenger_root /usr;
	#passenger_ruby /usr/bin/ruby;

##
	# Virtual Host Configs
	##

include /etc/nginx/conf.d/*.conf;
	include /etc/nginx/sites-enabled/*;
}
```

其中，worker_processes 4;根据CPU的核心数目设置；
           access_log /var/log/nginx/access.log;表示log存放路径
           include /etc/nginx/sites-enabled/*;存放个人网站的配置

进入/etc/nginx/sites-enabled可以看到默认有default，这个文件是软链接至/etc/nginx/sites-avaible。我们可以在sites-available配置好后，然后在site-enabled链接好该文件，那么重启nginx后，配置就可以生效。

打开default，部分配置如下

```
# You may add here your
# server {
#	...
# }
# statements for each of your virtual hosts to this file

##
# You should look at the following URL's in order to grasp a solid understanding
# of Nginx configuration files in order to fully unleash the power of Nginx.
# http://wiki.nginx.org/Pitfalls
# http://wiki.nginx.org/QuickStart
# http://wiki.nginx.org/Configuration
#
# Generally, you will want to move this file somewhere, and start with a clean
# file but keep this around for reference. Or just disable in sites-enabled.
#
# Please see /usr/share/doc/nginx-doc/examples/ for more detailed examples.
##

server {
	listen 80 default_server;
	listen [::]:80 default_server ipv6only=on;

# 限制同一IP并发量最大为10
        limit_conn one 10;

root /usr/share/nginx/html;
	index index.html index.htm;

# Make site accessible from http://localhost/
	server_name localhost;

location / {
		# First attempt to serve request as file, then
		# as directory, then fall back to displaying a 404.
		try_files $uri $uri/ =404;
		# Uncomment to enable naxsi on this location
		# include /etc/nginx/naxsi.rules
	}
```

可以看到，nginx默认监听80端口，这里可以更改为自己想要的端口。
所以，这时我们可以访问localhost:80。如果显示有nginx的页面，说明nginx已经成功运行。
limit_conn one 10;为自己添加的内容，与结合limit_conn_zone $binary_remote_addr zone=one:10m;，可以有效防止cc攻击或者被压力测试(自己需要压力测试时，记得注释掉）

安装uwsgi
    1、安装uwsgi（这里装成功后版本为2.0.14, 版本查看命令uwsgi --version）
在ubuntu shell下输入：

```
sudo apt-get install libpcre3 libpcre3-dev
# 如果不进行上面一步，有可能导致uwsgi部分内容无法编译，出现!!! no internal routing support, rebuild with pcre support !!!的错误（http://stackoverflow.com/questions/21669354/rebuild-uwsgi-with-pcre-support）
sudo pip install uwsgi
```

2、检查uwsgi是否可以正常运行
建立一个简单的web test.py

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

然后执行uwsgi --http :8001 --wsgi-file test.py
如果访问127.0.0.1:8001能成功的话，说明uwsgi可以正常使用

二、连接django和uwsgi，实现简单的WEB服务器
项目目录如下：
/home/ctg/project/Blog
                              | ----- blog
                              |            | -----  models.py,   views.py,   forms.py, url.py
                              |
                              | ----- blog_project
                                           | ----- wsgi.py, settings,py,  url.py
其中，wsgi.py内容如下：

```python
import os
import sys 
from os.path import join,dirname,abspath
from django.core.wsgi import get_wsgi_application
 
PROJECT_DIR = dirname(dirname(abspath(__file__)))
sys.path.insert(0,PROJECT_DIR) 
 
os.environ["DJANGO_SETTINGS_MODULE"] = "blog_project.settings" 
 
application = get_wsgi_application()
```

在shell中运行

```
uwsgi --http :9001 --chdir /home/ctg/project/Blog/blog_project --module wsgi
```

如果访问127.0.0.1:9001能够成功，说明uwsgi与Django项目配合没有问题。

三、实现nginx与uwsgi、Django配合
    nginx与uwsgi通信可采用socket或者http的方式，一般使用socket的方式来配置。
    1、uwsgi配置
    uwsgi其实可以一直使用命令行的形式与Django配合，但这样的话服务器重启会比较麻烦，所以可以使用配置文件。它支持的配置文件有四种：ini（官方推荐），xml， json， yaml。
    在/home/ctg/project/blog_projec目录下（wsgi.py所在目录,其实可以在任意目录下，这里是为了管理方便)，新建bloguwsgi.ini配置如下：

```
[uwsgi]

socket = :9001

# the base directory(full path)
chdir = /home/ctg/project/Blog/blog_project

# Django's wsgi file
module = wsgi

# master = true

# worker nums. Because my CPU is dual-core processor, so it be 2.
processes = 2

# clear enviroment on exit
vacuum = true

# log file location: 表示log在ini所在目录，也可以用绝对路径定位
daemonize = uwsgi.log
log-maxsize = 50000000
# 忽略正常的请求
disable-logging = true
```

配置说明：
socket ： 地址和端口号，例如：socket = 127.0.0.1:50000 
processes ： 开启的进程数量
workers ： 开启的进程数量，等同于processes（官网的说法是spawn the specified number of  workers / processes）
chdir ： 指定运行目录（chdir to specified directory before apps loading）
wsgi-file ： 载入wsgi-file（load .wsgi file）
stats ： 在指定的地址上，开启状态服务（enable the stats server on the specified address）
threads ： 运行线程。由于GIL的存在，我觉得这个真心没啥用。（run each worker in prethreaded mode with the specified number of threads）
master ： 允许主进程存在（enable master process）
daemonize ： 使进程在后台运行，并将日志打到指定的日志文件或者udp服务器（daemonize uWSGI）。实际上最常用的，还是把运行记录输出到一个本地文件上。如果不配置此项，则直接输出到shell
log-maxsize ：以固定的文件大小（单位KB），切割日志文件。 例如：log-maxsize = 50000000  就是50M一个日志文件。
pidfile ： 指定pid文件的位置，记录主进程的pid号。
vacuum ： 当服务器退出的时候自动清理环境，删除unix socket文件和pid文件（try to remove all of the generated    file/sockets）
disable-logging ： 不记录请求信息的日志。只记录错误以及uWSGI内部消息到日志中。如果不开启这项，那么你的日志中会大量出现这种记录：
[pid: 347|app: 0|req: 106/367] 117.116.122.172 () {52 vars in 961 bytes} [Thu Jul  7 19:20:56 2016] POST /post => generated 65 bytes in 6 msecs (HTTP/1.1 200) 2 headers in 88 bytes (1 switches on core 0)

ps：xml方式的配置如下

```
<uwsgi>
    <socket>:9001</socket>
    <chdir>/home/ctg/project/Blog/blog_project</chdir>
    <module>wsgi</module>
    <processes>4</processes>
    <daemonize>uwsgi.log</daemonize>
</uwsgi>
```

注意，```<chdir></chdir>```要在同一行，否则可能后面会报错找不到目录

2、nginx配置
在/etc/nginx/sites-available下建立文件blog:

```
server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

# Make site accessible from http://localhost/
    server_name localhost;

location / {
      include uwsgi_params;
      uwsgi_pass 127.0.0.1:9001;
    }

location /static/ {
      alias /home/ctg/project/Blog/blog/static/;
    }

location /media/ {
      alias /home/ctg/project/Blog/blog/media/;
    }
}
```

说明：
location / {
      include uwsgi_params;
      uwsgi_pass 127.0.0.1:9001;
    }表示与uwsgi交互使用本机的9001端口
location /static/ 表示静态文件地址，与apache2部署类似。注意，当nginx与apache2同时生效时，uwsgi一般是由当前用户创建进程，所以客户端上传的文件所属是当前用户，而apache2用www-data身份开启的进程，所以用户上传的文件所属是www-data。这点要注意

然后在/etc/nginx/site-enabled中建立软连接，表示启用该配置：

```
ln -s /etc/nginx/sites-available/blog /etc/nginx/sites-enabled/blog
```

接着，重启nginx（sudo /etc/init.d/nginx restart），如果重启失败，则检查一些配置文件是否写对：

```
sudo nginx -t
# 或者sudo/etc/init.d/nginx configtest
```

四、启动uwsgi
    在/home/ctg/project/blog_project目录下，运行uwsgi blouwsgi.ini即可
然后，就可以访问server_name localhost;中的localhost:80来访问Django网站了。
如果要关闭服务，杀死uwsgi进程即可。

1. 上述架构说起来简单，但其实是一个很复杂的东西。基本上是由Nginx处理外部HTTP请求，静态请求自己处理，将动态请求转交给uWSGI。uWSGI则调用Django框架的app来对动态请求进行处理。

2. 在配置部署的时候，最好的办法是分块调试。先分别确认nginx、uWSGI、Django已经安装好了，可以正常运行。然后配置uWSGI和Django的连接。最后处理Nginx和uWSGI的连接以及upstart设置。

他们之间的关系如下:
1 首先nginx 是对外的服务接口，外部浏览器通过url访问nginx,
2nginx 接收到浏览器发送过来的http请求，将包进行解析，分析url，如果是静态文件请求就直接访问用户给nginx配置的静态文件目录，直接返回用户请求的静态文件，
  如果不是静态文件，而是一个动态的请求，那么nginx就将请求转发给uwsgi,uwsgi 接收到请求之后将包进行处理，处理成wsgi可以接受的格式，并发给wsgi,wsgi 根据请求调用应用程序的某个文件，某个文件的某个函数，最后处理完将返回值再次交给wsgi,wsgi将返回值进行打包，打包成uwsgi能够接收的格式，uwsgi接收wsgi 发送的请求，并转发给nginx,nginx最终将返回值返回给浏览器。
3要知道第一级的nginx并不是必须的，uwsgi完全可以完成整个的和浏览器交互的流程，但是要考虑到某些情况
  1 安全问题，程序不能直接被浏览器访问到，而是通过nginx,nginx只开放某个接口，uwsgi本身是内网接口，这样运维人员在nginx上加上安全性的限制，可以达到保护程序的作用。
  2负载均衡问题，一个uwsgi很可能不够用，即使开了多个work也是不行，毕竟一台机器的cpu和内存都是有限的，有了nginx做代理，一个nginx可以代理多台uwsgi完成uwsgi的负载均衡。
  3静态文件问题，用django或是uwsgi这种东西来负责静态文件的处理是很浪费的行为，而且他们本身对文件的处理也不如nginx好，所以整个静态文件的处理都直接由nginx完成，静态文件的访问完全不去经过uwsgi以及其后面的东西。
这就是这几者之间的关系。

其实也就是相当于nginx起了反向代理的作用，具体一些wsgi，cgi等可以参考下面的文章：

http://www.cnblogs.com/Xjng/p/aa4dd23918359c6414d54e4b972e9081.html

nginx + uWSGI + Django部署

附件: