Gunicorn + Supervisor + Nginx 部署 Django 项目

1.环境准备

参考我之前部署 Flask 时候的笔记： Flask + Gunicorn + Supervisor 简易部署 web 应用 和 Nginx 处理静态文件，把 Gunicorn ，Supervisor 和 Nginx 都安装好。

当然记得安装 Django：

pip3 install django==1.11

（这里我使用 Django1.11 版本）

---

2. Django 项目

在上传我们的 Django 项目之前，需要做好几点准备。

1. 把 setting.py 的 DEBUG 选项改成 False，只有关闭了调试模式，后面才能让 Nginx 来寻找静态文件。

2. 把 setting.py 的 ALLOW_HOSTS，加入服务器的域名，（或，和）服务器 ip。还可以加上 127.0.0.1 方便本地观察。

3. 在 setting.py 中设置 STATIC_ROOT，建议可以直接设为：

STATIC_ROOT = os.path.join(BASE_DIR, 'static')

也就是直接把静态文件目录放在项目的根目录下。

4. 执行 python manage.py collectstatic 命令，该命令会把开发时分散在各个 app 文件夹里的静态文件全部收集到第3步设置的 STATIC_ROOT 路径中。

经过以上步骤之后，我们 Django 项目的文件结构应该是这样的：

/myproject
    /myapp  # app文件夹
        /migrations
        /static # 开发时候各个app静态文件放置在各个app文件夹里
            /css
            /js
            /image
        /templates # myapp的模板文件夹
        /__init__.py
        /admin.py
        /apps.py
        /models.py
        /tests.py
        /views.py
    /myproject
        /__init__.py
        /setting.py
        /urls.py
        /wsgi.py
    /static  # 执行完collectstatic之后会把所有静态文件都放在这里
        /admin
        /css
        /js
        /image
    /db.sqlite3
    /manage.py

5. 在 urls.py 中添加处理静态文件的相关设置：

from tutorial import settings
from django.conf.urls.static import static

urlpatterns = [
   …………
]

urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

完成这些步奏后，现在我们把 Django 项目上传到 /home/my-django 路径下。

---

3. 配置 Nginx

Nginx 的默认配置文件在：/etc/nginx/sites-available 路径下，该路径下有一个 default 文件，把它复制备份后我们修改 default 文件：

server {  
    # 监听 80 端口
    listen 80;  
  
    # 这里填写你的服务器 ip（暂时没绑定域名）
    server_name 111.11.111.11;  
  
    # 把 111.11.111.11/ 的数据转发给 8080 端口
    # 等下我们使用 gunicorn 让 django 监听 8080 端口
    # 等于把接收到的请求交给 django 处理
    location / {  
        proxy_pass http://0.0.0.0:8080;  
        proxy_set_header Host $host;  
        proxy_set_header X-Real-IP $remote_addr;  
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
    }  

    # 处理静态文件的部分
    # /static 表示遇到带 /static 的 url 就交由 nginx 来处理
    # 下一行设定了静态文件存放的路径，nginx 会在该路径寻找静态文件
    location /static {
        alias  /home/my-django/myproject/static;  
    }     
}  

设置完成后重启 Nginx：

service nginx restart

---

4. gunicorn 启动 Django 项目

在我们的 Django 项目的根目录运行命令：

gunicorn -w 3 -b 0.0.0.0:8080 myproject.wsgi:application

myproject.wsgi 是 Django 创建项目时自动生成的文件，application 是该文件中一个对象，直接使用即可。

这时候，我们的网站就成功部署了。当然，更聪明的办法是使用 Supervisor 来启动我们的项目。

---

5.配置 Supervisor

在 /etc/supervisor/conf.d/ 路径下新建一个 my-django.conf 文件，编辑该配置文件：

[program:my-django]
command=gunicorn -w 3 -b 0.0.0.0:8080 myproject.wsgi:application
directory=/home/my-django/myproject
autostart=true
autorestart=true  

然后执行 supervisorctl 命令进入管理界面，用 update 命令更新配置，我们的项目就自动启动了。