香港服务器部署Django网站时,生产环境需要完成哪些配置与验证?

发布人:A5数据发布时间:2026-10-20 09:37阅读量:99

香港服务器上的 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。

五、使用 systemd 管理 Gunicorn配图

加载并启动服务:

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 返回 502systemctl status django-site、Gunicorn 日志、Nginx 错误日志应用未启动、端口不一致或进程启动后退出
Django 返回 400ALLOWED_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

相关推荐