在马来西亚服务器上部署Django 5.2 LTS应用,如何配置进程守护?

发布人:A5数据发布时间:2026-11-16 11:05阅读量:16

马来西亚服务器上的 Django 5.2 LTS 应用,可以由 systemd 守护 Gunicorn 进程、Nginx 接收 HTTP 请求并转发到 Gunicorn Unix Socket。这样应用异常退出时可由 systemd 按策略重启,进程输出也能集中查看;Django 不直接暴露公网端口。

部署方式概述配图

以下示例以 Ubuntu 22.04/24.04、systemd、Nginx 和已有 Django 项目为基础。路径、域名、项目模块名及数据库连接须替换成实际值。服务器所在地区不会改变进程守护方式;可按业务需要配置马来西亚时区,或让应用和数据库以 UTC 保存时间并在展示时转换。

A5idc数据在马来西亚吉隆坡提供多种配置的物理服务器,涵盖不同CPU、存储及优化/国际线路方案,可为Django应用、数据库和静态资源部署提供相应的计算、存储与网络资源基础。结合systemd进程守护和Nginx请求转发,网站与业务后台可部署在马来西亚节点,满足面向当地及跨境访问的服务器资源需求。

准备条件

开始前确认:

  • 系统提供 Python 3.10 或更高版本,且项目依赖与所选 Python 版本兼容。
  • 项目已有生产用 requirements.txt,其中包含 Gunicorn;Django 的 WSGI 模块可以导入。
  • 数据库已创建,应用的生产数据库配置可从环境变量或其他受控配置中读取。
  • 已有指向服务器的域名。正式对公网提供服务前,还应配置 HTTPS 证书;本文先以 HTTP 验证 Nginx 到应用的链路。
  • 已确认防火墙和云端安全组允许所需的公网端口。采用 Unix Socket 时,不需要为 Gunicorn 单独开放公网端口。

示例约定项目 WSGI 模块为 myproject.wsgi:application,项目目录采用版本发布目录,配置与静态文件放在独立的共享目录:

/srv/myapp/
├── current -> /srv/myapp/releases/2025-06-01
├── releases/
├── shared/
│   └── static/
└── venv/

部署前准备好项目源码,并确认其目录中有 manage.py 和 requirements.txt。示例中的版本目录名仅用于说明,不代表实际发布记录。

逐步部署与验证

1. 安装系统组件并创建运行账号

在 Ubuntu 上安装 Python 虚拟环境工具和 Nginx:

sudo apt update
sudo apt install -y python3 python3-venv nginx

创建不允许交互登录的专用账号,并准备应用目录。静态文件目录由应用账号写入、Nginx 读取:

sudo useradd --system --create-home \
  --home-dir /srv/myapp \
  --shell /usr/sbin/nologin django

sudo chown root:django /srv/myapp
sudo chmod 0750 /srv/myapp
sudo install -d -o root -g django -m 0750 /srv/myapp/releases
sudo install -d -o django -g www-data -m 2775 /srv/myapp/shared/static
sudo install -d -o django -g www-data -m 2775 /srv/myapp/shared/media
sudo python3 -m venv /srv/myapp/venv
sudo chown -R django:django /srv/myapp/venv

media 目录仅在应用需要保存用户上传文件时使用,不要在 Nginx 中直接开放不应公开的上传内容。

验证:

python3 --version
sudo -u django /srv/myapp/venv/bin/python --version
nginx -v

应能看到系统 Python、虚拟环境 Python 和 Nginx 的版本信息。若系统没有 python3-venv 包或创建虚拟环境失败,先确认发行版版本及软件源状态,不要改用系统 Python 全局安装项目依赖。

2. 放置代码、安装依赖并创建环境配置

为本次发布创建独立目录,将项目文件放入其中。以下命令中的目录名需要替换;发布目录及其文件应由 root 管理,并保证 django 账号可读取:

RELEASE=/srv/myapp/releases/2025-06-01
sudo install -d -o root -g django -m 0750 "$RELEASE"

将项目源码上传或解压到 $RELEASE 后,以应用账号安装依赖。不要把 Gunicorn 仅装在系统 Python 环境中:

sudo -u django /srv/myapp/venv/bin/pip install --no-cache-dir \
  -r "$RELEASE/requirements.txt"

创建供 systemd 读取的环境文件。下面的值是格式示例,密钥应使用随机值,数据库配置应替换为项目实际采用的连接参数:

sudo install -d -o root -g root -m 0750 /etc/myapp
sudo install -o root -g django -m 0640 /dev/null /etc/myapp/myapp.env

在 /etc/myapp/myapp.env 中填写:

DJANGO_SETTINGS_MODULE=myproject.settings
DJANGO_SECRET_KEY=替换为随机生成的密钥
DJANGO_DEBUG=False
DJANGO_ALLOWED_HOSTS=app.example.com,www.example.com
DJANGO_CSRF_TRUSTED_ORIGINS=https://app.example.com,https://www.example.com
STATIC_ROOT=/srv/myapp/shared/static

Django 不会因为环境文件存在就自动读取这些变量。项目设置中需显式读取。例如:

import os

SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]
DEBUG = os.environ.get("DJANGO_DEBUG", "false").lower() in {
    "1", "true", "yes",
}
ALLOWED_HOSTS = [
    host.strip()
    for host in os.environ.get("DJANGO_ALLOWED_HOSTS", "").split(",")
    if host.strip()
]
CSRF_TRUSTED_ORIGINS = [
    origin.strip()
    for origin in os.environ.get("DJANGO_CSRF_TRUSTED_ORIGINS", "").split(",")
    if origin.strip()
]
STATIC_ROOT = os.environ.get(
    "STATIC_ROOT", "/srv/myapp/shared/static"
)

数据库配置也应通过项目设置读取受控环境变量。不要把真实数据库密码、密钥或其他凭据提交到代码仓库。生成 Django 密钥时,可使用虚拟环境中的 Django 工具:

sudo -u django /srv/myapp/venv/bin/python -c \
  'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())'

将输出值写入环境文件后,确认权限仍为 root:django、0640。运行账号通过 django 组读取,其他普通账号无权读取。

3. 建立首次发布入口并执行 Django 检查

先把 current 指向本次发布目录。该命令适用于首次部署、当前链接尚不存在的情况:

sudo ln -s "$RELEASE" /srv/myapp/current

使用 systemd 临时任务运行管理命令,使检查和迁移使用与正式服务相同的账号、工作目录和环境文件:

sudo systemd-run --wait --pipe --collect \
  -p User=django \
  -p Group=www-data \
  -p SupplementaryGroups=django \
  -p WorkingDirectory=/srv/myapp/current \
  -p EnvironmentFile=/etc/myapp/myapp.env \
  /srv/myapp/venv/bin/python manage.py check

若项目数据库已就绪,再执行迁移:

sudo systemd-run --wait --pipe --collect \
  -p User=django \
  -p Group=www-data \
  -p SupplementaryGroups=django \
  -p WorkingDirectory=/srv/myapp/current \
  -p EnvironmentFile=/etc/myapp/myapp.env \
  /srv/myapp/venv/bin/python manage.py migrate

然后收集静态文件:

sudo systemd-run --wait --pipe --collect \
  -p User=django \
  -p Group=www-data \
  -p SupplementaryGroups=django \
  -p WorkingDirectory=/srv/myapp/current \
  -p EnvironmentFile=/etc/myapp/myapp.env \
  /srv/myapp/venv/bin/python manage.py collectstatic --noinput

验证:

  • check 返回成功且没有未处理的配置错误。
  • migrate 成功结束;若数据库不可达或权限不足,应先修正数据库连接或账号权限。
  • collectstatic 能写入 /srv/myapp/shared/static。若提示权限错误,核对共享目录所有者、组及权限,不要对整台服务器递归放开写权限。

4. 创建 systemd 服务单元

创建 /etc/systemd/system/myapp.service:

[Unit]
Description=Django application served by Gunicorn
After=network.target
StartLimitIntervalSec=60
StartLimitBurst=5

[Service]
Type=simple
User=django
Group=www-data
SupplementaryGroups=django
WorkingDirectory=/srv/myapp/current
EnvironmentFile=/etc/myapp/myapp.env
RuntimeDirectory=myapp
RuntimeDirectoryMode=0750
UMask=0007
ExecStart=/srv/myapp/venv/bin/gunicorn \
    --workers 3 \
    --bind unix:/run/myapp/gunicorn.sock \
    --access-logfile - \
    --error-logfile - \
    --capture-output \
    myproject.wsgi:application
Restart=on-failure
RestartSec=5
TimeoutStopSec=30

[Install]
WantedBy=multi-user.target

此配置让 systemd 在服务启动时创建 /run/myapp,Gunicorn 把日志输出到标准输出和标准错误,日志可通过 journald 查看。--workers 3 是示例值,不是适用于所有实例的固定配置;应结合可用内存、CPU 和请求负载调整。若项目需要 ASGI 或 WebSocket,应按项目的 ASGI 部署方式配置服务器,不能直接把 WSGI 模块当作 ASGI 应用使用。

加载配置并启动服务:

sudo systemctl daemon-reload
sudo systemctl enable --now myapp

验证:

sudo systemctl status myapp --no-pager
sudo ls -l /run/myapp/gunicorn.sock
sudo journalctl -u myapp -n 50 --no-pager

服务状态应为 active (running),Unix Socket 应存在。若服务退出或反复重启,以 journalctl 中最早出现的 Python 异常为线索,而不是先调整重启频率掩盖错误。

5. 配置 Nginx 并验证请求转发

创建 /etc/nginx/sites-available/myapp,将域名和路径替换成实际值:

server {
    listen 80;
    server_name app.example.com www.example.com;

    location /static/ {
        alias /srv/myapp/shared/static/;
    }

    location / {
        proxy_pass http://unix:/run/myapp/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-Proto $scheme;
    }
}

启用站点并检查配置:

sudo ln -s /etc/nginx/sites-available/myapp \
  /etc/nginx/sites-enabled/myapp
sudo nginx -t

只有 nginx -t 显示配置测试成功,才重载 Nginx:

sudo systemctl reload nginx

先在服务器本机测试 Nginx。将路径换成项目中实际存在的页面;若配置了 /health/ 健康检查路由,可用该路由测试:

curl -i -H 'Host: app.example.com' http://127.0.0.1/health/

也可绕过 Nginx,直接验证 Gunicorn Socket:

curl --unix-socket /run/myapp/gunicorn.sock \
  -i -H 'Host: app.example.com' \
  http://localhost/health/

根据应用设计,正常结果可能是 200,也可能是预期的重定向或授权响应。重点是返回符合该路由的结果,且 Nginx 没有 502 Bad Gateway。公网正式运行前,还需完成 HTTPS 配置;若由 Nginx 终止 TLS,Django 的安全代理设置只能在确认请求确实来自受信任的代理、且 Nginx 会覆盖转发头后启用。

常见异常处理

先区分问题出在 Nginx、Socket、Gunicorn、Django 还是数据库,避免一开始就重启或改权限:

现象优先检查常见原因
Nginx 返回 502systemctl status myapp、Socket 是否存在、Nginx 错误日志Gunicorn 未启动、Socket 路径写错、Nginx 无权访问 Socket
服务启动后立即退出journalctl -u myapp -n 100WSGI 模块名错误、依赖缺失、环境变量缺失、配置导入异常
页面返回 500Gunicorn 日志及 Django 应用日志数据库连接失败、迁移未执行、请求处理异常
静态文件 404STATIC_ROOT、collectstatic 结果、Nginx 的 alias收集目录和别名不一致、文件未收集或目录不可读
反复重启并触发启动限制日志中的首个异常、systemctl status myapp应用持续退出;修正原因后再重置失败状态

查看 Nginx 日志:

sudo tail -n 100 /var/log/nginx/error.log
sudo tail -n 100 /var/log/nginx/access.log

应用修正后,重新加载服务配置或重启应用:

sudo systemctl restart myapp

如果 systemd 已因频繁失败而停止再次尝试,先修正导致退出的问题,再执行:

sudo systemctl reset-failed myapp
sudo systemctl start myapp

不要用 chmod -R 777 处理 Socket 或目录问题。应针对实际访问路径核对运行账号、所属组、目录权限和 systemd 的 Group、SupplementaryGroups 设置。

结果检查与回滚

验收时至少确认以下项目:

  • myapp 服务已启用,服务器重启后会由 systemd 拉起。
  • systemctl status myapp 显示运行中,日志中没有持续发生的启动失败或未处理异常。
  • Gunicorn Socket 存在,Nginx 能通过该 Socket 请求到 Django 页面。
  • 域名解析、服务器防火墙及云端安全组符合实际访问路径;公网业务已完成 HTTPS 配置。
  • 静态资源可读取;上传目录(如有)只授予应用所需写权限。
  • 配置已关闭 DEBUG,生产密钥和数据库凭据没有进入代码仓库或公开日志。

部署新版本前,保留当前 current 指向的发布目录、对应配置和可恢复的数据库备份。升级数据库结构时,先评估新旧代码是否兼容;代码回滚并不能自动撤销数据库迁移,生产数据库不应未经验证就执行反向迁移或恢复操作。

若新版本启动异常,可将 current 切回上一个已知可用版本,再重启服务。将 PREVIOUS 替换为实际旧版本目录:

结果检查与回滚配图

sudo ln -sfnT /srv/myapp/releases/PREVIOUS /srv/myapp/current
sudo systemctl restart myapp
sudo systemctl status myapp --no-pager

随后再次通过 Nginx 检查健康路由,并查看服务日志。回滚检查项包括:旧代码目录仍存在、环境配置与该版本兼容、静态资源未被新版本的收集结果破坏、数据库结构仍支持旧代码。只有这些条件满足时,切换代码链接才构成完整回滚。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9743.html

相关推荐