香港服务器部署Django网站时,生产环境需要完成哪些配置与验证?
香港服务器上的 Django 网站要从“能启动”进入生产环境,至少需要完成应用配置、进程托管、Nginx 入口、HTTPS、静态文件、日志和上线验证。服务器位于香港不会改变 Django 的部署方式,但访问延迟、域名解析和回源连通性仍应从目标用户所在网络验证,不能只凭服务器本机测试判断体验。
下面以 Ubuntu 22.04/24.04、Python 虚拟环境、Gunicorn、systemd、Nginx 和已有 PostgreSQL 数据库为例。示例中的域名、目录、项目包名、数据库连接信息都需要替换;如果使用其他发行版、数据库或部署方式,应先核对对应软件的服务名和配置路径。
A5数据提供中国香港物理服务器租用,覆盖常规建站、业务后台、数据库和接口服务等 Django 应用场景,可搭配 SSD 或 NVMe 存储、不同规格的 CPU 与内存,并提供 CN2、国际带宽等线路资源,为 Nginx、Gunicorn、PostgreSQL 等生产环境组件提供相应的服务器基础。
一、准备条件
开始前确认以下内容:
- 已有可通过 SSH 管理的香港服务器,并确认系统版本、CPU、内存、磁盘空间和公网 IP。
- 域名的 A 记录已指向服务器公网 IPv4;若配置了 AAAA 记录,服务器也必须能通过 IPv6 提供服务。DNS 变更后可用
dig +short example.com A检查解析结果。 - Django 项目在本地或代码仓库中可以正常安装,已整理生产依赖,例如
requirements.txt;项目包名以下用myproject表示。 - 数据库已创建,生产环境可以连接;数据库账号只授予应用需要的权限。若数据库在其他主机,先确认防火墙只允许必要来源访问数据库端口。
- 已准备 Django
SECRET_KEY、数据库密码和域名。不要将生产密钥提交到代码仓库,也不要在命令行历史或公开工单中粘贴密码。 - 若服务器上已有网站,修改 Nginx、防火墙或证书前先备份对应配置,并确认变更不会影响其他站点。
本文采用 /srv/django-site 作为应用目录,djangoapp 作为运行用户。首次上线到空数据库时,迁移通常不会影响已有业务数据;若数据库已有数据,运行迁移前必须先完成可恢复的备份,并确认迁移脚本的影响范围。
二、安装运行环境并准备应用
先 SSH 登录服务器,核对系统版本和时间:
cat /etc/os-release
timedatectl status
在 Ubuntu 上更新软件包索引并安装 Python 虚拟环境、编译工具和 Nginx:
sudo apt update
sudo apt install -y python3-venv python3-dev build-essential nginx
检查工具是否可用:
python3 --version
nginx -v
systemctl is-active nginx
预期能看到 Python、Nginx 版本,且 Nginx 返回 active。如果服务器已经承担其他站点,不要为了部署 Django 重装或覆盖 Nginx 配置。
创建专用运行账号和应用目录:
sudo adduser --system --group --home /srv/django-site djangoapp
sudo install -d -o djangoapp -g www-data -m 2750 /srv/django-site
将项目代码部署到 /srv/django-site。例如从受控代码仓库拉取,或通过安全的发布流程上传;不建议直接把开发机中的虚拟环境一并复制到服务器。确认目录结构中存在 manage.py 和项目包目录:
sudo -u djangoapp find /srv/django-site -maxdepth 2 -name manage.py -o -name wsgi.py
创建虚拟环境并安装依赖:
sudo -u djangoapp python3 -m venv /srv/django-site/venv
sudo -u djangoapp /srv/django-site/venv/bin/pip install --upgrade pip
sudo -u djangoapp /srv/django-site/venv/bin/pip install -r /srv/django-site/requirements.txt
sudo -u djangoapp /srv/django-site/venv/bin/pip install gunicorn
如果依赖安装失败,先检查错误是否指向缺失的系统开发库、Python 版本不兼容或包版本约束,不要通过随意升级所有依赖来绕过问题。项目依赖应在测试环境验证后再固定版本。
三、设置生产配置并验证 Django
Django 生产配置应从环境变量读取敏感信息。以下字段需按项目现有配置调整,不能把示例密钥直接用于生产:
import os
DEBUG = False
SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]
ALLOWED_HOSTS = [
"example.com",
"www.example.com",
]
CSRF_TRUSTED_ORIGINS = [
"https://example.com",
"https://www.example.com",
]
STATIC_URL = "static/"
STATIC_ROOT = "/srv/django-site/staticfiles"
SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
如果网站暂时只启用一个域名,就不要把未使用的主机名加入 ALLOWED_HOSTS。SECURE_PROXY_SSL_HEADER 仅适用于由可信任的 Nginx 转发请求、且 Nginx 会正确设置 X-Forwarded-Proto 的部署;不要让应用直接信任来自任意客户端的转发头。
创建环境变量文件。下面用占位内容说明格式,实际写入时应替换为随机生成的密钥和有效数据库信息:
sudo install -o root -g djangoapp -m 640 /dev/null /etc/django-site.env
sudoedit /etc/django-site.env
文件内容示例:
DJANGO_SETTINGS_MODULE=myproject.settings
DJANGO_SECRET_KEY=替换为生产环境随机密钥
DATABASE_NAME=替换为数据库名
DATABASE_USER=替换为数据库账号
DATABASE_PASSWORD=替换为数据库密码
DATABASE_HOST=127.0.0.1
DATABASE_PORT=5432
Django 项目还必须在设置文件中读取这些数据库变量,并配置 DATABASES。如果数据库不在本机,将 DATABASE_HOST 改为数据库实际地址,并在数据库侧限制来源 IP。检查权限和配置文件是否可读:
sudo stat -c '%U:%G %a %n' /etc/django-site.env
sudo -u djangoapp test -r /etc/django-site.env && echo "环境文件可读"
预期权限为 root:djangoapp 640,应用用户可读,其他用户不可读。接下来在项目目录检查 Django 配置:
cd /srv/django-site
sudo -u djangoapp bash -c 'set -a; source /etc/django-site.env; set +a; ./venv/bin/python manage.py check --deploy'
该命令会给出生产配置检查结果或警告。警告应结合项目实际处理,不要简单关闭检查。若报错,优先检查设置模块名称、必需环境变量、ALLOWED_HOSTS 和依赖版本。
四、初始化数据并收集静态文件
确认数据库连通后,再执行数据库迁移。若目标库已有数据,迁移前完成数据库备份,并确认备份可用于恢复:
cd /srv/django-site
sudo -u djangoapp bash -c 'set -a; source /etc/django-site.env; set +a; ./venv/bin/python manage.py migrate'
预期迁移逐项显示 OK。若出现连接失败,检查数据库地址、端口、防火墙、账号权限及数据库服务状态;不要通过开放数据库端口给所有公网地址来解决连通问题。
收集静态文件:
sudo -u djangoapp bash -c 'set -a; source /etc/django-site.env; set +a; ./venv/bin/python manage.py collectstatic --noinput'
预期命令完成并在 /srv/django-site/staticfiles 生成文件。Django 管理后台页面缺少样式时,应先确认 STATIC_ROOT、STATIC_URL 和 Nginx 静态目录映射一致,而不是将 DEBUG 改为 True。
五、使用 systemd 管理 Gunicorn
创建 systemd 服务,使应用在后台运行,并在服务器重启后自动启动:
sudoedit /etc/systemd/system/django-site.service
写入配置:
[Unit]
Description=Django site via Gunicorn
After=network.target
[Service]
User=djangoapp
Group=www-data
WorkingDirectory=/srv/django-site
EnvironmentFile=/etc/django-site.env
ExecStart=/srv/django-site/venv/bin/gunicorn \
--workers 3 \
--bind 127.0.0.1:8001 \
myproject.wsgi:application
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
myproject.wsgi:application 必须与项目实际 WSGI 模块对应。--workers 3 只是小型站点的示例值,不是通用容量结论;工作进程数应结合 CPU、内存、请求耗时和任务类型调整。此配置将 Gunicorn 绑定到本机回环地址,外部访问必须经过 Nginx。

加载并启动服务:
sudo systemctl daemon-reload
sudo systemctl enable --now django-site
sudo systemctl status django-site --no-pager
验证本机应用是否响应:
curl -I -H 'Host: example.com' http://127.0.0.1:8001/
收到 HTTP 响应说明 Gunicorn 已接收请求;具体状态码还要结合网站路由判断。502 或连接失败时,查看服务日志:
sudo journalctl -u django-site -n 100 --no-pager
常见原因包括 WSGI 模块名错误、环境变量缺失、数据库连接失败和项目目录权限不足。修正后执行 sudo systemctl restart django-site,再重复本机请求验证。
六、配置 Nginx 入口与 HTTPS
创建 Nginx 站点配置:
sudoedit /etc/nginx/sites-available/django-site
先配置 HTTP 入口。静态目录必须与 Django 的 STATIC_ROOT 一致:
server {
listen 80;
server_name example.com www.example.com;
location /static/ {
alias /srv/django-site/staticfiles/;
}
location / {
proxy_pass http://127.0.0.1:8001;
proxy_set_header Host $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;
}
}
启用配置并检查语法:
sudo ln -s /etc/nginx/sites-available/django-site /etc/nginx/sites-enabled/django-site
sudo nginx -t
如果语法检查成功,再重新加载:
sudo systemctl reload nginx
若已有默认站点占用了相同域名或监听配置,先查明冲突来源,不要直接删除其他站点配置。验证 HTTP 入口:
curl -I http://example.com/
预期收到网站的 HTTP 响应。若本机 Gunicorn 正常但域名请求返回 502,检查 Nginx 错误日志和 proxy_pass 端口;若返回 Django 的 400 Bad Request,检查 ALLOWED_HOSTS。
HTTPS 证书签发前,确认域名解析到该服务器,且云平台安全组与系统防火墙允许外部访问 TCP 80、443。以 Ubuntu 软件仓库可提供 Certbot 的环境为例:
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com
按提示完成邮箱和证书配置。签发后检查 Nginx 配置并请求 HTTPS:
sudo nginx -t
curl -I https://example.com/
确认 HTTPS 可访问、证书域名匹配后,再按需要启用 HSTS。初次上线不宜直接设置很长的 HSTS 有效期;配置错误可能导致浏览器在修复前仍强制使用 HTTPS。检查证书自动续期定时器和模拟续期:
systemctl list-timers | grep -i certbot
sudo certbot renew --dry-run
若证书签发失败,常见原因是 DNS 尚未生效、80 端口不可达、域名指向了错误 IP,或 Nginx 配置无法通过语法检查。先从外部网络确认域名解析与端口可达,再重试签发。
七、防火墙、日志与外部验证
先确认 SSH 端口已放行,再启用 UFW。若服务器使用非默认 SSH 端口,应替换下方规则中的端口;操作前确认仍有可用的控制台或管理通道,避免防火墙规则错误导致失联:
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw status
确认规则无误后再启用:
sudo ufw enable
sudo ufw status verbose
云平台安全组也需要单独核对:公网通常只开放必要的 SSH 管理端口和网站的 TCP 80、443;Gunicorn 的 8001 端口不应对公网开放。若启用 UFW 后无法连接,应通过云平台控制台检查规则并恢复 SSH 访问,不要盲目清空全部防火墙规则。
检查服务日志和 Nginx 日志:
sudo journalctl -u django-site --since "30 minutes ago" --no-pager
sudo tail -n 100 /var/log/nginx/access.log
sudo tail -n 100 /var/log/nginx/error.log
用不在服务器上的网络测试域名访问,可以区分“服务器本机正常”和“公网链路正常”。至少验证首页、登录或核心业务页面、静态文件、HTTPS 证书及一个需要数据库的功能。香港服务器到不同地区的访问表现可能不同,宜从实际用户所在网络抽样检查;单次 curl 响应不能代表所有运营商或地区的访问体验。

八、上线异常处理与回滚
异常处理按从入口到应用的顺序进行,避免在没有证据时直接修改数据库或关闭安全配置:
| 现象 | 优先检查 | 判断方向 |
|---|---|---|
| 域名无法访问 | DNS、云安全组、UFW、80/443 端口 | 解析或端口不通时,请求尚未到达 Nginx |
| Nginx 返回 502 | systemctl status django-site、Gunicorn 日志、Nginx 错误日志 | 应用未启动、端口不一致或进程启动后退出 |
| Django 返回 400 | ALLOWED_HOSTS 与请求域名 | 请求 Host 不在允许列表中 |
| 页面有内容但缺少样式 | STATIC_ROOT、collectstatic、Nginx alias 和目录权限 | 静态文件未生成、路径不一致或 Nginx 无权读取 |
| HTTPS 报证书错误 | 证书域名、有效期、Nginx 证书配置 | 证书不匹配、未签发成功或配置未加载 |
| 页面报数据库错误 | 环境变量、数据库可达性、账号权限 | 应用无法连接数据库或迁移未完成 |
代码上线出现问题时,优先回到上一版经过验证的代码和依赖,而不是删除数据库表或随意执行反向迁移。较稳妥的发布方式是保留带版本号的发布目录,并让 /srv/django-site/current 指向当前版本;回滚时先停止或切回应用版本,恢复先前的依赖和配置,再重启 Gunicorn 并验证。若使用本文的单目录示例,应在覆盖代码前备份旧代码、依赖清单和配置文件。

数据库迁移需单独判断是否可逆。迁移已改变或删除生产数据时,切回旧代码未必能恢复数据;应优先使用上线前的数据库备份恢复,并评估恢复时间和数据丢失范围。回滚数据库前应暂停写入或维护入口,避免恢复期间继续产生新数据。Nginx 配置变更应先备份文件,回滚时恢复备份、执行 sudo nginx -t,通过后再 reload。
九、上线验收项
发布结束后逐项确认:
- Django
check --deploy无未处理的关键配置问题,DEBUG=False,密钥和数据库凭据未写入代码仓库。 django-site服务为active,服务器重启后服务能自动启动;Gunicorn 只监听本机地址。- Nginx 配置通过
nginx -t,域名首页和核心业务请求均可通过 HTTPS 访问。 - 静态文件正常加载,涉及数据库的功能通过验证;生产数据库的迁移记录与预期一致。
- SSH 管理端口未被防火墙误封,公网仅开放实际需要的服务端口。
- 应用、Nginx 和证书续期日志可检查;证书续期模拟测试通过。
- 已明确代码回滚位置、配置备份位置和数据库恢复方式;任何涉及数据回退的操作都具备可用备份及恢复步骤。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4671.html



