本页目录

  • 准备工作
  • 步骤 1 - 配置防火墙
  • 步骤 2 - 安装 PostgreSQL 及工具
  • 步骤 3 - 配置 PostgreSQL
  • 步骤 4 - 安装 Django 使用 pip 安装 安装开发版本
  • 步骤 5 - 创建示例项目
  • 步骤 6 - 测试开发服务器
  • 步骤 7 - 安装并测试 Gunicorn 使用 nohup 运行持久化 Django 服务器 安装 Gunicorn
  • 步骤 8 - 为 Gunicorn 创建 Socket 与服务文件
  • 步骤 9 - 安装 Nginx
  • 步骤 10 - 安装 SSL
  • 步骤 11 - 配置 Nginx
  • 总结
  • 使用 pip 安装
  • 安装开发版本
  • 使用 nohup 运行持久化 Django 服务器
  • 安装 Gunicorn

Django 是一个用于开发动态网站和应用程序的 Python 框架。它遵循 MVC(Model-View-Controller,模型-视图-控制器)架构。使用 Django 可以加快应用程序的开发过程,因为大部分底层任务都由它来处理。

在本教程中,你将学习如何在 Rocky Linux 9 服务器上安装 Django 框架。你还将创建一个演示项目并对其进行测试。

准备工作

  • 一台运行 Rocky Linux 9 的服务器。
  • 一个拥有 sudo 权限的非 root 用户。
  • 一个指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 django.example.com 作为域名。
  • 确保所有软件包都是最新的。$ sudo dnf update
  • 安装基础工具包。其中一些可能已安装。$ sudo dnf install wget curl nano unzip yum-utils -y

一台运行 Rocky Linux 9 的服务器。

一个拥有 sudo 权限的非 root 用户。

一个指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 django.example.com 作为域名。

确保所有软件包都是最新的。

$ sudo dnf update

安装基础工具包。其中一些可能已安装。

$ sudo dnf install wget curl nano unzip yum-utils -y
  • SELinux 已禁用。

步骤 1 - 配置防火墙

第一步是配置防火墙。Rocky Linux 使用 Firewalld 防火墙。检查防火墙的状态。

$ sudo firewall-cmd --state
running

防火墙以不同的区域(zone)工作,public 区域是我们将使用的默认区域。列出防火墙上所有处于活动状态的服务和端口。

$ sudo firewall-cmd --permanent --list-services

它应显示如下输出。

cockpit dhcpv6-client ssh

Django 需要 HTTP 和 HTTPS 端口才能运行。开放这些端口。

$ sudo firewall-cmd --add-service=http --permanent
$ sudo firewall-cmd --add-service=https --permanent

重新加载防火墙以使更改生效。

$ sudo firewall-cmd --reload

步骤 2 - 安装 PostgreSQL 及工具

Rocky Linux 9 自带了较旧版本的 PostgreSQL。我们将在本教程中安装 Postgres 14。

安装 PostgreSQL 的仓库 RPM。

$ sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm

安装 PostgreSQL 14 服务器。

$ sudo dnf install -y postgresql14-server postgresql14-contrib postgresql14-devel python3-psycopg2

初始化数据库。

$ sudo /usr/pgsql-14/bin/postgresql-14-setup initdb

启用并启动 PostgreSQL 服务。

$ sudo systemctl enable postgresql-14 --now

检查服务状态。

$ sudo systemctl status postgresql-14
? postgresql-14.service - PostgreSQL 14 database server
     Loaded: loaded (/usr/lib/systemd/system/postgresql-14.service; enabled; vendor preset: disabled)
     Active: active (running) since Mon 2022-09-12 01:17:24 UTC; 2s ago
       Docs: https://www.postgresql.org/docs/14/static/
    Process: 87995 ExecStartPre=/usr/pgsql-14/bin/postgresql-14-check-db-dir ${PGDATA} (code=exited, status=0/SUCCESS)
   Main PID: 88000 (postmaster)
      Tasks: 8 (limit: 5915)
     Memory: 16.5M
        CPU: 60ms
     CGroup: /system.slice/postgresql-14.service
             ??88000 /usr/pgsql-14/bin/postmaster -D /var/lib/pgsql/14/data/
             ??88001 "postgres: logger "
             ??88003 "postgres: checkpointer "
             ??88004 "postgres: background writer "
             ??88005 "postgres: walwriter "
             ??88006 "postgres: autovacuum launcher "
             ??88007 "postgres: stats collector "
             ??88008 "postgres: logical replication launcher "

Sep 12 01:17:24 board.example.com systemd[1]: Starting PostgreSQL 14 database server...

让我们安装一些 Django 运行所需的额外工具。

$ sudo dnf install -y python3 python3-devel python3-pip gcc

为了避免将来出现找不到 pg_config 的错误,你需要将 PostgreSQL 的 bin 目录路径加入环境变量。打开 .bashrc 文件进行编辑。

$ nano ~/.bashrc

在文件末尾添加如下行。

export PATH=$PATH:/usr/pgsql-14/bin	

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

步骤 3 - 配置 PostgreSQL

登录到 PostgreSQL shell。

$ sudo -i -u postgres psql

为 Django 创建一个新数据库。

postgres=# CREATE DATABASE djangoapp;

创建一个使用强密码的新数据库用户。

postgres=# CREATE USER djangouser WITH ENCRYPTED PASSWORD 'dbpassword';

授予该用户使用数据库的权限。

postgres=# GRANT ALL PRIVILEGES ON DATABASE djangoapp TO djangouser;

退出 Postgres Shell。

postgres=# \q

步骤 4 - 安装 Django

安装 Django 有几种方法。选择哪一种最适合你,取决于你希望如何配置开发环境以及你的具体需求。每种方法都有其优缺点。让我们逐一了解这些方法。

使用 pip 安装

这是安装 Django 最常见的方式。推荐的做法是创建一个 Python 虚拟环境。这样你可以在不影响系统的情况下安装 Python 包。

让我们创建一个演示项目目录。

$ mkdir ~/sampleproject
$ cd ~/sampleproject

使用以下命令创建虚拟环境。请将 sample_env 替换为你想命名的虚拟环境名称。

$ python3 -m venv sample_env

这会在你的项目目录中安装一个可移植的 Python 和 pip。要向项目中安装任何包,你需要使用以下命令激活环境。

$ source sample_env/bin/activate

你的 shell 提示符会发生变化,以反映当前激活的虚拟环境。

(sample_env) navjot@django:~/sampleproject$

虚拟环境激活后,使用 pip 安装 Django。运行以下命令来安装 Django。

(sample_env) $ pip install django

验证安装。

(sample_env) $ django-admin --version
4.1.2

根据你的项目需求,你可以按以下方式安装不同版本的 Django。

(sample_env) $ pip install django==3.2.1

验证安装。

(sample_env) $ django-admin --version
3.2.1

如你所见,这种方法安装的 Django 版本比从 Rocky Linux 仓库获取的版本更新。

要退出虚拟环境,运行以下命令。

(sample_env) $ deactivate

安装开发版本

你也可以使用 pip 安装 Django 的开发版本。为此,我们将从 Django 的 Github 仓库获取开发版本。

使用以下命令将仓库克隆到 ~/django-dev 目录。

$ git clone https://github.com/django/django ~/django-dev

切换到新创建的目录。

$ cd ~/django-dev

创建虚拟环境。

$ python3 -m venv dev_django_env

激活环境。

$ source dev_django_env/bin/activate

使用 pip 安装 Django。-e 标志以可编辑模式安装,从版本控制系统安装时需要此选项。

(dev_django_dev) $ pip install -e ~/django-dev

验证安装。

(dev_django_dev) $ django-admin --version
4.2.dev20221012095013

如你所见,这里的版本是最新的开发版本。Django 的开发版本不适合用于生产环境。

步骤 5 - 创建示例项目

让我们构建一个示例 Django 项目。为示例项目创建一个目录。

$ mkdir ~/dj-sample
$ cd ~/dj-sample

创建一个 Python 虚拟环境。

$ python3 -m venv sample_proj

激活环境。

$ source sample_proj/bin/activate

安装 Wheel 包。

(sample_proj) $ pip install wheel

安装 Django 及所需的包。

(sample_proj) $ pip install django psycopg2 psycopg2-binary

要构建项目,我们需要使用 startproject 命令。该命令会创建另一个包含以下内容的目录:

  • 一个管理脚本 manage.py,用于执行 Django 特有的管理任务。
  • 一个与项目同名的目录,其中包含项目代码。

我们将在当前工作目录中创建项目目录。为此,请在下述命令末尾使用点(.)字符。

(sample_proj) $ django-admin startproject demoproject .

Django 使用 SECRET_KEY 变量来提供加密签名。它在安装过程中会生成一个默认值。你应该将其替换为一个安全的值。运行以下命令生成密钥并复制以备后用。

(sample_proj) $ python3 -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())'

你将获得如下带有密钥的输出。

wm#dzb^ymuo3s3tza=f5cx^kan!$4sch1!b-q=v%)=d0pb(jqf

第一步是调整项目设置。打开 settings 文件进行编辑。

(sample_proj) $ nano demoproject/settings.py

将 SECRET_KEY 变量的当前值替换为你生成的密钥。

SECRET_KEY = 's)3m=4s&!a=p#brttcqu@1s$8(z6e+u8(^tkpw28qyj0t#8ku2'

按如下方式更改 DATABASES 部分的设置。

DATABASES = {
    'default': {
		'ENGINE': 'django.db.backends.postgresql_psycopg2',
		'NAME': 'DATABASE_DB',
		'USER': 'DATABASE_USER',
		'PASSWORD': 'DATABASE_PASSWORD',
		'HOST': 'DATABASE_HOST',
		'PORT': 'DATABASE_PORT',
	},
}

接下来,移动到文件底部,添加静态文件位置的设置。这对 Nginx 正常工作并处理这些文件的请求非常重要。在 STATIC_URL 变量上方添加如下行。

STATIC_ROOT = os.path.join(BASE_DIR, "static/")

由于 STATIC_ROOT 变量使用了 os 模块,而该模块默认未导入,我们需要导入它。在 from pathlib import Path 这一行上方添加如下行。

import os

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

验证数据库设置。

(sample_proj) $ python manage.py check --database default

你应该获得如下输出。

System check identified no issues (0 silenced).

接下来,我们需要使用 migrate 命令迁移数据库。Django 中的迁移(migrations)会将你对模型所做的更改同步到数据库结构中。

(sample_proj) $ python manage.py makemigrations
(sample_proj) $ python manage.py migrate

你将获得如下输出。

Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying auth.0012_alter_user_first_name_max_length... OK
  Applying sessions.0001_initial... OK

接下来,创建一个管理员用户以访问 Django 的管理后台界面。

(sample_proj) $ python manage.py createsuperuser

系统会提示你输入用户名、电子邮件和密码。

Username (leave blank to use 'navjot'):
Email address: 
[email protected]

Password:
Password (again):
Superuser created successfully.

将静态文件复制到 static 目录中。在提示时输入 yes。

(sample_proj) $ python manage.py collectstatic
130 static files copied to '/home/navjot/dj-sample/static'.

步骤 6 - 测试开发服务器

现在到了测试应用程序的时候。为此,你需要修改 Django 设置中的 ALLOWED_HOSTS 指令。该指令定义了被允许访问 Django 应用程序的 IP 地址和域名列表。

使用以下命令打开 settings 文件。

(sample_proj) $ nano demoproject/settings.py

找到如下条目。

ALLOWED_HOSTS = []

在方括号中输入你的服务器 IP 地址。每个条目都应放在引号内,多个条目需用逗号分隔。输入 www.example.com 将精确匹配该域名。而 .example.com 则会匹配 example.com 和 www.example.com,以及 example.com 的任何其他子域名。因此,建议在域名前加上句点(.)以匹配该域名及其所有子域名。

ALLOWED_HOSTS = ['<yourserver_ip_address>']

我们使用 IP 地址来匹配我们的服务器。按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

在测试开发服务器之前,你需要配置防火墙以允许 Django 运行。Django 默认使用 8000 端口。使用 Uncomplicated Firewall(UFW)开放该端口。

(sample_proj) $ sudo firewall-cmd --add-port=8000/tcp --permanent
(sample_proj) $ sudo firewall-cmd --reload

启动开发服务器。

(sample_proj) $ python manage.py runserver 0.0.0.0:8000

在浏览器中打开 URL http://:8000,你将看到如下界面。

手把手教你在 Rocky Linux 9 上部署 Django 配合 Postgres Nginx 与 Gunicorn

你可以通过 URL http://:8000/admin/ 访问管理后台,你将看到如下登录界面。

手把手教你在 Rocky Linux 9 上部署 Django 配合 Postgres Nginx 与 Gunicorn

输入之前创建的凭据以登录下方所示的管理面板。

手把手教你在 Rocky Linux 9 上部署 Django 配合 Postgres Nginx 与 Gunicorn

完成演示项目后,你可以在终端中按 Ctrl + C 关闭服务器。

步骤 7 - 安装并测试 Gunicorn

使用 nohup 运行持久化 Django 服务器

到目前为止,Django 的服务并不是持久化的。要使服务持久化,有两种方法。第一种方法是使用 nohup 工具。nohup 是一个 POSIX 命令,意为“不挂断”(no hang up)。它用于执行命令,即使当用户注销后也不会停止。

确保你已通过按 Ctrl + C 从终端退出了服务器。

运行以下命令来启动 Django 的开发服务器。

(sample_proj) $ nohup python manage.py runserver 0.0.0.0:8000 &

现在,你的 Django 服务器将持续运行,直到你手动终止它。该命令会返回进程 ID 并输出另一条命令。

[1] 42595
(sample_proj) $ nohup: ignoring input and appending output to 'nohup.out'
^C

按 Ctrl + C 退出。原始的 Django 服务器将继续运行。你可以通过在浏览器中打开该 URL 来验证。

完成后,你需要终止该进程。nohup 命令只返回了一个进程 ID。但实际上,有两个进程在运行。要查找这两个进程的 ID,请运行以下命令。

(sample_proj) $ ps aux | grep manage.py
navjot    153474  1.6  3.9  46264 39016 pts/0    S    04:15   0:00 python manage.py runserver 0.0.0.0:8000
navjot    153475  3.0  4.4 196060 43500 pts/0    Sl   04:15   0:00 /home/navjot/dj-sample/sample_proj/bin/python manage.py runserver 0.0.0.0:8000
navjot    153483  0.0  0.2   6420  2248 pts/0    S+   04:15   0:00 grep --color=auto manage.py

如你所见,有两个进程在运行,一个 ID 为 153474,另一个 ID 为 153475。

运行以下命令,使用上面获得的进程 ID 关闭服务器。

(sample_proj) $ sudo kill -9 153474 153475

安装 Gunicorn

运行持久化 Django 服务器的第二种方法需要你安装 Gunicorn 和 Nginx 服务器。Gunicorn 是一个 Python WSGI HTTP 服务器。它将与 Django 应用程序交互,然后 Nginx 充当 Gunicorn 的反向代理。这种方法的额外好处是提供了使用 Nginx 带来的安全性和性能。

安装 Gunicorn。

(sample_proj) $ pip install gunicorn

在继续之前,我们需要测试 Gunicorn 是否能正常提供项目服务。运行以下命令来启动 Gunicorn。

(sample_proj) $ gunicorn --bind 0.0.0.0:8000 demoproject.wsgi:application

这将在 Django 之前运行的同一接口上启动 Gunicorn。要验证,请在浏览器中打开 URL http://:8000,你将看到相同的 Django 主页。这意味着 Gunicorn 运行正常。

测试完成后,在终端按 Ctrl + C 退出 Gunicorn。

退出虚拟环境,返回到普通的 shell。

(sample_proj) $ deactivate

步骤 8 - 为 Gunicorn 创建 Socket 与服务文件

第一步是创建一个 Gunicorn socket 文件。Gunicorn socket 将在启动时创建并监听连接。当连接发生时,systemd 会自动启动 Gunicorn 进程来处理它。

创建并打开 Gunicorn socket 文件进行编辑。

$ sudo nano /etc/systemd/system/gunicorn.socket

在其中粘贴如下代码。

[Unit]
Description=gunicorn socket

[Socket]
ListenStream=/run/gunicorn.sock

[Install]
WantedBy=sockets.target

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

接下来,创建并打开 Gunicorn 服务文件进行编辑。

$ sudo nano /etc/systemd/system/gunicorn.service

在其中粘贴如下代码。

[Unit]
Description=django gunicorn daemon
Requires=gunicorn.socket
After=network.target

[Service]
User=navjot
Group=nginx
WorkingDirectory=/home/navjot/dj-sample
ExecStart=/home/navjot/dj-sample/sample_proj/bin/gunicorn \
          -t 3000 \
          --access-logfile - \
          --workers 3 \
          --bind unix:/run/gunicorn.sock \
          demoproject.wsgi:application -w 2

[Install]
WantedBy=multi-user.target

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。将 navjot 替换为你的系统用户名。nginx 组将允许 Nginx 服务器与 Django 通信。

重新加载系统守护进程以刷新 systemd 文件。

$ sudo systemctl daemon-reload

启用并启动 Gunicorn socket 文件。

$ sudo systemctl start gunicorn.socket
$ sudo systemctl enable gunicorn.socket

检查 Gunicorn socket 的状态。

$ sudo systemctl status gunicorn.socket

你将收到类似的输出。

? gunicorn.socket - gunicorn socket
     Loaded: loaded (/etc/systemd/system/gunicorn.socket; enabled; vendor preset: disabled)
     Active: active (listening) since Thu 2022-10-13 04:19:28 UTC; 14s ago
      Until: Thu 2022-10-13 04:19:28 UTC; 14s ago
   Triggers: ? gunicorn.service
     Listen: /run/gunicorn.sock (Stream)
     CGroup: /system.slice/gunicorn.socket

Oct 13 04:19:28 django.nspeaks.xyz systemd[1]: Listening on gunicorn socket.

如你所查,Gunicorn 服务仍未运行。

$ sudo systemctl status gunicorn.service
? gunicorn.service - django gunicorn daemon
     Loaded: loaded (/etc/systemd/system/gunicorn.service; disabled; vendor preset: enabled)
     Active: inactive (dead)
TriggeredBy: ? gunicorn.socket

要测试 socket 激活机制,运行以下命令。

$ curl --unix-socket /run/gunicorn.sock localhost

你将在终端中收到 Django 主页的 HTML 输出。这同时会启动 Gunicorn 来提供应用程序服务。再次检查服务状态,你将看到它正在运行。

$ sudo systemctl status gunicorn.service
? gunicorn.service - django gunicorn daemon
     Loaded: loaded (/etc/systemd/system/gunicorn.service; disabled; vendor preset: disabled)
     Active: active (running) since Thu 2022-10-13 06:13:55 UTC; 1min 34s ago
TriggeredBy: ? gunicorn.socket
   Main PID: 157742 (gunicorn)
      Tasks: 4 (limit: 5915)
     Memory: 96.2M
        CPU: 1.198s
     CGroup: /system.slice/gunicorn.service
             ??157742 /home/navjot/dj-sample/sample_proj/bin/python3 /home/navjot/dj-sample/sample_proj/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunicorn.sock demoproject.wsgi:application -w 2
             ??157746 /home/navjot/dj-sample/sample_proj/bin/python3 /home/navjot/dj-sample/sample_proj/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunicorn.sock demoproject.wsgi:application -w 2
             ??157747 /home/navjot/dj-sample/sample_proj/bin/python3 /home/navjot/dj-sample/sample_proj/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunicorn.sock demoproject.wsgi:application -w 2
             ??157748 /home/navjot/dj-sample/sample_proj/bin/python3 /home/navjot/dj-sample/sample_proj/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunicorn.sock demoproject.wsgi:application -w 2
.......

步骤 9 - 安装 Nginx

最后一步是安装和配置 Nginx。Rocky Linux 自带了较旧版本的 Nginx。你需要下载官方 Nginx 仓库来安装最新版本。

创建并打开 /etc/yum.repos.d/nginx.repo 文件以创建官方 Nginx 仓库。

$ sudo nano /etc/yum.repos.d/nginx.repo

在其中粘贴如下代码。

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

安装 Nginx 服务器。

$ sudo dnf install nginx -y

验证安装。

$ nginx -v
nginx version: nginx/1.22.1

启用并启动 Nginx 服务器。

$ sudo systemctl enable nginx --now

检查服务器状态。

$ sudo systemctl status nginx
? nginx.service - nginx - high performance web server
     Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; vendor preset: disabled)
     Active: active (running) since Thu 2022-10-13 06:17:24 UTC; 1s ago
       Docs: http://nginx.org/en/docs/
    Process: 157900 ExecStart=/usr/sbin/nginx -c /etc/nginx/nginx.conf (code=exited, status=0/SUCCESS)
   Main PID: 157901 (nginx)
      Tasks: 2 (limit: 5915)
     Memory: 1.9M
        CPU: 18ms
     CGroup: /system.slice/nginx.service
             ??157901 "nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf"
             ??157902 "nginx: worker process"

Oct 13 06:17:24 django.example.com systemd[1]: Starting nginx - high performance web server...

步骤 10 - 安装 SSL

到目前为止,你的 Django 应用程序是通过明文 HTTP 连接提供的。强烈建议你通过 SSL 证书来保护它。为此,使用 Snapd 工具来安装 Certbot 工具。它需要 EPEL 仓库才能工作。

$ sudo dnf install epel-release

我们将使用 Snapd 来安装 Certbot。安装 Snapd。

$ sudo dnf install snapd

启用并启动 Snap 服务。

$ sudo systemctl enable snapd.socket --now

创建 Snapd 工作所需的必要链接。

$ sudo ln -s /var/lib/snapd/snap /snap
$ echo 'export PATH=$PATH:/var/lib/snapd/snap/bin' | sudo tee -a /etc/profile.d/snapd.sh

安装核心 Snapd 仓库。

$ sudo snap install core
$ sudo snap refresh core

安装 Certbot。

$ sudo snap install --classic certbot
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot

生成证书。以下命令还会自动配置 Nginx。

$ sudo certbot certonly --nginx --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m 
[email protected]
 -d django.example.com

上述命令会将证书下载到服务器上的 /etc/letsencrypt/live/django.example.com 目录。

生成 Diffie-Hellman 组证书。

$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096

要检查 SSL 续期是否正常工作,请对该过程进行一次演练(dry run)。

$ sudo certbot renew --dry-run

如果没有看到错误,你就设置完成了。你的证书将自动续期。

步骤 11 - 配置 Nginx

创建并打开文件 /etc/nginx/conf.d/django-gunicorn.conf 进行编辑。

$ sudo nano /etc/nginx/conf.d/django-gunicorn.conf

在其中粘贴如下代码。

# enforce HTTPS
server {
  listen 80 default_server;
  server_name django.example.com;
  return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name django.example.com;

    access_log  /var/log/nginx/django.access.log;
    error_log   /var/log/nginx/django.error.log;

    http2_push_preload on; # Enable HTTP/2 Server Push

    ssl_certificate /etc/letsencrypt/live/django.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/django.example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/django.example.com/chain.pem;
    ssl_session_timeout 1d;

    # Enable TLS versions (TLSv1.3 is required upcoming HTTP/3 QUIC).
    ssl_protocols TLSv1.2 TLSv1.3;

    # Enable TLSv1.3's 0-RTT. Use $ssl_early_data when reverse proxying to
    # prevent replay attacks.
    #
    # @see: https://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_early_data
    ssl_early_data on;

    ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384';
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:50m;

    # OCSP Stapling ---
    # fetch OCSP records from URL in ssl_certificate and cache them
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_dhparam /etc/ssl/certs/dhparam.pem;

    add_header X-Early-Data $tls1_3_early_data;

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        root /home/navjot/dj-sample;
    }

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://unix:/run/gunicorn.sock;
    }
}

# This block is useful for debugging TLS v1.3. Please feel free to remove this
# and use the `$ssl_early_data` variable exposed by NGINX directly should you
# wish to do so.
map $ssl_early_data $tls1_3_early_data {
  "~." $ssl_early_data;
  default "";
}

将上述文件中的 root 位置替换为你服务器上的目录。

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

打开文件 /etc/nginx/nginx.conf 进行编辑。

$ sudo nano /etc/nginx/nginx.conf

在 include /etc/nginx/conf.d/*.conf; 这一行之前添加如下行。

server_names_hash_bucket_size  64;

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

验证你的 Nginx 配置。

$ sudo nginx -t

如果没有看到错误,说明一切就绪。

你还需要将域名添加到 ALLOWED_HOSTS 指令中。打开 settings.py 文件。

$ nano ~/dj-sample/demoproject/settings.py

更改 ALLOWED_HOSTS 变量的值。

ALLOWED_HOSTS = ['<yourserver_ip_address>','django.example.com']

按 Ctrl + X 保存文件,并在提示时输入 Y 确认。

重启 Gunicorn Socket 与服务。

$ sudo systemctl restart gunicorn.socket
$ sudo systemctl restart gunicorn.service

重新加载 Nginx 服务器。

$ sudo systemctl reload nginx

开放 HTTP 端口。如果你不再使用 8000 端口,也可以将其删除。

$ sudo firewall-cmd --remove-port=8000/tcp --permanent
$ sudo firewall-cmd --reload

在浏览器中打开 URL http://django.example.com 进行验证,Django 主页将会加载。

总结

本教程到此结束,你学习了如何在 Rocky Linux 9 服务器上安装 Django 以及 Gunicorn 和 Nginx。你还安装了 SSL 证书以增强 Django 项目的安全性。如果你有任何问题,请在下方评论中留言。