Hello! 欢迎来到盒子萌！

Single
程序开发

django+nginx+gunicorn部署配置

avatar
bgspider 2024-12-05 30
0 评论

在部署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 123$ sudo service nginx reload$ sudo service nginx restart //执行一种即可
  2. 启动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在部署后找不到静态文件的现象

暂无评论

当前仅支持登录后发布评论