这篇文章的早期版本是由Justin Ellingwood撰写的。
介绍
Django 是一个强大的 Web 框架,可以帮助您将您的 Python 应用程序或网站从地面上获得。Django 包含一个简化开发服务器来本地测试您的代码,但对于任何与生产有关的内容,需要一个更安全、更强大的 Web 服务器。
在本指南中,我们将展示如何在Ubuntu 20.04上安装和配置某些组件以支持和服务Django应用程序。我们将设置一个PostgreSQL数据库,而不是使用默认的SQLite数据库。我们将配置Gunicorn应用程序服务器与我们的应用程序进行交互。
前提和目标
为了完成本指南,你应该有一个新的Ubuntu 20.04服务器实例,有一个基本的防火墙和一个配置了sudo特权的非根用户。
将 Django 安装在虚拟环境中,而将 Django 安装在您项目的特定环境中,将使您的项目及其需求能够单独处理。
一旦我们的数据库和应用程序启动并运行,我们将安装和配置Gunicorn应用程序服务器,这将作为我们的应用程序的界面,将客户端请求从HTTP转换为Python呼叫,我们的应用程序可以处理。
让我们开始吧。
从 Ubuntu 存储库中安装软件包
要开始这个过程,我们将从Ubuntu存储库下载并安装我们需要的所有项目,我们将使用Python包管理器pip稍后安装额外的组件。
我们需要更新本地apt包索引,然后下载和安装包. 我们安装的包取决于您的项目将使用哪个版本的Python。
如果您正在使用 Django 和 Python 3,请键入:
1sudo apt update
2sudo apt install python3-pip python3-dev libpq-dev postgresql postgresql-contrib nginx curl
Django 1.11 是 Django 支持 Python 2 的最新版本,如果您正在启动新项目,强烈建议您选择 Python 3. 如果您仍然需要使用 Python 2,请键入:
1sudo apt update
2sudo apt install python-pip python-dev libpq-dev postgresql postgresql-contrib nginx curl
這將安裝「pip」,後來建立 Gunicorn 所需的 Python 開發檔案、Postgres 資料庫系統和與之互動所需的圖書館,以及 Nginx 網頁伺服器。
创建 PostgreSQL 数据库和用户
我们将直接跳进并为我们的Django应用程序创建一个数据库和数据库用户。
默认情况下,Postgres 使用一个名为对等身份验证的身份验证方案进行本地连接,这基本上意味着如果用户的操作系统用户名匹配一个有效的Postgres 用户名,则该用户可以无需进一步身份验证登录。
在 Postgres 安装过程中,一个名为postgres的操作系统用户被创建,以匹配postgres的 PostgreSQL 管理用户。我们需要使用这个用户来执行管理任务。
通过键入登录到一个互动的 Postgres 会话:
1sudo -u postgres psql
您将收到一个PostgreSQL提示,我们可以设置我们的要求。
首先,为您的项目创建一个数据库:
1CREATE DATABASE myproject;
<$>[注] 注: 每个 Postgres 语句都必须以半列结束,因此,如果您遇到问题,请确保您的命令以一个结束。
接下来,为我们的项目创建一个数据库用户. 请确保选择安全密码:
1CREATE USER myprojectuser WITH PASSWORD 'password';
之后,我们将对我们刚刚创建的用户修改一些连接参数,这将加快数据库操作,以便每次建立连接时不需要查询和设置正确的值。
我们正在将默认的编码设置为UTF-8,这是Django的预期。我们还将默认的交易隔离方案设置为读取承诺,即从未承诺的交易中读取块。最后,我们正在设置时区。
1ALTER ROLE myprojectuser SET client_encoding TO 'utf8';
2ALTER ROLE myprojectuser SET default_transaction_isolation TO 'read committed';
3ALTER ROLE myprojectuser SET timezone TO 'UTC';
现在,我们可以为我们的新用户提供访问权限来管理我们的新数据库:
1GRANT ALL PRIVILEGES ON DATABASE myproject TO myprojectuser;
完成后,通过键入退出 PostgreSQL 提示:
1\q
Postgres 现在已设置,以便 Django 可以连接并管理其数据库信息。
创建您的项目的Python虚拟环境
现在我们有我们的数据库,我们可以开始准备剩余的项目要求,我们将在虚拟环境中安装我们的Python要求,以便更容易管理。
要做到这一点,我们首先需要访问virtualenv命令,我们可以使用pip来安装它。
如果您正在使用 Python 3,请通过键入以下方式升级pip并安装该包:
1sudo -H pip3 install --upgrade pip
2sudo -H pip3 install virtualenv
如果您正在使用 Python 2,请通过键入以下方式升级pip并安装该包:
1sudo -H pip install --upgrade pip
2sudo -H pip install virtualenv
安装了virtualenv,我们可以开始创建我们的项目,并移动到一个目录,我们可以保留我们的项目文件:
1mkdir ~/myprojectdir
2cd ~/myprojectdir
在项目目录中,通过键入创建一个Python虚拟环境:
1virtualenv myprojectenv
这将创建一个名为myprojectenv的目录在你的myprojectdir目录中。内部,它将安装Python的本地版本和Pip的本地版本。
在我们安装项目的 Python 要求之前,我们需要激活虚拟环境,您可以通过键入:
1source myprojectenv/bin/activate
您的提示应更改,以表示您现在在Python虚拟环境中运行,它将看起来像这样: (myprojectenv)user@host:~/myprojectdir$。
随着虚拟环境的启动,安装 Django、Gunicorn 和psycopg2 PostgreSQL 适配器,使用本地实例pip:
<$>[注]
注: 当虚拟环境被激活时(当您的提示有(myprojectenv)之前),使用pip而不是pip3,即使您正在使用Python 3. 虚拟环境的副本的工具总是被命名为pip,无论Python版本。
1pip install django gunicorn psycopg2-binary
您现在应该拥有启动 Django 项目所需的所有软件。
创建和配置一个新的Django项目
有了我们的Python组件安装,我们可以创建实际的Django项目文件。
创建 Django 项目
由于我们已经有一个项目目录,我们会告诉Django在这里安装文件,它将创建一个与实际代码的第二级目录,这是正常的,并在这个目录中放置一个管理脚本。
1django-admin startproject myproject ~/myprojectdir
在此时,您的项目目录(在我们的情况下,~/myprojectdir)应该有以下内容:
~/myprojectdir/manage.py: 一个 Django 项目管理脚本.~/myprojectdir/myproject/: 该 Django 项目包. 这应该包含__init__.py,settings.py,urls.py,asgi.py和wsgi.py文件.~/myprojectdir/myprojectenv/: 我们之前创建的虚拟环境目录.
调整项目设置
我们应该做的第一件事与我们新创建的项目文件是调整设置. 在文本编辑器中打开设置文件:
1nano ~/myprojectdir/myproject/settings.py
首先,找出「ALLOWED_HOSTS」指令,定义了服务器的地址或域名列表,可以用来连接到Django实例,任何未列入此列表的 Host标题的输入请求都会引发例外。
在方块中,列出与您的 Django 服务器相关的 IP 地址或域名。每个项目都应该列入引文中,其中有条纹分开的条目。如果您希望对整个域和任何子域的请求,请预先预设一个时间段,以便开始输入。在下面的片段中,有几个被评论的示例用于示范:
<$>[注]
注: 请确保将localhost列为选项之一,因为我们将通过本地 Nginx 实例代理连接。
1[label ~/myprojectdir/myproject/settings.py]
2. . .
3# The simplest case: just add the domain name(s) and IP addresses of your Django server
4# ALLOWED_HOSTS = [ 'example.com', '203.0.113.5']
5# To respond to 'example.com' and any subdomains, start the domain with a dot
6# ALLOWED_HOSTS = ['.example.com', '203.0.113.5']
7ALLOWED_HOSTS = ['your_server_domain_or_IP', 'second_domain_or_IP', . . ., 'localhost']
接下来,找到配置数据库访问的部分. 它将从DATABASES开始. 文件中的配置是用于 SQLite 数据库. 我们已经为我们的项目创建了一个 PostgreSQL 数据库,所以我们需要调整设置。
使用您的 PostgreSQL 数据库信息更改设置. 我们告诉 Django 使用我们与pip安装的psycopg2适配器. 我们需要输入数据库名称、数据库用户名称、数据库用户密码,然后指定数据库位于本地计算机上。
1[label ~/myprojectdir/myproject/settings.py]
2. . .
3
4DATABASES = {
5 'default': {
6 'ENGINE': 'django.db.backends.postgresql_psycopg2',
7 'NAME': 'myproject',
8 'USER': 'myprojectuser',
9 'PASSWORD': 'password',
10 'HOST': 'localhost',
11 'PORT': '',
12 }
13}
14
15. . .
接下来,移动到文件的底部,并添加一个设置,表示 static 文件应该放置在哪里。 这是必要的,以便 Nginx 能够处理这些项目的请求。
1[label ~/myprojectdir/myproject/settings.py]
2. . .
3
4STATIC_URL = '/static/'
5import os
6STATIC_ROOT = os.path.join(BASE_DIR, 'static/')
保存并关闭文件,当你完成。
完成初步项目设置
现在,我们可以使用管理脚本将初始数据库方案迁移到我们的PostgreSQL数据库:
1~/myprojectdir/manage.py makemigrations
2~/myprojectdir/manage.py migrate
创建一个项目的管理用户,键入:
1~/myprojectdir/manage.py createsuperuser
您将需要选择用户名,提供电子邮件地址,并选择并确认密码。
我们可以将所有静态内容收集到我们通过键入配置的目录位置:
1~/myprojectdir/manage.py collectstatic
然后,静态文件将被放置在项目目录中的名为静态的目录中。
如果您遵循最初的服务器设置指南,您应该有一个 UFW 防火墙来保护您的服务器. 为了测试开发服务器,我们必须允许访问我们将使用的端口。
通过键入为端口 8000 创建例外:
1sudo ufw allow 8000
最后,您可以通过使用以下命令启动 Django 开发服务器来测试我们的项目:
1~/myprojectdir/manage.py runserver 0.0.0.0:8000
在您的 Web 浏览器中,访问您的服务器的域名或 IP 地址,然后是 :8000:
1http://server_domain_or_IP:8000
您应该收到默认的 Django 索引页面:
如果您在地址栏中添加/admin到URL的末尾,您将被提示使用createsuperuser命令创建的管理用户名和密码:
验证后,您可以访问默认的 Django admin 界面:
当您完成探索时,请在终端窗口中按 CTRL-C 关闭开发服务器。
测试 Gunicorn 服务项目的能力
在离开我们的虚拟环境之前,我们要做的最后一件事是测试Gunicorn,以确保它能为应用程序提供服务。
1cd ~/myprojectdir
2gunicorn --bind 0.0.0.0:8000 myproject.wsgi
这将启动Gunicorn在Django开发服务器正在运行的相同界面上,您可以返回并再次测试应用程序。
<$>[注] 注: 管理员界面将没有应用任何的样式,因为Gunicorn不知道如何找到负责此的静态CSS内容。
我们通过指定相对目录路径给Django的wsgi.py文件,这是我们应用程序的入口点,使用Python的模块语法通过Gunicorn传递了一个模块。
当您完成测试时,请在终端窗口中按 CTRL-C 以阻止 Gunicorn。
我们现在已经完成了我们的Django应用程序的配置,我们可以通过键入退出我们的虚拟环境:
1deactivate
提示中的虚拟环境指示器将被删除。
创建 Gunicorn 的 systemd 接口和服务文件
我们已经测试了Gunicorn可以与我们的Django应用程序进行交互,但我们应该实施一个更强大的启动和停止应用程序服务器的方式。
Gunicorn 接口将在启动时创建,并会听取连接。当发生连接时,systemd 会自动启动 Gunicorn 过程来处理连接。
首先,创建并打开有sudo特权的 Gunicorn 的 systemd 接口文件:
1sudo nano /etc/systemd/system/gunicorn.socket
内部,我们将创建一个[Unit]部分来描述插槽,一个[Socket]部分来定义插槽的位置,以及一个[Install]部分来确保插槽在正确的时间创建:
1[label /etc/systemd/system/gunicorn.socket]
2[Unit]
3Description=gunicorn socket
4
5[Socket]
6ListenStream=/run/gunicorn.sock
7
8[Install]
9WantedBy=sockets.target
保存并关闭文件,当你完成。
接下来,在文本编辑器中创建并打开一个用sudo权限的 Gunicorn 的 systemd 服务文件,该服务的文件名应该与插件文件名相匹配,除了扩展:
1sudo nano /etc/systemd/system/gunicorn.service
我们将在这里列出我们的服务的描述,并告诉 init 系统在实现网络目标后才启动此操作。
1[label /etc/systemd/system/gunicorn.service]
2[Unit]
3Description=gunicorn daemon
4Requires=gunicorn.socket
5After=network.target
接下来,我们将打开[服务]部分,我们将指定我们想要处理的用户和组,我们将给我们的常规用户帐户拥有这个过程,因为它拥有所有相关的文件。
然后我们将绘制工作目录并指定要使用的命令来启动服务. 在这种情况下,我们将不得不指定在我们的虚拟环境中安装的Gunicorn可执行的完整路径。我们将将过程绑定到我们在/run目录中创建的Unix插件,以便该过程可以与Nginx进行通信。我们将所有数据记录到标准输出,以便journald过程可以收集Gunicorn日志。
1[label /etc/systemd/system/gunicorn.service]
2[Unit]
3Description=gunicorn daemon
4Requires=gunicorn.socket
5After=network.target
6
7[Service]
8User=sammy
9Group=www-data
10WorkingDirectory=/home/sammy/myprojectdir
11ExecStart=/home/sammy/myprojectdir/myprojectenv/bin/gunicorn \
12 --access-logfile - \
13 --workers 3 \
14 --bind unix:/run/gunicorn.sock \
15 myproject.wsgi:application
最后,我们将添加一个[安装]部分,这将告诉系统d如果我们允许该服务在启动时启动,该服务将连接到什么。
1[label /etc/systemd/system/gunicorn.service]
2[Unit]
3Description=gunicorn daemon
4Requires=gunicorn.socket
5After=network.target
6
7[Service]
8User=sammy
9Group=www-data
10WorkingDirectory=/home/sammy/myprojectdir
11ExecStart=/home/sammy/myprojectdir/myprojectenv/bin/gunicorn \
12 --access-logfile - \
13 --workers 3 \
14 --bind unix:/run/gunicorn.sock \
15 myproject.wsgi:application
16
17[Install]
18WantedBy=multi-user.target
这样,我们的 systemd 服务文件就完成了. 现在保存并关闭它。
我们现在可以启动并启用 Gunicorn 接口,这将创建在 `/run/gunicorn.sock’ 和启动时的接口文件。
1sudo systemctl start gunicorn.socket
2sudo systemctl enable gunicorn.socket
我们可以通过检查插件文件来确认操作成功。
查找 Gunicorn Socket 文件
检查过程的状态,看看它是否能够开始:
1sudo systemctl status gunicorn.socket
你应该得到这样的输出:
1[secondary_label Output]
2● gunicorn.socket - gunicorn socket
3 Loaded: loaded (/etc/systemd/system/gunicorn.socket; enabled; vendor prese>
4 Active: active (listening) since Fri 2020-06-26 17:53:10 UTC; 14s ago
5 Triggers: ● gunicorn.service
6 Listen: /run/gunicorn.sock (Stream)
7 Tasks: 0 (limit: 1137)
8 Memory: 0B
9 CGroup: /system.slice/gunicorn.socket
接下来,检查在/run目录中是否存在gunicorn.sock文件:
1file /run/gunicorn.sock
1[secondary_label Output]
2/run/gunicorn.sock: socket
如果systemctl status命令显示出现错误,或者您在目录中找不到gunicorn.sock文件,则表明Gunicorn插件无法正确创建。
1sudo journalctl -u gunicorn.socket
再看看您的 /etc/systemd/system/gunicorn.socket 文件,在继续之前修复任何问题。
测试 Socket 激活
目前,如果您刚刚启动了gunicorn.socket单元,则gunicorn.service将不会活跃,因为插件尚未接收任何连接。
1sudo systemctl status gunicorn
1[secondary_label Output]
2● gunicorn.service - gunicorn daemon
3 Loaded: loaded (/etc/systemd/system/gunicorn.service; disabled; vendor preset: enabled)
4 Active: inactive (dead)
要测试插槽激活机制,我们可以通过键入弯曲发送连接到插槽:
1curl --unix-socket /run/gunicorn.sock localhost
您应该从终端中收到您的应用程序的HTML输出。这表明Gunicorn已经启动并能够服务您的Django应用程序。您可以通过键入来验证Gunicorn服务正在运行:
1sudo systemctl status gunicorn
1[secondary_label Output]
2
3● gunicorn.service - gunicorn daemon
4 Loaded: loaded (/etc/systemd/system/gunicorn.service; disabled; vendor preset: enabled)
5 Active: active (running) since Fri 2020-06-26 18:52:21 UTC; 2s ago
6TriggeredBy: ● gunicorn.socket
7 Main PID: 22914 (gunicorn)
8 Tasks: 4 (limit: 1137)
9 Memory: 89.1M
10 CGroup: /system.slice/gunicorn.service
11 ├─22914 /home/sammy/myprojectdir/myprojectenv/bin/python /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunico>
12 ├─22927 /home/sammy/myprojectdir/myprojectenv/bin/python /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunico>
13 ├─22928 /home/sammy/myprojectdir/myprojectenv/bin/python /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunico>
14 └─22929 /home/sammy/myprojectdir/myprojectenv/bin/python /home/sammy/myprojectdir/myprojectenv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunico>
15
16Jun 26 18:52:21 django-tutorial systemd[1]: Started gunicorn daemon.
17Jun 26 18:52:21 django-tutorial gunicorn[22914]: [2020-06-26 18:52:21 +0000] [22914] [INFO] Starting gunicorn 20.0.4
18Jun 26 18:52:21 django-tutorial gunicorn[22914]: [2020-06-26 18:52:21 +0000] [22914] [INFO] Listening at: unix:/run/gunicorn.sock (22914)
19Jun 26 18:52:21 django-tutorial gunicorn[22914]: [2020-06-26 18:52:21 +0000] [22914] [INFO] Using worker: sync
20Jun 26 18:52:21 django-tutorial gunicorn[22927]: [2020-06-26 18:52:21 +0000] [22927] [INFO] Booting worker with pid: 22927
21Jun 26 18:52:21 django-tutorial gunicorn[22928]: [2020-06-26 18:52:21 +0000] [22928] [INFO] Booting worker with pid: 22928
22Jun 26 18:52:21 django-tutorial gunicorn[22929]: [2020-06-26 18:52:21 +0000] [22929] [INFO] Booting worker with pid: 22929
如果从弯曲的输出或systemctl 状态的输出表明出现问题,请检查日志以获取更多细节:
1sudo journalctl -u gunicorn
如果您对 /etc/systemd/systemd/system/gunicorn.service 文件进行更改,请重新加载 DAEMON 来重新读取服务定义,并通过键入重新启动 Gunicorn 过程:
1sudo systemctl daemon-reload
2sudo systemctl restart gunicorn
确保您在继续之前解决上述问题。
配置 Nginx 到 Proxy Pass 到 Gunicorn
现在Gunicorn已设置,我们需要配置 Nginx 来将流量传输到进程中。
首先,在 Nginx 的可用站点目录中创建并打开一个新的服务器块:
1sudo nano /etc/nginx/sites-available/myproject
在内部,打开一个新的服务器块,我们将首先指定该块应该在正常端口80上听,并应响应我们的服务器的域名或IP地址:
1[label /etc/nginx/sites-available/myproject]
2server {
3 listen 80;
4 server_name server_domain_or_IP;
5}
接下来,我们会告诉 Nginx 忽略找到 favicon 的任何问题,我们还会告诉它在我们的 `~/myprojectdir/static’ 目录中收集的静态资产在哪里找到。
1[label /etc/nginx/sites-available/myproject]
2server {
3 listen 80;
4 server_name server_domain_or_IP;
5
6 location = /favicon.ico { access_log off; log_not_found off; }
7 location /static/ {
8 root /home/sammy/myprojectdir;
9 }
10}
最后,我们将创建一个位置 / {}块来匹配所有其他请求. 在这个位置中,我们将包括标准的proxy_params文件,包括在 Nginx 安装中,然后我们将流量直接传输到 Gunicorn 接口:
1[label /etc/nginx/sites-available/myproject]
2server {
3 listen 80;
4 server_name server_domain_or_IP;
5
6 location = /favicon.ico { access_log off; log_not_found off; }
7 location /static/ {
8 root /home/sammy/myprojectdir;
9 }
10
11 location / {
12 include proxy_params;
13 proxy_pass http://unix:/run/gunicorn.sock;
14 }
15}
保存并关闭文件完成后. 现在,我们可以通过链接到网站启用目录来启用该文件:
1sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled
通过键入测试您的 Nginx 配置以检测语法错误:
1sudo nginx -t
如果没有报告错误,请继续通过键入重新启动 Nginx:
1sudo systemctl restart nginx
最后,我们需要打开我们的防火墙,以便在端口上正常流量 80. 由于我们不再需要访问开发服务器,我们也可以删除打开端口 8000 的规则:
1sudo ufw delete allow 8000
2sudo ufw allow 'Nginx Full'
您现在应该能够访问您的服务器的域或IP地址来查看您的应用程序。
<$>[注] 注: 配置 Nginx 后,下一步应该是通过 SSL/TLS 确保到服务器的流量,因为没有它,所有信息,包括密码,都通过网络以简单的文本发送。
如果你有一个域名,获得SSL证书以保护你的流量最简单的方法是使用Let's Encrypt。 遵循此指南(https://andsky.com/tech/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-20-04)在Ubuntu 20.04上设置Let's Encrypt with Nginx。
解决问题 Nginx 和 Gunicorn
如果此最后一步未显示您的应用程序,则需要解决安装问题。
Nginx将显示默认页面而不是Django应用程序
如果 Nginx 显示默认页面而不是向您的应用程序代理,这通常意味着您需要在 /etc/nginx/sites-available/myproject’ 文件中调整 server_name` 以指向您的服务器的 IP 地址或域名。
Nginx 使用「server_name」来确定使用哪个服务器块来响应请求. 如果您收到默认的 Nginx 页面,这是一个迹象,表明 Nginx 无法明确匹配请求的 sever 区块,因此它会返回在 `/etc/nginx/sites-available/default 中定义的默认区块。
项目服务器块中的server_name必须比要选择的默认服务器块中的server_name更为具体。
Nginx 顯示 502 Bad Gateway 錯誤,而不是 Django 應用程式
502 错误表明 Nginx 无法成功代理请求. 各种配置问题以 502 错误表达,因此需要更多信息才能正确解决问题。
寻找更多信息的主要场所是在 Nginx 的错误日志中。 一般来说,这会告诉您在代理事件期间引起的问题的条件。
1sudo tail -F /var/log/nginx/error.log
现在,请在浏览器中提出另一个请求,以生成新错误(尝试刷新页面)。
你可能會收到以下訊息:
connect() 到 unix:/run/gunicorn.sock 失败了(2:没有此类文件或目录)
這表明 Nginx 無法在該位置找到「gunicorn.sock」檔案,您應該將在「/etc/nginx/sites-available/myproject」檔案中定義的「proxy_pass」位置與「gunicorn.sock」檔案的實際位置進行比較,而該檔案是由「gunicorn.socket」 systemd 單位生成的。
如果您无法在/run目录中找到一个gunicorn.sock文件,这通常意味着 systemd 接口文件无法创建它. 返回检查 Gunicorn 接口文件部分(#checking-for-the-gunicorn-socket-file)以完成 Gunicorn 的故障排除步骤。
connect() 到 unix:/run/gunicorn.sock 失败了(13:允许被拒绝)
这表明 Nginx 由于权限问题无法连接到 Gunicorn 接口,这可能发生在使用 root 用户而不是 sudo 用户时。
如果在 root 目录 (/) 和 'gunicorn.sock' 文件之间有有限的权限,我们可以通过将我们的 socket 文件的绝对路径转移到 'namei' 命令来检查 socket 文件及其每个母目录的权限和所有权值:
1namei -l /run/gunicorn.sock
1[secondary_label Output]
2f: /run/gunicorn.sock
3drwxr-xr-x root root /
4drwxr-xr-x root root run
5srw-rw-rw- root root gunicorn.sock
输出显示了每个目录组件的权限. 通过查看权限(第一列),所有者(第二列)和组所有者(第三列),我们可以确定接口文件的访问类型是允许的。
在上面的示例中,接口文件和导致接口文件的每个目录都有世界读取和执行权限(目录的权限列以r-x而不是---结束)。
如果连接到连接器的任何目录都没有世界读取和执行权限,那么 Nginx 将无法访问连接器,而不允许世界读取和执行权限,或者确保组所有权被赋予 Nginx 是组的一部分。
Django表示:无法连接到服务器:连接被拒绝
在 Web 浏览器中尝试访问应用程序的部分时,您可能收到 Django 的一个信息是:
1OperationalError at /admin/login/
2could not connect to server: Connection refused
3 Is the server running on host "localhost" (127.0.0.1) and accepting
4 TCP/IP connections on port 5432?
这表明 Django 无法连接到 Postgres 数据库,请通过键入确保 Postgres 实例正在运行:
1sudo systemctl status postgresql
如果不是,你可以启动它,并允许它在启动时自动启动(如果它尚未配置以这样做),键入:
1sudo systemctl start postgresql
2sudo systemctl enable postgresql
如果您仍然遇到问题,请确保在 ~/myprojectdir/myproject/settings.py 文件中定义的数据库设置正确。
进一步麻烦解决
为了进一步解决问题,日志可以帮助缩小根源原因,反过来检查每个原因,并寻找指示问题区域的消息。
以下日志可能有用:
- 通过键入检查 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
当您更新配置或应用程序时,您可能需要重新启动流程以适应您的更改。
如果您更新您的 Django 应用程序,您可以重新启动 Gunicorn 流程以通过键入获取更改:
1sudo systemctl restart gunicorn
如果您更改 Gunicorn 插槽或服务文件,请重新加载 DAEMON 并通过键入重新启动过程:
1sudo systemctl daemon-reload
2sudo systemctl restart gunicorn.socket gunicorn.service
如果您更改了 Nginx 服务器块配置,请测试配置,然后通过键入 Nginx:
1sudo nginx -t && sudo systemctl restart nginx
这些命令有助于在调整配置时获取更改。
结论
在本指南中,我们已经在自己的虚拟环境中设置了一个Django项目,我们已经配置了Gunicorn来翻译客户端请求,以便Django能够处理这些请求。
Django 通过提供许多常见元素来简化项目和应用程序的创建,使您能够专注于独特的元素,通过利用本文中描述的通用工具链,您可以轻松地从单一服务器中服务您创建的应用程序。