把 Django 项目部署到阿里云 ECS,代码上传只是其中一步。上线前还要确认 Python 环境、数据库连接、应用进程、Nginx 转发和安全组规则都能配合工作。下面以 Ubuntu 22.04、Python 3、Gunicorn 和 Nginx 为例,整理一套适用于小型网站和内部系统的部署流程。命令里的用户名、域名和目录路径请按实际项目替换。
一、准备 ECS、域名和网络规则
准备一台阿里云 ECS,并在域名服务商处完成解析。生产环境通常使用固定公网 IP,避免实例更换后域名解析指向旧地址。到阿里云控制台检查安全组:一般只需开放 SSH 的 22 端口、HTTP 的 80 端口和 HTTPS 的 443 端口。数据库端口不要直接开放给公网。
下文假设项目目录为 /srv/myapp,Django 配置包名为 config,域名为 example.com。部署前确认项目有 requirements.txt 等依赖清单,并已在本地运行通过。若项目还依赖系统级组件,也要提前确认服务器需要安装哪些软件包。
二、更新系统并安装基础组件
通过 SSH 登录 ECS 后,更新软件包并安装 Python 虚拟环境工具、Git 和 Nginx:
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3-venv python3-pip git nginx
应用不宜长期使用 root 账户运行。可以创建专用系统用户,减少服务出现问题时对其他文件和进程的影响:
sudo adduser --system --group --home /srv/myapp appuser
三、部署代码并安装依赖
代码可以通过 Git 克隆,也可以使用安全的文件传输方式上传。以下用 Git 举例:
sudo git clone https://你的代码仓库地址 /srv/myapp
进入项目目录后创建虚拟环境,并在其中安装依赖:
cd /srv/myapp
sudo python3 -m venv venv
sudo ./venv/bin/pip install --upgrade pip
sudo ./venv/bin/pip install -r requirements.txt
安装完成后,将项目目录交给应用用户管理:
sudo chown -R appuser:appuser /srv/myapp
如果依赖中有 Pillow 或数据库驱动等需要系统库的包,先查明对应的编译库或开发包,再按需安装。遇到安装报错时,先看具体缺少什么,不要急着删除虚拟环境、反复重装 Python。
四、检查生产环境配置
生产环境要关闭调试模式,并将实际使用的域名加入 ALLOWED_HOSTS。密钥、数据库密码等敏感信息应通过环境变量或单独的配置文件提供,不要把真实密钥提交到公开代码仓库。
配置中至少要确认以下项目:
DEBUG = False
ALLOWED_HOSTS = ["example.com", "www.example.com"]
若 SECRET_KEY 等配置从环境变量读取,Gunicorn 对应的 systemd 服务也必须能读取这些变量,否则本地测试正常,服务启动时仍可能报错。数据库连接、时区和静态文件目录也要一并检查。使用阿里云 RDS 时,应限制数据库只接受可信内网地址的连接。
五、迁移数据库并收集静态文件
确认数据库配置可用后,以应用用户执行迁移和静态文件收集:
sudo -u appuser /srv/myapp/venv/bin/python /srv/myapp/manage.py migrate
sudo -u appuser /srv/myapp/venv/bin/python /srv/myapp/manage.py collectstatic --noinput
Django 配置中的 STATIC_ROOT 应指向收集目录,例如 /srv/myapp/staticfiles。用户上传内容则放在单独规划的 MEDIA_ROOT 下,并确认应用用户有写入权限。静态文件和上传文件用途不同,分开管理更容易排查问题;需要保留的上传数据也应纳入备份。
六、用 Gunicorn 和 systemd 管理应用
runserver 适合本地调试,不应直接承担生产流量。先在命令行启动 Gunicorn,确认项目能正常加载:
sudo -u appuser /srv/myapp/venv/bin/gunicorn --bind 127.0.0.1:8000 config.wsgi:application
能正常启动后按 Ctrl+C 停止,再用 systemd 管理进程。新建 /etc/systemd/system/myapp.service,内容可按项目调整:
[Unit]
After=network.target
[Service]
User=appuser
Group=www-data
WorkingDirectory=/srv/myapp
ExecStart=/srv/myapp/venv/bin/gunicorn --workers 3 --bind 127.0.0.1:8000 config.wsgi:application
Restart=always
[Install]
WantedBy=multi-user.target
如果项目依赖环境变量,可在服务文件中添加 EnvironmentFile,同时限制该文件的读取权限。保存服务文件后执行:
sudo systemctl daemon-reload
sudo systemctl enable --now myapp
sudo systemctl status myapp
查看实时日志可运行 sudo journalctl -u myapp -f。示例中的 3 个 worker 不一定适合所有 ECS;工作进程数量要结合 CPU、内存和实际请求量调整,设置过多可能挤占内存。
七、配置 Nginx 和 HTTPS
Nginx 接收公网请求,再把动态请求转发到只监听本机地址的 Gunicorn。站点配置需要包含域名、静态文件路径和代理规则,例如:
server {
listen 80;
server_name example.com www.example.com;
location /static/ { alias /srv/myapp/staticfiles/; }
location / {
proxy_pass http://127.0.0.1:8000;
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;
}
}
启用站点后先检查 Nginx 配置,再重新加载服务:
sudo nginx -t && sudo systemctl reload nginx
确认域名解析正确、80 端口能够访问后,再为域名配置 HTTPS 证书。证书可以使用云服务提供的证书,也可以用自动续期工具申请。HTTPS 配好后,还要测试 HTTP 是否跳转到 HTTPS,并确认续期流程可以正常工作。
八、上线案例:先查配置衔接,再反复重启
某团队要上线一个 Django 活动报名系统,使用一台 2 核 4GB 的 ECS、托管数据库和自有域名。团队通过环境变量保存数据库凭据,用 Gunicorn 运行应用,再由 Nginx 提供静态文件服务。联调时网站返回 502,检查后发现 systemd 服务里的项目路径写错;修正 WorkingDirectory 后,服务恢复正常。
随后页面上的静态文件返回 404。排查发现,Django 的 STATIC_ROOT 与 Nginx 的 alias 指向了不同目录。统一路径并重新执行 collectstatic 后,页面显示正常。遇到类似问题,可以先查 systemd 状态和应用日志,再看 Nginx 错误日志、端口监听、目录权限及静态文件路径。比起连续重启服务,按请求链路逐项核对更容易定位原因。
上线前检查清单
- 确认 DEBUG 已关闭,ALLOWED_HOSTS 包含实际使用的域名。
- 确认数据库、密钥和上传文件有可执行的备份安排,并检查备份是否能恢复。
- 检查安全组,只保留必要端口;SSH 使用强认证,并按需要限制访问来源。
- 确认 systemd 服务能随系统启动,日志设置了轮转,并有人留意磁盘空间和内存。
- 更新代码后按顺序安装依赖、执行数据库迁移、收集静态文件,再重启应用服务。
阿里云部署 Django 项目时,应用进程、Nginx、数据库和安全组各自负责不同环节。先用最小可用配置跑通,再根据访问量考虑缓存、负载均衡或多台应用服务器,通常更便于维护。