美文网首页
django+nginx+gunicorn部署配置

django+nginx+gunicorn部署配置

作者: EarthChen | 来源:发表于2017-08-06 18:09 被阅读4296次

    在部署django开发的站点时,通常有两种选择方式,nginx+django+uwsgi或者django+nginx+gunicorn,本文不讨论apache方式,在linux下通常都使用nginx,速度快,还经常做代理服务器,功能强大。。
    nginx+django+uwsgi个人觉得uwsgi配置较为麻烦,所以选择了gunicorn,一个开源Python WSGI UNIX的HTTP服务器,据说速度快(配置快、运行快)、简单,默认是同步工作,支持Gevent、Eventlet异步,支持Tornado。有兴趣可以自行查阅官方文档

    django+nginx+gunicorn

    环境安装

    需要在服务器端安装我们所需要的环境nginx Python nginx gunicorn...
    django等站点需要的依赖将不进行介绍

    nginx

    在ubuntu上支持apt-get 直接安装,其他系统请自行搜索安装方式

    $ sudo apt-get install nginx
    

    gunicorn

    gunicorn只是一个Python的库 这里建议使用pip安装,简单方便
    ps:要么网络好,要么建议更改pip源为豆瓣源

    $ sudo pip install gunicorn
    

    注:

    • 如果没有pip需要首先安装pip
    • 如果是Python3 请使用pip3
    • 由于服务器就跑一个Python应用,就使用了全局安装,如果你的服务器上运行了多个Python应用,并使用了不同的环境(版本号),建议使用不同的虚拟环境

    环境配置

    其实也很简单,要想简单的跑起来只需要更改几个配置文件即可
    首先请把你的django站点放在服务器合适的地方

    nginx配置

    一般网站都配置在80端口上,域名默认解析到80端口,所以nginx配置文件如下,在更改nginx的配置文件之前建议把默认文件进行备份,以备后续出现问题参照使用
    打开nginx配置文件/etc/ningx/sites-enable/default
    进行修改为如下内容:

    server {
        listen 80;
        server_name 192.168.84.199;
        server_name_in_redirect off;
        access_log /home/webserver/web/nginx.access.log;
        error_log /home/webserver/web/nginx.error.log;
    
        location / {
            proxy_pass http://127.0.0.1:8000;
            proxy_pass_header       Authorization;
            proxy_pass_header       WWW-Authenticate;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    
        location /static/ {
            root /home/webserver/web/WebServer/;
        }
    
    

    核心配置文件就上述那么多,重点使将请求转发到django的服务器上

    注:

    • listen是所需要监听的端口
    • server_name是需要绑定的域名,暂时没有域名时,请使用ip
    • access_log是确定正常状态下log文件位置
    • error_log使确定发生错误时log文件位置
    • location / 是当访问到根下的时候,将所有请求转发到127.0.0.1:8000,本文使转发到gunicorn启动的django应用上,中间配置的是需要转发的内容,基本上述内容可以满足大多需求,如需特殊需求请自行查看nginx官方文档
    • location /static/ 配置了静态文件所在的路径,静态文件由nginx处理,动态转发到django,如不配置会出现站点引用的所有js css都找不到

    gunicorn配置

    gunicorn启动一般有两种方式,可以在项目目录下建立gunicorn.conf.py配置文件,也可以在启动gunicorn时直接加上相关命令

    需要在项目的settings.py中的INSTALLED_APPS添加gunicorn:

    INSTALLED_APPS = [
        ...
        ...
        'gunicorn',  # 部署用
    ]
    

    gunicorn.conf.py文件

    import multiprocessing
    
    bind = "127.0.0.1:8000"   #绑定的ip与端口
    workers = 2                #核心数
    errorlog = '/home/xxx/xxx/gunicorn.error.log' #发生错误时log的路径
    accesslog = '/home/xxx/xxx/gunicorn.access.log' #正常时的log路径
    #loglevel = 'debug'   #日志等级
    proc_name = 'gunicorn_project'   #进程名
    

    如还需要其他配置,可以自行查看官方文档

    直接使用gunicron启动

    gunicron需要启动后需要长期运行在后台,如果直接启动会在关闭终端后进程就被杀死,这肯定不是我们的需求,所以这里给出两种解决方式

    1. 使用Linux自带的nohup命令
      不使用gunicorn配置文件(需进入项目目录)
    $ sudo nohup gunicorn 项目名.wsgi:application -b 127.0.0.1:8000&
    

    使用配置文件方式

    $ sudo nohup gunicorn 项目名.wsgi:application -c /home/xxx/xxx/gunicorn.conf.py& 
    
    1. 使用supervistor进程管理器
      supervistor这个工具的用法这里就不在多讲,需要了解可以看我的另一篇博客ubuntu下的进程控制系统—Supervisor,也可以直接查看官方文档
      用法可以参照我的配置文件:
    [program:x508server]
    command=gunicorn x508server.wsgi:application -b 0.0.0.0:8000  ; 被监控的进程路径
    directory=/home/webserver/web/WebServer/               ; 执行前要不要先cd到目录$
    autostart=true                ; 随着supervisord的启动而启动
    autorestart=true              ; 自动重启。。当然要选上了
    startretries=10               ; 启动失败时的最多重试次数
    exitcodes=0                   ; 正常退出代码
    stopsignal=KILL               ; 用来杀死进程的信号
    stopwaitsecs=10               ; 发送SIGKILL前的等待时间
    redirect_stderr=true          ; 重定向stderr到stdout
    stdout_logfile=/home/webserver/web/logfile.log        ; 指定日志文件
    ; 默认为 false,如果设置为 true,当进程收到 stop 信号时,会自动将该信号发给该进$
    stopasgroup=true             ; send stop signal to the UNIX process
    ; 默认为 false,如果设置为 true,当进程收到 kill 信号时,会自动将该信号发给该进$
    killasgroup=true             ; SIGKILL the UNIX process group (def false)
    

    启动站点

    1. 加载nginx配置文件重启nginx
    $ sudo service nginx reload
    $ sudo service nginx restart 
    //执行一种即可
    
    1. 启动gunicorn
    • 如果使用supervistor:
    $ sudo supervisorctl reload
    
    • 如果使用nohup
    $ sudo nohup gunicorn 项目名.wsgi:application -b 127.0.0.1:8000&
    

    特殊配置

    1. 在一些前后端分离项目,可能还需要配置前端静态页面,此时就不能将所有url都转发到django了,需要配置一个前缀,但此时,django自带的后台管理也会出现问题,建议配置一个/admin,所以,最后我的配置nginx文件如下:
    server {
        listen 80;
        server_name 192.168.84.199;
        server_name_in_redirect off;
        access_log /home/webserver/web/nginx.access.log;
        error_log /home/webserver/web/nginx.error.log;
    
        index login.html;
        root /home/webserver/web/html/WebHtml/;
    
        location / {
            try_files $uri $uri/ =404;
        }
    
        location /apis {
            rewrite ^.+apis/?(.*)$ /$1 break;
            proxy_pass http://127.0.0.1:8000;
            proxy_pass_header       Authorization;
            proxy_pass_header       WWW-Authenticate;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    
        location /admin {
            proxy_pass http://127.0.0.1:8000;
            proxy_pass_header       Authorization;
            proxy_pass_header       WWW-Authenticate;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    
        }
    
        location /static/ {
            root /home/webserver/web/WebServer/;
        }
    
    1. 收集使用的admin或者其他库含有的静态文件
      在django项目的settings.py添加如下代码:
    # 收集app静态文件到项目目录使nginx能访问到
    STATIC_ROOT = os.path.join(BASE_DIR, "static")
    
    # 执行python manage.py collectstatic
    STATICFILES_FINDERS = (
        "django.contrib.staticfiles.finders.FileSystemFinder",
        "django.contrib.staticfiles.finders.AppDirectoriesFinder"
    )
    

    然后在终端中进入项目目录在终端执行:

    $ python manage.py collectstatic
    

    将会自动将app中所含有的静态文件自动收集到项目的setting目录下,解决了某些app,比如admin在部署后找不到静态文件的现象

    注:

    • 上述环境在ubuntu16.04 lts中搭建测试成功
    • 上述文字皆为个人看法,如有错误或建议请及时联系我

    相关文章

      网友评论

          本文标题:django+nginx+gunicorn部署配置

          本文链接:https://www.haomeiwen.com/subject/cwknlxtx.html