uwsgi+nginx部署django项目(有图原理的详细展示的)

1.概念解析（wsgi协议，uwsgi协议，uWSGI）

参考：/wspblog/p/8575101.html

1.1 现实世界的web请求：

1.2 wsgi协议，uwsgi协议和uWSGI

a. WSGI(wsgi): 全称 Web Server Gateway Interface，或者 Python Web Server Gateway Interface ，是为 Python 语言定义的 Web 服务器和 Web 应用程序或框架之间的一种简单而通用的接口。从名字就可以看出来，这东西是一个Gateway，也就是网关。网关的作用就是在协议之间进行转换。

总结：WSGI(wsgi)只是一种规范，描述web server如何与web application通信的规范

b. uWSGI:uWSGI是一个Web服务器，它实现了WSGI协议、uwsgi、http等协议。

c. uwsgi:与WSGI一样是一种通信协议，但与WSGI协议是两种东西，uwsgi协议是uWSGI服务器的独占协议，用于定义传输信息的类型(type of information)，每一个uwsgi packet前4byte为传输信息类型的描述.

下图简单描述在web请求过程中三者的位置：

2. web请求流程

1，首先客户端请求服务资源，

2，nginx作为直接对外的服务接口,接收到客户端发送过来的http请求,会解包、分析，如果是静态文件请求就根据nginx配置的静态文件目录，返回请求的资 源，如果是动态的请求,nginx就通过配置文件,将请求传递给uWSGI；

3，uWSGI 将接收到的包进行处理，并转发给wsgi， wsgi根据请求调用django工程的某个文件或函数，处理完后django将返回值交给wsgi，wsgi将返回值进 行打包，转发给uWSGI， uWSGI接收后转发给nginx,nginx最终将返回值返回给客户端(如浏览器)。

*注:不同的组件之间传递信息涉及到数据格式和协议的转换

整个流程如下图所示：

作用:

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

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

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

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

3. 部署环境及准备

购买服务器（国外谷歌云，亚马逊aws；国内阿里云，腾讯云等），需安装：python，django，uwsgi、nginx、libmysqld-dev、mysql-server;

3.1. 安装和测试uWSGI

安装sudo pip install uwsgi测试：新建test.py,内容如下#/usr/bin/pythondef application(env, start_response):start_response(‘200 OK‘, [(‘Content-Type‘,‘text/html‘)])return "Hello World"运行 uwsgi --http 0.0.0.0:8000 --wsgi-file test.py浏览器访问 http://127.0.0.1:8000 页面出现Hello World，则安装成功（问题：若8000端口被占用，换其他端口； uwsgi找不到命令，建立软连接 sudo ln -s /your-python-dir/bin/uwsgi /usr/bin/uwsgi）

3.2 安装和测试nginx

安装：sudo yum install nginx

启动：sudo nginx (ps -aux| grep nginx 查看nginx进程)

测试：浏览器访问http://127.0.0.1:80 (命令行 curl http://127.0.0.1:80)，返回nginx则运行正常

其他nigix命令：

启动：nginx

退出或重启：nginx -s stop(quit, reload)

命令帮助： nginx -h

验证配置文件 nginx -t

3.3 建立django 项目和测试

创建项目：django-admin.py startproject notebook （找不到命令时 ：/usr/local/python-3.5.2/bin/django-admin.py startproject notebook）

创建app：python manage.py startapp planlist (并在settings.py文件的INSTALLED_APPS中添加planlist.apps.PlanlistConfig)

运行测试: python manage.py runserver 127.0.0.1:8000 (浏览器打开http://127.0.0.1:8000, 出现django页面，项目创建成功)

3.4 uWSGI运行django项目测试

关闭上述django项目后，运行命令：uwsgi --http :8000 --module notebook.wsgi

（notebook为django项目名称，创建django项目时notebook文件夹下自动创建wsgi.py文件）

测试：在浏览器访问http://127.0.0.1:8000，出现django页面，表示web-client <-> uWSGI <-> Django 是连通的。（就剩下nginx了）

3.5 nginx配置和测试

找到nginx默认的配置文件路径：/etc/nginx/nginx.conf（ 通过命令可以查看：sudo nginx -t），确保nginx.conf的同目录下有uwsgi_params文件(/etc/nginx/uwsgi_params)，没有的话根据链接获取。

在django项目目录下，创建单独的nginx配置文件notebook.conf （notebook/notebook/notebook.conf），将nginx.conf的内容复制到notebook.conf，将其中的server部分全部替换成下面：

server {

listen 80;

server_name localhost;

charset utf-8;

access_log /home/gCloud/djangoProject/notebook/notebook/nginx_access.log;

error_log /home/gCloud/djangoProject/notebook/notebook/nginx_error.log;

client_max_body_size 75M;

# Load configuration files for the default server block.

location /static {

alias /home/gCloud/djangoProject/notebook/collect_static;

}

location / {

include /etc/nginx/uwsgi_params;

uwsgi_pass 127.0.0.1:9090;

}

}

其中的 listen 80代表服务器开放80端口；

access_log 和error_log是定义nginx访问日志和错误日志的存放路径。

location [目录名]代表项目路径的引导;

“location /static”中的”/static”是自己定义的项目引用静态文件时，浏览器中显示的静态资源所在的根目录名;这样的话，用户在浏览器中查看到的所有image,css或js资源都是处在http://127.0.0.1/static下的。(django静态文件的绝对路径是根据自己的实际情况来确定的，一般在自己的django的app名/static目录下,或自己python manage.py collectstatic后的路径下。)

如果还有media文件之类的静态目录，仿照static的写法，自己补充。

“location /”是指访问项目根目录时，nginx要做的事。其中需要指定 uwsgi_params文件的绝对路径，上面已经提到了；

127.0.0.1:9090是指uWSGI绑定的监听地址，这里使用了9090端口。

nginx配置参考及含义：

# ocean_monitor.conf# the upstream component nginx needs to connect toupstream django_ocean_monitor {# server unix:///path/to/your/mysite/mysite.sock; # for a file socket# for a web port socket (we‘ll use this first)server 127.0.0.1:8108;}# configuration of the serverserver {# the port your site will be served onlisten8008;# the domain name it will serve for# substitute your machine‘s IP address or FQDN# Django 的 settings.py 文件中的 ALLOWED_HOSTS 要加上这里设置的 server_nameserver_name localhost;charsetutf-8;gzip on;gzip_min_length 1000;gzip_buffers 4 16k;gzip_http_version 1.1;gzip_comp_level 3;gzip_vary on;# 禁用对 IE 6 使用 gzip 压缩gzip_disable "MSIE [1-6]\.";gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml application/xml+rss application/json;## Individual nginx logsaccess_log /var/log/nginx/ocean_monitor_access.log;error_log /var/log/nginx/ocean_monitor_error.log;# max upload sizeclient_max_body_size 8M; # adjust to taste# Django medialocation /media {# your Django project‘s media files - amend as requiredalias /home/python/ocean_monitor/media; }location /static {# your Django project‘s static files - amend as requiredalias /home/python/ocean_monitor/static; }# Finally, send all non-media requests to the Django server.location / {uwsgi_pass django_ocean_monitor;# the uwsgi_params file you installed# 增加 nginx 配置， uwsgi_params 文件在 /etc/nginx/ 目录下include/etc/nginx/uwsgi_params; }}

nginx配置参考

3.6 django配置

3.6.1静态文件

在settings.py文件中设置：

STATIC_URL = ‘/static/‘

STATIC_ROOT = os.path.join(BASE_DIR,‘collect_static‘)

运行命令：python manage.py collectstatic （所有静态文件会储存到collect_static文件夹中）

关于STATIC_ROOT和STATIC_URL及STATICFILES_DIRS作用和区别，参见下面

本文主要给大家介绍关于Django中STATIC_ROOT和STATIC_URL及STATICFILES_DIRS的相关内容，分享出来供大家参考学习，下面话不多说了，来一起看看详细的介绍吧。详细如下：首先,我们配置静态文件,要在setting.py里面加入如下几行代码:settings.py # the settings above# STATIC SETTINGSSTATIC_URL = ‘/static/‘# BASE_DIR 是项目的绝对地址STATIC_ROOT = os.path.join(BASE_DIR, ‘collect_static‘)#以下不是必须的STATICFILES_DIRS = (os.path.join(BASE_DIR, ‘common_static‘),)1.STATIC_ROOTSTATIC_ROOT 是在部署静态文件时(pyhtonmanage.pycollectstatic)所有的静态文静聚合的目录,STATIC_ROOT要写成绝对地址,在这里,比如我的项目mysite是/home/mysite/那么STATIC_ROOT 为 /home/mysite/collect_static/当部署项目时,在终端输入:?1python manage.py collectstaticdjango会把所有的static文件都复制到STATIC_ROOT文件夹下2.STATICFILES_DIRSSTATIC_ROOT 是在部署的时候才发挥作用, 而实际情况下,静态文件的一般安放位置有两种:1.一种就是在每个app里面新建一个static文件夹,将静态文件放到里面,在加载静态文件时,比如要在模板中用到静态文件,django会自动在每个app里面搜索static文件夹(所以,不要把文件夹的名字写错哦, 否则django就找不到你的文件夹了)2.另一种,就是在所有的app文件外面,建立一个公共的文件夹, 因为有些静态文件不是某个app独有的,那么就可以把它放到一个公共文件夹里面,方便管理(注意,建立一个公共的静态文件的文件夹只是一种易于管理的做法,但是不是必须的,app是可以跨app应用静态文件的,因为最后所有的静态文件都会在STATIC_ROOT里面存在)那现在的问题是如何让django知道你把一些静态文件放到app以外的公共文件夹中呢,那就需要配置STATICFILES_DIRS了STATICFILES_DIRS = (os.path.join(BASE_DIR, ‘common_static‘),)STATICFILES_DIRS告诉django,首先到STATICFILES_DIRS里面寻找静态文件,其次再到各个app的static文件夹里面找(注意, django查找静态文件是惰性查找,查找到第一个,就停止查找了)3.STATIC_URL那么到此为止,静态文件的机制就可以运作了,但是有一个问题,我能不能通过url直接访问我在项目中的静态文件呢,答案肯定是啦,但是,注意,你是在浏览器是访问,你不可能输入你的静态文件的本地绝对地址吧,比如我的一种图片的本地地址为 /home/mysite/common_static/myapp/photo.png那么别人不可能在浏览器上直接输入:http://192.168.1.2:8000/home/mysite/common_static/myapp/photo.png这样子,浏览器会报错, 没有该页面那么django是如何让浏览器也可以访问服务器上的静态文件呢,前面已经说了,直接访问服务器本地的地址是不行的,那就需要一个映射,django利用STATIC_URL来让浏览器可以直接访问静态文件,比如:?1STATIC_URL = ‘/static/‘那么可以在浏览器上输入:http://192.168.1.2:8000/static/common_static/myapp/photo.png那么就相当与访问/home/mysite/common_static/myap/photo.png所以在浏览器上,利用前缀 STATIC_URL的具体内容,来映射STATIC_ROOT,HTTP://192.168.1.2:8000/static 相当于 本地地址的STATIC_ROOT总结以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。

STATIC_ROOT和STATIC_URL及STATICFILES_DIRS

3.6.2ALLOWED_HOSTS和DEBUG设置

修改settings.py文件中的ALLOWED_HOSTS和DEBUG (/restran/p/4412708.html)

DEBUG = False #关闭debug模式ALLOWED_HOSTS = [# 加上本机的IP地址‘192.168.137.146‘,‘127.0.0.1‘, ‘localhost‘]#或者设置#ALLOWED_HOSTS = [‘*‘]

3.7 uWSGI配置(官方文档：https://uwsgi-docs.readthedocs.io/en/latest/Management.html#signals-for-controlling-uwsgi)

在项目目录下创建配置文件uwsgi.ini，内容如下：

[uwsgi] socket = 127.0.0.1:9090 chdir=/home/gCloud/djangoProject/notebook module=notebook.wsgi master = true processes=2 threads=2 max-requests=2000 chmod-socket=664 vacuum=true daemonize =/home/gCloud/djangoProject/notebook/uwsgi.logpidfile=%(chdir)/uwsgi.pid

其中的socket字段值”127.0.0.1:9090”必须要和上面写的density.conf配置文件中的uWSGI监听地址完全一样;

chdir指自己工程的绝对路径;

module指的是wsgi.py在自己工程中的相对路径，”.”指代一层目录;我的django工程的wsgi.py文件是在”/home/gCloud/djangoProject/notebook/notebook/wsgi.py”，所以写notebook.wsgi;

daemonize指定uWSGI日志的存储路径

pidfile设置后，通过下面--ini命令启动uwsgi时，会在该目录下自动创建uwsgi.pid文件，里面存储了uwsgi的pid号（进程号）

uwsgi配置参考及含义:

# uwsgi.ini file[uwsgi]# Django-related settings# the base directory (full path)chdir = /home/python/ocean_monitor# Django‘s wsgi filewsgi-file = /home/python/ocean_monitor/ocean_monitor/wsgi.py# module = index.wsgi:application# the virtualenv (full path)# home = /path/to/virtualenvdaemonize = /home/python/ocean_monitor/ocean_monitor.log# process-related settings# mastermaster= truepidfile= /tmp/ocean_monitor_master.pid# maximum number of worker processesprocesses = 3# the socket (use the full path to be safe# socket= /home/python/ocean_monitor/ocean_monitor.socksocket= 127.0.0.1:8108# ... with appropriate permissions - may be neededchmod-socket = 664# clear environment on exitvacuum= true

uwsgi配置参考

3.8 启动uWSGI

sudo uwsgi --ini /home/gCloud/djangoProject/notebook/uwsgi.ini

其他命令：

停止uwsgi服务器：sudo uwsgi --stop/home/gCloud/djangoProject/notebook/uwsgi.pid

重启：sudo uwsgi --reload /home/gCloud/djangoProject/notebook/uwsgi.pid

（如果出现错误 signal_pidfile()/kill(): No such process [core/uwsgi.c line 1627]，是由于uwsgi.pid中进程pid号不正确，通过命令 ps -aux | grep uwsgi 查看进程pid号，修改uwsgi.pid文件为该pid号即可）

3.9 启动 nginx

sudo nginx -c /home/gCloud/djangoProject/notebook/notebook/notebook.conf

(注意若nginx正在运行，先关闭：sudo nginx -s stop)

最后打开浏览器输入 http://127.0.0.1，就能访问django项目的网页了，每次修改django项目文件的代码需要重启uwsgi和nginx才生效。

3.10 相关的文件路径梳理

django项目路径:/home/gCloud/djangoProject/notebook (项目名为notebook)

工程静态文件路径: /home/gCloud/djangoProject/notebook/collect_static

wsgi.py的路径: /home/gCloud/djangoProject/notebook/notebook/wsgi.py

uwsgi.ini的路径: /home/gCloud/djangoProject/notebook/uwsgi.ini

uwsgi日志路径: /home/gCloud/djangoProject/notebook/uwsgi.log

uwsgi.pid路径：/home/gCloud/djangoProject/notebook/uwsgi.pid

nginx配置文件notebook.conf的路径: /home/gCloud/djangoProject/notebook/notebook/notebook.conf

uwsgi_params的路径: /etc/nginx/uwsgi_params

nginx访问日志路径:/home/gCloud/djangoProject/notebook/notebook/nginx_access.log

nginx错误日志路径: /home/gCloud/djangoProject/notebook/notebook/nginx_error.log

项目路径完整显示如下：

[gCloud@instance-1 notebook]$ ls -R.:collect_static db.sqlite3 manage.py notebook planlist templates uwsgi.ini uwsgi.log uwsgi.pid./collect_static:admin./collect_static/admin:css fonts img js./collect_static/admin/css:base.css changelists.css dashboard.css fonts.css forms.css login.css rtl.css widgets.css./collect_static/admin/fonts:LICENSE.txt README.txt Roboto-Bold-webfont.woff Roboto-Light-webfont.woff Roboto-Regular-webfont.woff./collect_static/admin/img:calendar-icons.svg icon-calendar.svg icon-no.svg inline-delete.svg selector-icons.svggis icon-changelink.svg icon-unknown-alt.svg LICENSE sorting-icons.svgicon-addlink.svg icon-clock.svg icon-unknown.svgREADME.txt tooltag-add.svgicon-alert.svgicon-deletelink.svg icon-yes.svgsearch.svg tooltag-arrowright.svg./collect_static/admin/img/gis:move_vertex_off.svg move_vertex_on.svg./collect_static/admin/js:actions.jscancel.js core.js popup_response.js SelectBox.jsvendoractions.min.js change_form.js inlines.jsprepopulate_init.js SelectFilter2.jsadmin collapse.jsinlines.min.js prepopulate.js timeparse.jscalendar.jscollapse.min.js jquery.init.js prepopulate.min.js urlify.js./collect_static/admin/js/admin:DateTimeShortcuts.js RelatedObjectLookups.js./collect_static/admin/js/vendor:jquery xregexp./collect_static/admin/js/vendor/jquery:jquery.js jquery.min.js LICENSE-JQUERY.txt./collect_static/admin/js/vendor/xregexp:LICENSE-XREGEXP.txt xregexp.js xregexp.min.js./notebook:__init__.py nginx_access.log notebook.conf settings.py wsgi.pymime.types nginx_error.log __pycache__ urls.py./notebook/__pycache__:__init__.cpython-35.pyc settings.cpython-35.pyc urls.cpython-35.pyc wsgi.cpython-35.pyc./planlist:admin.py apps.py __init__.py migrations models.py __pycache__ tests.py views.py./planlist/migrations:__init__.py __pycache__./planlist/migrations/__pycache__:__init__.cpython-35.pyc./planlist/__pycache__:admin.cpython-35.pyc apps.cpython-35.pyc __init__.cpython-35.pyc models.cpython-35.pyc views.cpython-35.pyc./templates:index.html

notebook

参考：/c465869935/article/details/53242126

/restran/p/4412708.html

/simplezy/p/6705340.html

来源:/info-detail-2611327.html