在香港服务器上线Django 5.2 LTS应用,怎样配置进程守护?
上线后的目标状态是:域名通过 HTTPS 访问,Nginx 负责外部连接、静态文件和反向代理,Gunicorn 运行 Django 5.2 LTS,systemd 在进程异常退出后自动拉起并限制资源,日志能够按服务和请求入口分别查看,数据库与上传文件有可恢复备份。

下面以 Ubuntu 22.04/24.04、Python 3.10 及以上、Django 5.2.x、Nginx、Gunicorn 和 systemd 为例。示例域名使用 app.example.com,项目目录使用 /srv/django-app,Django 项目的 WSGI 模块使用 config.wsgi:application。实际部署时,需要根据项目的设置模块、数据库类型和目录结构替换这些值。
准备条件与目录规划
先确认系统、Python和服务管理方式
香港服务器所在地域不会改变 Django 的进程守护方式,但需要特别确认域名解析、IPv4/IPv6、云平台安全组和出站网络是否符合预期。先在服务器执行:
cat /etc/os-release
python3 --version
systemctl --version
nginx -v
timedatectl status
Django 5.2 应使用其支持范围内的 Python 版本。不要因为系统自带 Python 版本较旧,就直接替换系统 Python;如果当前版本不满足项目要求,应优先使用发行版提供的兼容包或单独的 Python 运行环境,并重新创建虚拟环境。
域名方面至少准备以下记录:
app.example.com的 A 记录指向服务器公网 IPv4。- 只有在服务器、云安全组和 Nginx 均已配置 IPv6 时,才添加 AAAA 记录。
- 80/TCP 用于 HTTP 访问和证书验证,443/TCP 用于 HTTPS。
- SSH 端口只对管理来源开放,不能因为开启防火墙而先把当前 SSH 会话挡在外面。
如果使用 UFW,先确认现有规则并备份记录。下面的启用操作会影响服务器全部入站流量,远程操作前应确认云厂商控制台或带外控制台可用:
sudo ufw status numbered
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
如果 SSH 使用了非标准端口,应把 22/tcp 替换为实际端口。防火墙规则调整前可记录当前状态:
sudo ufw status numbered | sudo tee /root/ufw-before-django-app.txt
发现配置错误时,回滚方式是从云安全组或控制台恢复规则;如果确认需要在服务器上解除 UFW,执行 sudo ufw disable 会影响全部本机防火墙防护,只能在已确认风险和访问路径的情况下使用。
创建运行用户和目录
不建议让 Gunicorn 以 root 身份运行。创建专用系统用户,并将应用、静态文件和上传文件分开:
id deploy >/dev/null 2>&1 || sudo adduser --system --group --home /srv/django-app deploy
sudo install -d -o deploy -g www-data -m 0750 /srv/django-app
sudo install -d -o deploy -g www-data -m 0750 /srv/django-app/releases
sudo install -d -o deploy -g www-data -m 0750 /srv/django-app/shared
sudo install -d -o deploy -g www-data -m 0750 /srv/django-app/shared/static
sudo install -d -o deploy -g www-data -m 0750 /srv/django-app/shared/media
sudo install -d -o deploy -g www-data -m 0750 /srv/django-app/shared/certbot
目录结构建议保持如下形式:
/srv/django-app/
├── current -> /srv/django-app/releases/20250601-120000
├── releases/
│ ├── 20250601-120000/
│ └── 20250602-093000/
├── shared/
│ ├── certbot/
│ ├── media/
│ └── static/
└── venv/
current 只指向当前上线版本,回滚时切换该软链接即可。数据库、上传文件和密钥不应放在单个 release 目录中,否则切换代码版本时可能误用旧配置或遗漏用户文件。
安装基础依赖并创建虚拟环境
以下命令适用于 Debian/Ubuntu。不要在没有确认发行版的情况下直接执行:
sudo apt update
sudo apt install -y nginx python3-venv python3-dev build-essential
如果依赖文件包含 PostgreSQL 驱动编译需求,再安装对应开发包:
sudo apt install -y libpq-dev
创建虚拟环境:
sudo -u deploy python3 -m venv /srv/django-app/venv
sudo -u deploy /srv/django-app/venv/bin/python -m pip install --upgrade pip wheel
生产环境应使用项目锁定的 requirements.txt、约束文件或其他依赖清单,不要在上线时无条件安装最新 Django 或最新数据库驱动。Django 版本可以在部署前确认:
sudo -u deploy /srv/django-app/venv/bin/python -m django --version
期望结果应为 5.2.x。如果项目依赖的 Django 小版本、数据库驱动或 Python 版本不匹配,应先在预发布环境解决,而不是在生产服务器上边升级边排查。
部署Django应用并准备生产设置
上传代码和安装依赖
将经过测试的代码放入新的 release 目录。代码上传方式可以是 CI/CD、受控的 Git 发布流程或压缩包传输,关键是不要直接覆盖正在运行的 current:
RELEASE="20250602-093000"
sudo -u deploy mkdir -p "/srv/django-app/releases/${RELEASE}"
# 将已经审核的项目文件放入:
# /srv/django-app/releases/20250602-093000
进入 release 目录后安装依赖:
sudo -u deploy /srv/django-app/venv/bin/python -m pip install \
-r "/srv/django-app/releases/${RELEASE}/requirements.txt"
sudo -u deploy /srv/django-app/venv/bin/python -m pip check
如果代码是从压缩包解压而来,应确认压缩包没有包含 .env、数据库备份、SSH 私钥和本地开发缓存。代码目录的所有者应为 deploy:
sudo chown -R deploy:www-data "/srv/django-app/releases/${RELEASE}"
不要对包含生产数据的 shared/media 目录执行带 --delete 的同步命令。此类命令会删除目标端多出的文件,必须在已有异地备份、确认路径无误且明确需要镜像同步时才使用。
保存生产环境变量
创建单独的环境变量文件,避免把密钥写入代码仓库或 systemd 服务的 ExecStart 命令:
sudo install -d -o root -g deploy -m 0750 /etc/django-app
sudo tee /etc/django-app/app.env >/dev/null <<'EOF'
DJANGO_SETTINGS_MODULE=config.settings.production
DJANGO_DEBUG=0
DJANGO_SECRET_KEY=replace-with-a-long-random-secret
DJANGO_ALLOWED_HOSTS=app.example.com
DJANGO_CSRF_TRUSTED_ORIGINS=https://app.example.com
DATABASE_URL=postgresql://app_user:replace-password@db.example.internal:5432/app_db
EOF
sudo chown root:deploy /etc/django-app/app.env
sudo chmod 0640 /etc/django-app/app.env
上面的变量名只是常见示例,项目的设置文件必须真正读取这些变量。DATABASE_URL 的格式也要与项目所使用的配置库一致。如果数据库在本机,地址可以使用本机地址;如果数据库在独立服务器,还应在数据库侧限制来源地址和账号权限。
生产设置至少应确认以下内容:
DEBUG = False
ALLOWED_HOSTS = ["app.example.com"]
CSRF_TRUSTED_ORIGINS = ["https://app.example.com"]
STATIC_ROOT = "/srv/django-app/shared/static"
MEDIA_ROOT = "/srv/django-app/shared/media"
SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
SECURE_SSL_REDIRECT = True
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
ALLOWED_HOSTS、CSRF_TRUSTED_ORIGINS 和实际域名必须一致。只有在全部相关域名都已经支持 HTTPS 后,才逐步启用较长的 HSTS 时间;初次上线可以先使用较短值,确认没有 HTTP 子域名依赖后再调整。
执行Django检查、迁移和静态文件收集
先让 Django 读取生产环境变量并执行部署检查。以下命令不会修改数据库:
sudo -u deploy env RELEASE="${RELEASE}" bash -lc '
set -a
. /etc/django-app/app.env
set +a
cd "/srv/django-app/releases/$RELEASE"
/srv/django-app/venv/bin/python manage.py check --deploy
'
数据库迁移会改变数据结构,执行前必须完成数据库备份,并先查看迁移计划:
sudo -u deploy env RELEASE="${RELEASE}" bash -lc '
set -a
. /etc/django-app/app.env
set +a
cd "/srv/django-app/releases/$RELEASE"
/srv/django-app/venv/bin/python manage.py migrate --plan
'
确认迁移内容、锁表影响和维护窗口后再执行:
sudo -u deploy env RELEASE="${RELEASE}" bash -lc '
set -a
. /etc/django-app/app.env
set +a
cd "/srv/django-app/releases/$RELEASE"
/srv/django-app/venv/bin/python manage.py migrate --noinput
'
迁移期间不要同时运行多个相同的迁移任务。对于新增字段、重命名字段和删除字段,优先采用“扩展—切换—收缩”的兼容方式:先添加新结构,再部署读取新旧结构均可工作的代码,确认流量稳定后再删除旧结构。这样代码回滚时,旧版本仍有机会继续工作。
收集静态文件到共享目录:
sudo -u deploy env RELEASE="${RELEASE}" bash -lc '
set -a
. /etc/django-app/app.env
set +a
cd "/srv/django-app/releases/$RELEASE"
/srv/django-app/venv/bin/python manage.py collectstatic --noinput
'
迁移和静态文件收集分别作用于数据库和文件系统。迁移失败时不要简单切换代码版本来“恢复”;先查看数据库错误和当前迁移状态,避免让代码版本与数据库结构不一致。
完成检查后记录旧版本,并切换 current:
OLD_RELEASE="$(readlink -f /srv/django-app/current 2>/dev/null || true)"
printf 'old release: %s\n' "$OLD_RELEASE"
sudo ln -sfnT \
"/srv/django-app/releases/${RELEASE}" \
/srv/django-app/current
这一步只替换应用版本软链接,不应删除旧 release。旧版本要保留到本次发布验证完成,便于快速回滚。
使用systemd守护Gunicorn进程
创建服务单元
创建 /etc/systemd/system/django-app.service:

[Unit]
Description=Django application Gunicorn service
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=60
StartLimitBurst=5
[Service]
Type=exec
User=deploy
Group=www-data
WorkingDirectory=/srv/django-app/current
EnvironmentFile=/etc/django-app/app.env
RuntimeDirectory=django-app
RuntimeDirectoryMode=0750
UMask=0007
ExecStart=/srv/django-app/venv/bin/gunicorn \
--workers 2 \
--threads 2 \
--worker-class gthread \
--timeout 60 \
--graceful-timeout 30 \
--max-requests 1000 \
--max-requests-jitter 100 \
--access-logfile - \
--error-logfile - \
--capture-output \
--bind unix:/run/django-app/gunicorn.sock \
config.wsgi:application
ExecReload=/bin/kill -s HUP $MAINPID
KillSignal=SIGQUIT
TimeoutStopSec=30
Restart=on-failure
RestartSec=5
LimitNOFILE=65536
# 仅在已经核算过应用预算时启用,数值不是所有服务器的通用值
# MemoryMax=2G
# TasksMax=128
[Install]
WantedBy=multi-user.target
需要根据项目实际情况替换 config.wsgi:application。如果项目使用的是其他模块,例如 project.wsgi:application,必须改成真实路径。Django 同步视图适合使用 WSGI 加 Gunicorn;如果项目明确使用 ASGI、长连接或异步协议,应按项目的 ASGI 部署方式调整,不能直接套用本配置。
--workers 2 --threads 2 只是资源较小实例的起始值,不是固定标准。进程数过高会增加内存和数据库连接数,过低则可能在并发请求时出现排队。修改服务文件后执行:
sudo systemctl daemon-reload
sudo systemctl enable django-app
sudo systemctl restart django-app
sudo systemctl status django-app --no-pager
确认服务正常运行:
sudo systemctl is-active django-app
sudo ss -xl | grep '/run/django-app/gunicorn.sock'
sudo journalctl -u django-app -n 100 --no-pager
systemd 的 Restart=on-failure 只负责在进程异常退出时重新启动,并不能修复导入错误、环境变量缺失、数据库连接失败等根因。服务反复重启时,先停止反复尝试发布,使用 journalctl 查看第一条异常,而不是只看最后一条“服务已重启”。
让进程拥有明确的资源边界
资源限制应基于服务器规格、请求类型和数据库容量调整。下面是一个用于起步的参考关系:
| 资源项 | 示例起始值 | 主要影响 | 验证方式 |
|---|---|---|---|
| Gunicorn worker | 2 个 | CPU并发、内存占用 | ps、请求延迟、CPU使用率 |
| 每个 worker 的线程 | 2 个 | I/O等待时的并发能力 | 应用响应时间、数据库连接数 |
| 请求超时 | 60 秒 | 防止请求无限占用 worker | Gunicorn 日志、接口耗时 |
| 单请求上传限制 | 20 MB | Nginx和应用内存压力 | Nginx返回码、上传接口测试 |
| 服务内存上限 | 按预算设置 | 防止挤占系统和其他服务 | systemctl show、OOM日志 |
| 文件描述符 | 65536 | 高并发连接和日志文件数量 | systemctl show、ulimit |
以 2 vCPU、4 GB 内存且数据库独立部署的服务器为例,可以从 2 个 worker、每个 2 个线程开始观察。若数据库与应用同机,数据库、Nginx、系统缓存和备份进程都要从 4 GB 中分配内存,此时不能直接给应用设置 2 GB 上限。
如果启用 MemoryMax,它只限制该 systemd 服务的 cgroup,不代表整台服务器拥有同样的可用内存。限制过低会触发进程被杀,限制过高则失去边界意义。建议先运行一段时间,观察:
systemctl show django-app \
-p MemoryCurrent \
-p MemoryPeak \
-p TasksCurrent \
-p TasksMax
free -h
ps -eo pid,ppid,user,rss,cmd --sort=-rss | head -n 15
Django 的数据库连接数量通常会随进程和线程增加。2 个 worker、每个 2 个线程,应用侧可能产生约 4 个并发连接,再加上管理任务、迁移和监控连接;实际数量取决于连接复用配置和数据库驱动。数据库的最大连接数必须为应用、管理工具和其他服务预留空间。
A5数据提供香港物理服务器租用,涵盖Xeon Gold与AMD EPYC等平台,搭配不同容量的内存及SSD、NVMe存储,为Django应用、Gunicorn多进程运行和数据库服务提供计算与存储资源。香港产品中的CN2与国际带宽方案,可承接面向不同访问地区的网络需求,让企业网站、业务后台和接口服务的部署具备从应用运行到数据读写、对外访问的基础资源支撑。
配置Nginx反向代理和HTTPS
先配置HTTP和证书验证路径
保存现有 Nginx 配置,避免覆盖其他站点:
sudo tar --xattrs --acls -czf \
"/root/nginx-before-django-app-$(date +%Y%m%d-%H%M%S).tar.gz" \
/etc/nginx
创建初始站点配置 /etc/nginx/sites-available/django-app:
server {
listen 80;
listen [::]:80;
server_name app.example.com;
location /.well-known/acme-challenge/ {
root /srv/django-app/shared/certbot;
}
location /static/ {
alias /srv/django-app/shared/static/;
}
location /media/ {
alias /srv/django-app/shared/media/;
}
location / {
proxy_pass http://unix:/run/django-app/gunicorn.sock:;
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-Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 60s;
proxy_redirect off;
}
}
启用站点前确认 sites-enabled 中没有重复的 server_name:
sudo ln -sfn \
/etc/nginx/sites-available/django-app \
/etc/nginx/sites-enabled/django-app
sudo nginx -t
sudo systemctl reload nginx
如果 nginx -t 失败,不要 reload。检查错误提示、重复监听端口和配置文件路径,必要时恢复刚才的站点文件备份。nginx -t 通过后再 reload,通常不会中断现有连接。
申请证书并切换HTTPS
安装证书工具:
sudo apt install -y certbot
确认 DNS 已生效,并通过 HTTP 访问挑战路径后申请证书:
sudo certbot certonly \
--webroot \
-w /srv/django-app/shared/certbot \
-d app.example.com \
--email admin@example.com \
--agree-tos \
--no-eff-email
证书申请需要域名能够从公网访问服务器的 80 端口。不要在 DNS 尚未生效或 Nginx 配置反复变化时连续重复申请,以免触发证书机构的频率限制。
证书成功后,将站点配置替换为 HTTPS 版本:

server {
listen 80;
listen [::]:80;
server_name app.example.com;
location /.well-known/acme-challenge/ {
root /srv/django-app/shared/certbot;
}
location / {
return 301 https://$host$request_uri;
}
}
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name app.example.com;
ssl_certificate /etc/letsencrypt/live/app.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/app.example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_timeout 1d;
client_max_body_size 20m;
access_log /var/log/nginx/django-app.access.log;
error_log /var/log/nginx/django-app.error.log warn;
location /static/ {
alias /srv/django-app/shared/static/;
access_log off;
expires 7d;
add_header Cache-Control "public, max-age=604800";
}
location /media/ {
alias /srv/django-app/shared/media/;
access_log off;
}
location / {
proxy_pass http://unix:/run/django-app/gunicorn.sock:;
proxy_http_version 1.1;
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-Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
proxy_redirect off;
}
}
client_max_body_size 只限制 Nginx 接收的请求体大小,Django 表单、应用服务器和对象存储可能还有其他限制。上传文件属于用户数据,若不应公开访问,不要直接用 Nginx 的 /media/ 目录暴露,应改为鉴权下载或由应用返回文件。
检查并加载配置:
sudo nginx -t
sudo systemctl reload nginx
验证自动续期任务:
sudo certbot renew --dry-run
systemctl list-timers | grep -i certbot
续期失败不会自动说明当前证书已经失效,应先查看 Certbot 输出和 Nginx 配置。不要删除 /etc/letsencrypt 下的有效证书;如果新配置有误,恢复站点配置即可,现有证书本身通常仍可继续使用。
日志、备份和上线验证
查看应用、代理和系统日志
Gunicorn 的标准输出和错误输出由 systemd journal 接收:
sudo journalctl -u django-app -f
sudo journalctl -u django-app --since "30 minutes ago" --no-pager
Nginx 日志分别位于:
sudo tail -f /var/log/nginx/django-app.access.log
sudo tail -f /var/log/nginx/django-app.error.log
检查日志占用:
sudo journalctl --disk-usage
sudo du -sh /var/log/nginx
Ubuntu 通常已为 Nginx 配置 logrotate。若修改 journald 保留策略,应注意它是主机级设置,会影响其他 systemd 服务。例如:
# /etc/systemd/journald.conf.d/django-app.conf
[Journal]
SystemMaxUse=1G
MaxRetentionSec=14day
该配置会改变整台服务器的 journal 保留范围,写入前应确认磁盘容量和其他服务的审计需求。不要为了释放空间直接删除正在用于故障分析的日志;需要清理旧日志时,先导出或确认保留周期,再执行清理。
建立可恢复的备份
至少需要分别考虑数据库、上传文件、环境变量、Nginx 配置和证书。静态文件可以通过重新执行 collectstatic 生成,但上传文件和数据库不能依赖代码重新构建。
如果使用 PostgreSQL,可以先在数据库所在主机执行类似备份。下面命令仅适用于 PostgreSQL,数据库名和连接参数需要替换:
sudo install -d -o root -g root -m 0700 /var/backups/django-app
sudo -u postgres pg_dump \
--format=custom \
--file="/var/backups/django-app/app-$(date +%Y%m%d-%H%M%S).dump" \
app_db
sudo chmod 0600 /var/backups/django-app/*.dump
如果数据库是远程实例,应使用远程数据库的备份策略或从具备访问权限的备份主机执行 pg_dump。本机备份只能应对部分误操作,不能应对服务器磁盘损坏或整机故障,备份文件应复制到独立存储,并限制访问权限。
备份上传文件:
sudo tar --xattrs --acls -czf \
"/var/backups/django-app/media-$(date +%Y%m%d-%H%M%S).tar.gz" \
-C /srv/django-app/shared media
sudo chmod 0600 /var/backups/django-app/media-*.tar.gz
备份环境和关键配置:
sudo tar --xattrs --acls -czf \
"/var/backups/django-app/config-$(date +%Y%m%d-%H%M%S).tar.gz" \
/etc/django-app \
/etc/nginx/sites-available/django-app \
/etc/letsencrypt
证书私钥和环境变量都属于敏感数据,备份必须加密或存放在受控位置。一次备份命令成功不等于备份可用,应定期在隔离数据库和临时目录执行恢复演练,验证:
- 数据库备份可以被数据库工具读取。
- 上传文件数量和关键文件校验值符合预期。
- 恢复后的数据库可以被目标版本 Django 连接。
- 环境变量中没有被截断或错误转义的密钥。
- 恢复 Nginx 配置后能够通过
nginx -t。
执行上线验证
先验证服务和 Nginx:
sudo systemctl is-active django-app
sudo systemctl is-enabled django-app
sudo nginx -t
sudo ss -ltnp | grep -E ':80|:443'
sudo ss -xl | grep '/run/django-app/gunicorn.sock'
通过域名检查跳转和 HTTPS:
curl -I http://app.example.com
curl -I https://app.example.com
预期结果通常是 HTTP 返回 301 或 308,HTTPS 返回应用实际状态码。若应用提供健康检查路径,可以进一步执行:
curl -fsS https://app.example.com/healthz/
如果 DNS 尚未完全生效,可用 --resolve 指向服务器公网地址:
curl -fsS \
--resolve app.example.com:443:SERVER_PUBLIC_IP \
https://app.example.com/healthz/
检查证书有效期和域名:
echo | openssl s_client \
-connect app.example.com:443 \
-servername app.example.com 2>/dev/null |
openssl x509 -noout -subject -issuer -dates
最后检查静态文件、登录、表单提交、文件上传和数据库读写。仅用首页返回 200 不能证明 CSRF、数据库连接、静态文件权限和上传流程全部正常。
常见失败处理与回滚
502 Bad Gateway
按由外到内的顺序排查:

sudo nginx -t
sudo systemctl status django-app --no-pager
sudo journalctl -u django-app -n 100 --no-pager
sudo ls -l /run/django-app/gunicorn.sock
常见对应关系如下:
- Nginx 配置测试失败:说明代理配置本身有误,不要 reload,先修复配置。
- systemd 服务未运行:重点查看 Gunicorn 导入错误、依赖缺失、环境变量和数据库连接。
- socket 不存在:Gunicorn 没有成功启动,或
RuntimeDirectory、ExecStart路径不一致。 - socket 存在但权限不足:检查 Nginx 运行用户是否为
www-data,以及 socket 所属组和父目录权限。 - socket 正常但请求超时:检查应用慢查询、外部服务调用和 Gunicorn 超时设置。
400、403或CSRF失败
400 Bad Request 常见于 ALLOWED_HOSTS 未包含访问域名;403 CSRF verification failed 常见于 CSRF_TRUSTED_ORIGINS 没有使用带协议的 HTTPS 地址,或 Nginx 没有传递:
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
修改环境变量或设置文件后,需要重启 Gunicorn:
sudo systemctl restart django-app
重启会造成短暂连接中断,适合在低流量时段执行。修改后重新访问登录页和表单接口,不要只通过首页判断问题已解决。
静态文件404或权限错误
先确认文件是否存在:
sudo find /srv/django-app/shared/static -maxdepth 2 -type f | head
sudo namei -l /srv/django-app/shared/static
然后检查:
STATIC_ROOT是否指向/srv/django-app/shared/static。- 是否对当前 release 执行了
collectstatic。 - Nginx
alias是否以/结尾。 - Nginx 用户是否能穿过
/srv/django-app/shared的父目录。 - 是否把
/static/错误地代理到了 Django,而不是由 Nginx 直接读取。
不要为了快速解决 403 执行全盘 chmod 777。权限调整应只作用于应用目录,并保持应用代码、静态文件和上传文件的访问边界。
服务反复重启或内存不足
查看首次错误和内核日志:
sudo journalctl -u django-app --since "10 minutes ago" --no-pager
sudo journalctl -k --since "10 minutes ago" | grep -i -E 'oom|killed process'
如果是内存不足,先降低 worker 或线程数量、暂停同机备份任务,再根据实际峰值调整 MemoryMax。如果是某个请求触发内存持续增长,可以保留 --max-requests 和 --max-requests-jitter 作为临时缓解,但仍需定位代码、查询或第三方库问题。
代码回滚
回滚前确认旧 release 仍存在:
OLD_RELEASE="/srv/django-app/releases/20250601-120000"
test -d "$OLD_RELEASE"
sudo ln -sfnT "$OLD_RELEASE" /srv/django-app/current
sudo systemctl restart django-app
sudo systemctl status django-app --no-pager
这会让应用代码回到指定版本,但不会自动撤销已经执行的数据库迁移。如果新版本只增加了向后兼容的字段,通常可以先恢复旧代码;如果迁移删除了字段、改变了数据类型或改变了约束,直接回滚代码可能导致启动或写入失败。
数据库回滚必须以迁移记录和备份为依据。不要直接对生产库执行 migrate app zero 或删除表来“恢复”。优先在隔离数据库中验证备份恢复,再根据停机窗口切换数据库连接或执行经过审核的恢复方案。
Nginx配置回滚
如果新配置尚未 reload,nginx -t 失败时不需要回滚运行中的 Nginx。若已经加载新配置并出现访问异常,只恢复具体站点文件,不要覆盖整套 /etc/nginx,以免影响其他站点:
sudo cp -a \
/root/nginx-before-django-app-YYYYMMDD-HHMMSS.tar.gz \
/root/
# 从备份中提取对应的站点文件到临时目录后,确认内容再覆盖
sudo nginx -t
sudo systemctl reload nginx
备份文件名中的时间需要替换为实际生成的文件。恢复后必须再次执行 nginx -t,通过后才能 reload。
上线验收清单
- [ ] 服务器 Python 版本满足 Django 5.2.x 和项目依赖要求。
- [ ] 应用使用
deploy等非 root 用户运行。 - [ ]
current指向经过检查的新 release,旧 release 尚未删除。 - [ ]
DEBUG=False,ALLOWED_HOSTS和CSRF_TRUSTED_ORIGINS使用实际域名。 - [ ]
python manage.py check --deploy已执行并处理关键警告。 - [ ] 数据库迁移前有可验证的备份,迁移计划经过确认。
- [ ]
collectstatic已完成,静态目录由 Nginx 正常读取。 - [ ] systemd 服务已启用,重启服务器后能够自动启动。
- [ ] Gunicorn socket 存在,Nginx 用户具备访问权限。
- [ ] Nginx 配置通过
nginx -t,HTTP 能跳转到 HTTPS。 - [ ] HTTPS 证书域名和有效期正确,
certbot renew --dry-run已验证。 - [ ] 应用日志可通过
journalctl -u django-app查看。 - [ ] Nginx 访问日志和错误日志已配置轮换或保留策略。
- [ ] 数据库、上传文件、环境变量和 Nginx 配置已备份到独立位置。
- [ ] 已验证登录、数据库读写、静态文件、表单提交和上传流程。
- [ ] 已记录当前 release、旧 release、数据库备份位置和回滚负责人。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3389.html



