本页目录
- 准备工作
- 步骤 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://

你可以通过 URL http://

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

完成演示项目后,你可以在终端中按 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://
测试完成后,在终端按 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 项目的安全性。如果你有任何问题,请在下方评论中留言。