uwsgi+nginx部署django项目

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

　　参考：https://www.cnblogs.com/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最终将返回值返回给客户端(如浏览器)。

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

　　整个流程如下图所示：

　　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/python
def 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了）

　　　　(注意：1. --http和 :8000之间有空格，否则会报错unrecognized ...

　　　　　　　2. 在项目根目录下运行上述命令，即notebook项目文件夹下，否则报错import error notebook.wsgi)

　　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 to
upstream 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 server
server {
    # the port your site will be served on
    listen      8008;
    # the domain name it will serve for
    # substitute your machine's IP address or FQDN
    # Django 的 settings.py 文件中的 ALLOWED_HOSTS 要加上这里设置的 server_name
    server_name localhost;
    charset     utf-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 logs
    access_log  /var/log/nginx/ocean_monitor_access.log;
    error_log   /var/log/nginx/ocean_monitor_error.log;

    # max upload size
    client_max_body_size 8M;   # adjust to taste

    # Django media
    location /media  {
        # your Django project's media files - amend as required
        alias /home/python/ocean_monitor/media;  
    }

    location /static {
        # your Django project's static files - amend as required
        alias /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; 
    }
}

　

　　 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 SETTINGS
STATIC_URL = '/static/'
# BASE_DIR 是项目的绝对地址
STATIC_ROOT = os.path.join(BASE_DIR, 'collect_static')
#以下不是必须的
STATICFILES_DIRS = (
 os.path.join(BASE_DIR, 'common_static'),
)

1.STATIC_ROOT

STATIC_ROOT 是在部署静态文件时(pyhtonmanage.pycollectstatic)所有的静态文静聚合的目录,STATIC_ROOT要写成绝对地址,在这里,比如我的项目mysite是/home/mysite/

那么STATIC_ROOT 为 /home/mysite/collect_static/

当部署项目时,在终端输入:
?
1
    
python manage.py collectstatic

django会把所有的static文件都复制到STATIC_ROOT文件夹下

2.STATICFILES_DIRS

STATIC_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来让浏览器可以直接访问静态文件,比如:
?
1
    
STATIC_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

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。

 　　　　3.6.2 ALLOWED_HOSTS和DEBUG设置     

　　　　　　　修改settings.py文件中的ALLOWED_HOSTS和DEBUG (https://www.cnblogs.com/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.log
pidfile=%(chdir)/uwsgi.pid

　　　　其中的socket字段值”127.0.0.1:9090”必须要和上面写的notebook.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 file
wsgi-file       = /home/python/ocean_monitor/ocean_monitor/wsgi.py
# module       = index.wsgi:application
# the virtualenv (full path)
# home            = /path/to/virtualenv
daemonize   = /home/python/ocean_monitor/ocean_monitor.log
# process-related settings
# master
master          = true
pidfile     = /tmp/ocean_monitor_master.pid
# maximum number of worker processes
processes       = 3
# the socket (use the full path to be safe
# socket          = /home/python/ocean_monitor/ocean_monitor.sock
socket          = 127.0.0.1:8108
# ... with appropriate permissions - may be needed
chmod-socket    = 664
# clear environment on exit
vacuum          = true

　　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.svg
gis                 icon-changelink.svg  icon-unknown-alt.svg  LICENSE            sorting-icons.svg
icon-addlink.svg    icon-clock.svg       icon-unknown.svg      README.txt         tooltag-add.svg
icon-alert.svg      icon-deletelink.svg  icon-yes.svg          search.svg         tooltag-arrowright.svg

./collect_static/admin/img/gis:
move_vertex_off.svg  move_vertex_on.svg

./collect_static/admin/js:
actions.js      cancel.js        core.js         popup_response.js    SelectBox.js      vendor
actions.min.js  change_form.js   inlines.js      prepopulate_init.js  SelectFilter2.js
admin           collapse.js      inlines.min.js  prepopulate.js       timeparse.js
calendar.js     collapse.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.py
mime.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

4. 管理进程

https://code.ziqiangxuetang.com/django/django-deploy-base.html

https://code.ziqiangxuetang.com/django/django-nginx-deploy.html

5.阿里云部署

　　1.远程连接设置：https://www.jianshu.com/p/962ff16a951c

　　2.部署：按上述配置好django，uwsgi，nginx，本地通过127.0.0.1能访问网页，表示配置成功。

　　3.入站和出站规则设置（安全组）：https://blog.csdn.net/A11085013/article/details/79486731

　　设置完成后通过实例公网ip地址就能访问网页（公网ip地址在django的allowed_host，nginx的端口80加入了入站规则）

参考：https://blog.csdn.net/c465869935/article/details/53242126

　　https://www.cnblogs.com/restran/p/4412708.html

　　https://www.cnblogs.com/simplezy/p/6705340.html