Django+uWSGI+Nginx部署原理及配置详解

100人浏览 2025-04-03 00:49:11

一、Django+uWSGI+Nginx 组件原理

Django本身只是一个基于Python语言写的一个开源WEb框架，不具备服务器网关功能。如果我们想通过外网访问Django项目，那么我们做为客户端，首先向服务端发出请求，这时服务端有一个对外服务的组件或接口（如Nginx、Apache等）接收客户端发来的HTTP请求，并对这个请求进行解包分析，如果是静态文件请求就根据Nginx配置的静态文件目录，直接返回请求的资源；如果是动态的请求,Nginx就通过配置文件,将请求传递给uWSGI；然后uWSGI 将接收到的包进行处理，并转发给wsgi，wsgi根据请求调用django工程的某个文件或函数，处理完后django将返回值交给wsgi，最后wsgi将返回值进行打包，转发给uWSGI，uWSGI接收后转发给Nginx，Nginx最终将返回值返回给客户端。

Django+uWSGI+Nginx 组件之间的工作流程图：

wsgi:

django项目携带的一个wsgi接口文件，如果项目名叫myblog的话，此文件就位于[myblog/myblog/wsgi.py]目录，它一种实现python解析的通用接口标准/协议，实现了python web程序与服务器之间交互的通用性。利用它，作为django的python web开发框架，就可以轻松地部署在不同的web server上了。

uWSGI：

一个基于自有的uwsgi协议、wsgi协议和http服务协议的web网关。它是一种python web server，或者称为Server/Gateway。uWSGI是实现了uwsgi和WSGI两种协议的Web服务器，负责响应python的web请求。

Nginx：

一个常用的高性能代理服务器。它自己没有解析动态语言的功能。所以分给其它模块来完成工作。在Django部署中，uWSGI实现了wsgi协议、uwsgi协议、http等协议，所以Nginx中的Uwsgi模块的作用是与uWSGI服务器进行交换。

我们部署的时候，需要使用Nginx和uWSGI组合部署django。

Nginx的作用：

1. 其实nginx并不是必须的，uwsgi完全可以完成整个的和浏览器交互的流程；

2. 在nginx上加上安全性或其他的限制，可以达到保护程序的作用；

3. uWSGI本身是内网接口，开启多个work和processes可能也不够用，而nginx可以代理多台uWSGI完成uWSGI的负载均衡；

4. django对静态文件的处理能力不是很好，而用nginx来处理更加高效。

二、安装与部署

首先，确保服务器安装好了Python环境。如果没有请安装。因为大部分Linux自带的Python版本与Django所需要的版本不一致，或者想要安装部署多个版本的Django或Python，所以一般推荐使用virtualenv，通过虚拟环境来部署。

其次，确保安装好Nginx，并能正常运行。

然后，确保安装好了Django及所需的依赖框架包。测试方法: python manage.py runserver 0.0.0.0:8000

最后，安装uWSGI： pip install uwsgi

上面都没问题了，就配置Nginx和uWsig。假设我们的django项目名为mysite，位于/www/wwwroot/mysite目录下。

uWsig配置

1. 在项目文件里创建 uwsgi.ini 文件,配置uwsgi：

#添加配置选择
[uwsgi]
#配置和nginx连接的socket连接
socket=0.0.0.0:8001
#配置项目路径，项目的所在目录
chdir=/www/wwwroot/mysite/
#配置wsgi接口模块文件路径,也就是wsgi.py这个文件所在的目录名
wsgi-file=mysite/wsgi.py
#配置启动的进程数
processes=4
#配置每个进程的线程数
threads=2
#配置启动管理主进程
master=True
#配置存放主进程的进程号文件
pidfile=uwsgi.pid
#配置dump日志记录
daemonize=uwsgi.log

2.通过下面的命令启动运行uwsgi

uwsgi --ini uwsgi.ini

显示 [uWSGI] getting INI configuration from uwsgi.ini 表明uwsgi运行成功

可能通过ps -ef|grep uwsgi 命令查看确认是否uwsgi启动.

uwsg.ini配置文件其它相关命令:

#停止运行uwsgi，通过包含主进程编号的文件设置停止项目
uwsgi --stop uwsgi.pid
#重启uwsgi
uwsgi --reload uwsgi.pid

Nginx配置

vi /usr/local/nginx/conf/nginx.conf

events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    server {
        listen 80;
        server_name  www.django.cn; #改为自己的域名，没域名可修改为：本机IP:80
        charset utf-8;
        location / {
           include uwsgi_params;
           uwsgi_pass 127.0.0.1:8001;  #端口要和uwsgi里配置的一样
        }
        location /static/ {
        alias /www/wwwroot/mysite/static/; #静态资源路径
        }
    }
}