在香港服务器上线Django 5.2 LTS应用,怎样配置进程守护?

发布人:A5数据发布时间:2026-10-12 10:46阅读量:320

上线后的目标状态是:域名通过 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:

使用systemd守护Gunicorn进程配图

[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 worker2 个CPU并发、内存占用ps、请求延迟、CPU使用率
每个 worker 的线程2 个I/O等待时的并发能力应用响应时间、数据库连接数
请求超时60 秒防止请求无限占用 workerGunicorn 日志、接口耗时
单请求上传限制20 MBNginx和应用内存压力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 版本:

配置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

相关推荐