在 Linux 上使用 Nginx 和 Gunicorn 托管 Django 应用-工具盒子

介绍 {#toc_1}

托管 Django Web 应用程序相当简单，虽然它比标准的 PHP 应用程序更复杂一些。让 Web 服务器对接 Django 的方法有很多。 Gunicorn 就是其中最简单的一个。

Gunicorn（Green Unicorn 的缩写）在你的 Web 服务器 Django 之间作为中间服务器使用，在这里，Web 服务器就是 Nginx。 Gunicorn 服务于应用程序，而 Nginx 处理静态内容。

Gunicorn {#toc_2}

安装 {#toc_3}

使用 Pip 安装 Gunicorn 是超级简单的。如果你已经使用 virtualenv 搭建好了你的 Django 项目，那么你就有了 Pip，并且应该熟悉 Pip 的工作方式。所以，在你的 virtualenv 中安装 Gunicorn。

$ pip install gunicorn

配置 {#toc_4}

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 倍。它还会自动重新加载并作为守护进程运行。

运行 {#toc_5}

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 {#toc_6}

现在 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 &quot;public&quot;;
proxy_ignore_headers &quot;Set-Cookie&quot;;
}
为 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 &quot;public&quot;;
proxy_ignore_headers &quot;Set-Cookie&quot;;
}
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 &quot;public&quot;;
proxy_ignore_headers &quot;Set-Cookie&quot;;
}

}