使用 nginx + gunicorn 来部署生产环境的 Django app
共 2461字,需浏览 5分钟
·
2022-08-09 06:16
在测试环境下,我们可以简单的使用 python manage.py runserver 8080
启动一个 Django,由于尚未通过安全审核或性能测试,而且是单线程,并发能力也不强,因此不能在生产环境中使用。
生产环境下,需要使用专门的 Web 服务器,像 Gunicorn 或 uWSGI。
今天就来分享一下如何使用 nginx + gunicorn 来部署生产环境的 Django app。
Gunicorn(Green Unicorn)是一个用于 UNIX 的 Python WSGI HTTP 服务器。Gunicorn 服务器广泛兼容各种 Web 框架,实现简单,服务器占用资源少,速度相当快。Django app 只是它支持的其中一种框架。
安装
pip install gunicorn
gunicorn 没有依赖项,因此下载后可以很容易迁移到生产环境。
快速使用
直接在 Django 项目的目录内,也就是 manage.py 所在的目录内执行:
gunicorn your_project.wsgi:application --bind 0.0.0.0:8000
即可启动生产级别的 Web 服务,前提是你的 Django settings 也是生产环境的配置,例如 Debug = False。
配置成系统服务
首先让我们创建一个系统级别的套接字文件:
sudo vim /etc/systemd/system/gunicorn.socket
写入以下内容:
[Unit]
Description=gunicorn socket
[Socket]
ListenStream=/run/gunicorn.sock
[Install]
WantedBy=sockets.target
然后创建一个 Gunicorn 系统服务文件:
sudo vim /etc/systemd/system/gunicorn.service
写入以下内容:
[Unit]
Description=gunicorn daemon
Requires=gunicorn.socket
After=network.target
[Service]
User=hitesh
Group=www-data
WorkingDirectory=/home/hitesh/myprojectdir
ExecStart=/home/hitesh/myprojectdir/myprojectenv/bin/gunicorn \
--access-logfile - \
--workers 3 \
--bind unix:/run/gunicorn.sock \
myproject.wsgi:application
[Install]
WantedBy=multi-user.target
这样我们就可以在系统启动的时候启动 Gunicorn 服务,也可以很方面的启动、停止、重启 Gunicorn。
sudo systemctl enable gunicorn
sudo systemctl start gunicorn
sudo systemctl stop gunicorn
sudo systemctl restart gunicorn
查看服务状态:
sudo systemctl status gunicorn.socket
与 Nginx 配合
Nginx 非常适合处理静态文件,所以静态文件就交给 Nginx,然后服务接口交给 Gunicorn,让 Nginx 代理 Gunicorn。
一个简单的配置文件如下:
server {
listen 80;
server_name server_domain_or_IP;
location = /favicon.ico { access_log off; log_not_found off; }
location /static/ {
root /home/aaron/myprojectdir;
}
location / {
include proxy_params;
proxy_pass http://unix:/run/gunicorn.sock;
}
}
测试配置文件是否有误:
sudo nginx -t
如果没有错误,可以重启 Nginx 让新的配置文件生效:
sudo nginx -s reload
你可能还需要配置你的证书。
Nginx 和 Gunicorn 故障排除
对于故障排除,日志可以帮助找到根本原因。检查以下日志可以帮助排除故障:
查看 Nginx 进程日志:sudo journalctl -u nginx
查看 Nginx 访问日志:sudo less /var/log/nginx/access.log
检查 Nginx 错误日志:sudo less /var/log/nginx/error.log
检查 Gunicorn 应用程序日志:sudo journalctl -u gunicorn
检查 Gunicorn 套接字日志:sudo journalctl -u gunicorn.socket
最后的话
本文分享了使用 nginx + gunicorn 来部署生产环境的 Django app,生产环境下 Nginx 的反向代理,最好都使用 socket 来通讯,至于为什么,可以参考前文redis 是单线程,是怎么解决高并发问题的。如有收获,还请在看支持。