使用VPS服务器部署Python Django项目持续交付案例

在数字化加速的今天，Python Django项目的快速迭代离不开高效的部署与持续交付体系。借助VPS服务器的灵活资源调配能力，开发者能以更低成本实现自动化部署，本文通过真实电商项目案例拆解这一全流程。

项目背景与基础准备

案例主角是一个小型电商Django项目，核心功能包括商品展示、购物车管理及订单系统，日均活跃用户约5000。部署目标是将其迁移至VPS服务器，并实现代码推送后自动完成测试、部署与上线，缩短迭代周期。

部署前需准备：一台配置2核4G、50G SSD的VPS服务器（推荐Ubuntu 20.04 LTS系统），已安装Python 3.8+、pip、Git、Nginx及Gunicorn（Python WSGI HTTP服务器，用于运行Django应用）。特别注意，VPS需开放80（HTTP）、443（HTTPS）及22（SSH）端口，确保外部访问与远程管理。

四步完成项目部署

第一步，代码拉取与环境隔离。通过Git命令将代码从仓库克隆至服务器/var/www/django_project目录：

git clone https://your-repo-url.com/django-project.git /var/www/django_project

随后创建Python虚拟环境（避免系统级依赖冲突）：

python3 -m venv /var/www/django_project/venv
source /var/www/django_project/venv/bin/activate
pip install -r requirements.txt

第二步，数据库配置。项目使用PostgreSQL存储商品及订单数据，需在VPS上安装并初始化数据库：

sudo apt install postgresql
sudo -u postgres psql -c "CREATE DATABASE django_db;"
sudo -u postgres psql -c "CREATE USER django_user WITH PASSWORD 'your_password';"
sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE django_db TO django_user;"

修改项目settings.py，通过环境变量替换数据库密码（避免硬编码）：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'django_db',
        'USER': 'django_user',
        'PASSWORD': os.environ.get('DB_PASSWORD'),
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

第三步，配置Gunicorn。创建gunicorn.service文件（/etc/systemd/system/gunicorn.service），指定WSGI应用路径与监听端口：

[Unit]
Description=Gunicorn daemon for Django project

[Service]
User=ubuntu
Group=ubuntu
WorkingDirectory=/var/www/django_project
ExecStart=/var/www/django_project/venv/bin/gunicorn \
          --workers 3 \
          --bind unix:/var/www/django_project/django.sock \
          myproject.wsgi:application

[Install]
WantedBy=multi-user.target

启动并设置开机自启：

sudo systemctl start gunicorn
sudo systemctl enable gunicorn

第四步，Nginx反向代理。在/etc/nginx/sites-available目录创建项目配置文件，定义静态文件路径与请求转发规则：

server {
    listen 80;
    server_name your-domain.com;

    location /static/ {
        root /var/www/django_project;
    }

    location / {
        include proxy_params;
        proxy_pass http://unix:/var/www/django_project/django.sock;
    }
}

验证配置并重启Nginx：

sudo nginx -t
sudo systemctl restart nginx

持续交付：从手动到自动化

为实现代码推送后自动部署，采用GitLab CI/CD工具。在项目根目录创建.gitlab-ci.yml，定义三阶段流水线：

• 测试阶段：运行pytest检查代码质量，失败则终止流程；


• 预发布阶段：将代码部署至测试环境VPS，验证功能完整性；


• 生产部署：通过SSH连接生产VPS，执行代码拉取、依赖更新及服务重启。

关键配置示例：

stages:
  - test
  - pre_deploy
  - prod_deploy

test:
  stage: test
  image: python:3.8
  script:
    - pip install -r requirements.txt
    - pytest

pre_deploy:
  stage: pre_deploy
  image: alpine:latest
  script:
    - apk add openssh-client
    - scp -r ./* test_user@test_vps_ip:/var/www/pre_django_project
    - ssh test_user@test_vps_ip "cd /var/www/pre_django_project && ./deploy.sh"

prod_deploy:
  stage: prod_deploy
  only:
    - main
  image: alpine:latest
  script:
    - apk add openssh-client
    - scp -r ./* prod_user@prod_vps_ip:/var/www/django_project
    - ssh prod_user@prod_vps_ip "cd /var/www/django_project && git pull && ./venv/bin/pip install -r requirements.txt && sudo systemctl restart gunicorn nginx"

监控与长期维护

部署完成后，需通过Prometheus+Grafana监控服务器状态。重点关注：
- CPU使用率（建议阈值：持续5分钟＞70%触发预警）；
- 内存占用（连续3次＞85%需检查是否存在内存泄漏）；
- 数据库QPS（查询量突增可能提示活动促销或攻击）；
- Nginx请求延迟（超过500ms需优化Django视图或数据库查询）。

同时，每日凌晨执行数据库备份（pg_dump命令），每周全量备份项目代码至对象存储，确保数据可快速恢复。

通过VPS服务器实现Django项目的持续交付，不仅将单次部署时间从2小时缩短至15分钟，更减少了人工操作失误。这种模式尤其适合中小型团队，既能满足快速迭代需求，又能通过VPS的弹性扩展应对流量波动，为项目长期稳定运行提供坚实支撑。