在 Linux 上使用 Nginx 和 Gunicorn 託管 Django 應用
介紹
託管 Django Web 應用程序相當簡單,雖然它比標準的 PHP 應用程序更複雜一些。 讓 Web 伺服器對接 Django 的方法有很多。 Gunicorn 就是其中最簡單的一個。
Gunicorn(Green Unicorn 的縮寫)在你的 Web 伺服器 Django 之間作為中間伺服器使用,在這裡,Web 伺服器就是 Nginx。 Gunicorn 服務於應用程序,而 Nginx 處理靜態內容。
Gunicorn
安裝
使用 Pip 安裝 Gunicorn 是超級簡單的。 如果你已經使用 virtualenv 搭建好了你的 Django 項目,那麼你就有了 Pip,並且應該熟悉 Pip 的工作方式。 所以,在你的 virtualenv 中安裝 Gunicorn。
$ pip install gunicorn
配置
Gunicorn 最有吸引力的一個地方就是它的配置非常簡單。處理配置最好的方法就是在 Django 項目的根目錄下創建一個名叫 Gunicorn
的文件夾。然後在該文件夾內,創建一個配置文件。
在本篇教程中,配置文件名稱是 gunicorn-conf.py
。在該文件中,創建類似於下面的配置:
import multiprocessing
bind = 'unix:///tmp/gunicorn1.sock'
workers = multiprocessing.cpu_count() * 2 + 1
reload = True
daemon = True
在上述配置的情況下,Gunicorn 會在 /tmp/
目錄下創建一個名為 gunicorn1.sock
的 Unix 套接字。 還會啟動一些工作進程,進程數量相當於 CPU 內核數量的 2 倍。 它還會自動重新載入並作為守護進程運行。
運行
Gunicorn 的運行命令有點長,指定了一些附加的配置項。 最重要的部分是將 Gunicorn 指向你項目的 .wsgi
文件。
gunicorn -c gunicorn/gunicorn-conf.py -D --error-logfile gunicorn/error.log yourproject.wsgi
上面的命令應該從項目的根目錄運行。 -c
選項告訴 Gunicorn 使用你創建的配置文件。 -D
再次指定 gunicorn 為守護進程。 最後一部分指定 Gunicorn 的錯誤日誌文件在你創建 Gunicorn
文件夾中的位置。 命令結束部分就是為 Gunicorn 指定 .wsgi
文件的位置。
Nginx
現在 Gunicorn 配置好了並且已經開始運行了,你可以設置 Nginx 連接它,為你的靜態文件提供服務。 本指南假定你已經配置好了 Nginx,而且你通過它託管的站點使用了單獨的 server 塊。 它還將包括一些 SSL 信息。
如果你想知道如何讓你的網站獲得免費的 SSL 證書,請查看我們的 Let'sEncrypt 指南。
# 連接到 Gunicorn
upstream yourproject-gunicorn {
server unix:/tmp/gunicorn1.sock fail_timeout=0;
}
# 將未加密的流量重定向到加密的網站
server {
listen 80;
server_name yourwebsite.com;
return 301 https://yourwebsite.com$request_uri;
}
# 主服務塊
server {
# 設置監聽的埠,指定監聽的域名
listen 443 default ssl;
client_max_body_size 4G;
server_name yourwebsite.com;
# 指定日誌位置
access_log /var/log/nginx/yourwebsite.access_log main;
error_log /var/log/nginx/yourwebsite.error_log info;
# 告訴 nginx 你的 ssl 證書
ssl on;
ssl_certificate /etc/letsencrypt/live/yourwebsite.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourwebsite.com/privkey.pem;
# 設置根目錄
root /var/www/yourvirtualenv/yourproject;
# 為 Nginx 指定靜態文件路徑
location /static/ {
# Autoindex the files to make them browsable if you want
autoindex on;
# The location of your files
alias /var/www/yourvirtualenv/yourproject/static/;
# Set up caching for your static files
expires 1M;
access_log off;
add_header Cache-Control "public";
proxy_ignore_headers "Set-Cookie";
}
# 為 Nginx 指定你上傳文件的路徑
location /media/ {
Autoindex if you want
autoindex on;
# The location of your uploaded files
alias /var/www/yourvirtualenv/yourproject/media/;
# Set up aching for your uploaded files
expires 1M;
access_log off;
add_header Cache-Control "public";
proxy_ignore_headers "Set-Cookie";
}
location / {
# Try your static files first, then redirect to Gunicorn
try_files $uri @proxy_to_app;
}
# 將請求傳遞給 Gunicorn
location @proxy_to_app {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_redirect off;
proxy_pass http://njc-gunicorn;
}
# 緩存 HTML、XML 和 JSON
location ~* .(html?|xml|json)$ {
expires 1h;
}
# 緩存所有其他的靜態資源
location ~* .(jpg|jpeg|png|gif|ico|css|js|ttf|woff2)$ {
expires 1M;
access_log off;
add_header Cache-Control "public";
proxy_ignore_headers "Set-Cookie";
}
}
配置文件有點長,但是還可以更長一些。其中重點是指向 Gunicorn 的 upstream
塊以及將流量傳遞給 Gunicorn 的 location
塊。大多數其他的配置項都是可選,但是你應該按照一定的形式來配置。配置中的注釋應該可以幫助你了解具體細節。
保存文件之後,你可以重啟 Nginx,讓修改的配置生效。
# systemctl restart nginx
一旦 Nginx 在線生效,你的站點就可以通過域名訪問了。
結語
如果你想深入研究,Nginx 可以做很多事情。但是,上面提供的配置是一個很好的開始,並且你可以用於實踐中。 如果你見慣了 Apache 和臃腫的 PHP 應用程序,像這樣的伺服器配置的速度應該是一個驚喜。
via: https://linuxconfig.org/hosting-django-with-nginx-and-gunicorn-on-linux
作者:Nick Congleton 譯者:Flowsnow 校對:wxy
本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive