1.环境准备
参考我之前部署 Flask 时候的笔记: Flask + Gunicorn + Supervisor 简易部署 web 应用 和 Nginx 处理静态文件,把 Gunicorn
,Supervisor
和 Nginx
都安装好。
当然记得安装 Django:
pip3 install django==1.11
(这里我使用 Django1.11 版本)
2. Django 项目
在上传我们的 Django 项目之前,需要做好几点准备。
把
setting.py
的DEBUG
选项改成False
,只有关闭了调试模式,后面才能让 Nginx 来寻找静态文件。把
setting.py
的ALLOW_HOSTS
,加入服务器的域名,(或,和)服务器 ip。还可以加上127.0.0.1
方便本地观察。在
setting.py
中设置STATIC_ROOT
,建议可以直接设为:
STATIC_ROOT = os.path.join(BASE_DIR, 'static')
也就是直接把静态文件目录放在项目的根目录下。
- 执行
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
- 在
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
命令更新配置,我们的项目就自动启动了。