Django 项目部署实战：从代码到线上可访问-linux运维-PHP中文网

Django 项目部署实战：从代码到线上可访问

心靈之曲

发布： 2025-08-06 17:30:02

原创

313人浏览过

部署 django 项目需先选择 linux 服务器并安装 python 和 django，使用 venv 隔离依赖；2. 安装 nginx 作为 web 服务器，配置反向代理将请求转发至 gunicorn；3. 安装 gunicorn 并通过 systemd 或 supervisor 管理进程，确保稳定运行；4. 配置数据库并修改 settings.py 中的数据库连接信息；5. 执行 collectstatic 收集静态文件至指定目录；6. 配置防火墙允许 80 和 443 端口；7. 遇 502 错误时检查 gunicorn 运行状态、nginx 配置路径、socket 文件权限及防火墙设置；8. 性能优化包括使用缓存、数据库索引、cdn、代码优化、celery 异步任务及监控日志；9. 自动化部署可采用 fabric、ansible、docker 或 jenkins，推荐 docker 配合 jenkins 实现高效可重复部署。

Django 项目部署实战：从代码到线上可访问

Django 项目部署，简单来说，就是把你的 Django 代码从本地搬到服务器上，让大家都能通过网络访问。这听起来简单，但实际上涉及很多环节，稍有不慎就会踩坑。

解决方案

部署 Django 项目并非一蹴而就，需要细致的规划和执行。以下是一个相对通用的流程，你可以根据自己的实际情况进行调整：

选择服务器和操作系统：
可以选择云服务器（如 AWS EC2、阿里云 ECS、腾讯云 CVM）或物理服务器。操作系统推荐使用 Linux，如 Ubuntu 或 CentOS，因为它们对 Python 和 Django 的支持更好。
安装 Python 和 Django：
在服务器上安装 Python 3.x。推荐使用
```
venv
```
登录后复制
创建一个虚拟环境，将项目所需的依赖包隔离起来，避免版本冲突。激活虚拟环境后，使用
```
pip install django
```
登录后复制
安装 Django。
安装 Web 服务器：
常用的 Web 服务器有 Nginx 和 Apache。Nginx 以其高性能和低资源占用而著称，更适合处理静态资源。Apache 则配置相对简单，适合小型项目。这里以 Nginx 为例，介绍配置方法。
安装 WSGI 服务器：
WSGI（Web Server Gateway Interface）是 Python Web 应用与 Web 服务器之间的接口。常用的 WSGI 服务器有 Gunicorn 和 uWSGI。Gunicorn 简单易用，适合大多数 Django 项目。安装 Gunicorn：
```
pip install gunicorn
```
登录后复制
。

配置 Nginx：
Nginx 需要配置反向代理，将请求转发给 Gunicorn。创建一个 Nginx 配置文件（例如

/etc/nginx/sites-available/myproject

登录后复制

），内容如下：

server {
    listen 80;
    server_name your_domain.com; # 修改为你的域名或 IP 地址

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        root /path/to/your/project; # 修改为你的项目静态文件目录
    }

    location / {
        include proxy_params;
        proxy_pass http://unix:/path/to/your/project/myproject.sock; # 修改为你的项目 socket 文件路径
    }
}

登录后复制

然后，创建符号链接到

/etc/nginx/sites-enabled/

登录后复制

目录，并重启 Nginx 服务：

sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled/
sudo systemctl restart nginx

登录后复制

配置 Gunicorn：
在项目目录下创建一个

myproject.sock

登录后复制

文件，Gunicorn 将监听该文件。使用以下命令启动 Gunicorn：

gunicorn --bind unix:/path/to/your/project/myproject.sock myproject.wsgi:application

登录后复制

为了方便管理，可以使用 Systemd 将 Gunicorn 配置为系统服务。创建一个 Systemd 配置文件（例如

/etc/systemd/system/myproject.service

登录后复制

），内容如下：

[Unit]
Description=Gunicorn instance to serve myproject
After=network.target

[Service]
User=your_user # 修改为你的用户名
Group=www-data
WorkingDirectory=/path/to/your/project # 修改为你的项目目录
ExecStart=/path/to/your/project/venv/bin/gunicorn --workers 3 --bind unix:/path/to/your/project/myproject.sock myproject.wsgi:application

[Install]
WantedBy=multi-user.target

登录后复制

然后，启动 Gunicorn 服务：

sudo systemctl start myproject
sudo systemctl enable myproject

登录后复制

配置数据库：
根据你的数据库类型（如 PostgreSQL、MySQL），在服务器上安装相应的数据库服务，并创建数据库和用户。修改 Django 项目的
```
settings.py
```
登录后复制
文件，配置数据库连接信息。
收集静态文件：
在 Django 项目中，静态文件（如 CSS、JavaScript、图片）需要收集到指定的目录。在
```
settings.py
```
登录后复制
文件中配置
```
STATIC_ROOT
```
登录后复制
，然后运行
```
python manage.py collectstatic
```
登录后复制
命令。
配置 Supervisor (可选): Supervisor 是一个进程管理工具，可以监控和自动重启 Gunicorn 等进程，确保服务的稳定性。安装 Supervisor：
```
pip install supervisor
```
登录后复制
。创建 Supervisor 配置文件（例如
```
/etc/supervisor/conf.d/myproject.conf
```
登录后复制
），内容如下：
```
[program:myproject]
command=/path/to/your/project/venv/bin/gunicorn --workers 3 --bind unix:/path/to/your/project/myproject.sock myproject.wsgi:application
directory=/path/to/your/project
user=your_user
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/path/to/your/project/logs/gunicorn.log
```
登录后复制
更新 Supervisor 配置并启动服务：

码上飞
码上飞（CodeFlying）是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

138

查看详情
```
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start myproject
```
登录后复制
配置防火墙：
配置服务器的防火墙（如 UFW），允许 HTTP (80) 和 HTTPS (443) 流量通过。

Django 部署后如何进行性能优化？

Django 项目上线后，性能优化是一个持续的过程。以下是一些常见的优化手段：

缓存： 使用 Django 的缓存框架，缓存常用的数据和页面，减少数据库查询次数。可以使用 Memcached 或 Redis 作为缓存后端。
数据库优化： 对数据库进行索引优化、查询优化、连接池配置等，提高数据库的查询效率。
使用 CDN： 将静态资源（如 CSS、JavaScript、图片）放在 CDN 上，减轻服务器的压力，并提高用户访问速度。
代码优化： 检查代码中是否存在性能瓶颈，如循环嵌套、重复计算等，进行优化。
使用 Celery： 将耗时的任务（如发送邮件、处理大数据）放入 Celery 异步队列中执行，避免阻塞主线程。
监控和日志： 使用监控工具（如 Prometheus、Grafana）监控服务器和应用的性能指标，并记录详细的日志，方便排查问题。

Django 项目部署遇到 502 Bad Gateway 错误怎么办？

502 Bad Gateway 错误通常表示 Nginx 无法连接到后端的 Gunicorn 服务。排查思路如下：

检查 Gunicorn 是否运行： 使用
```
systemctl status myproject
```
登录后复制
命令检查 Gunicorn 服务是否正常运行。如果 Gunicorn 崩溃，查看日志文件（
```
/path/to/your/project/logs/gunicorn.log
```
登录后复制
）查找错误原因。
检查 Nginx 配置： 检查 Nginx 配置文件（
```
/etc/nginx/sites-available/myproject
```
登录后复制
）中
```
proxy_pass
```
登录后复制
指向的 Gunicorn socket 文件路径是否正确。
检查 Gunicorn 绑定： 检查 Gunicorn 启动命令中
```
--bind
```
登录后复制
参数指定的地址是否与 Nginx 配置文件中的
```
proxy_pass
```
登录后复制
地址一致。
检查权限： 确保 Nginx 运行的用户（通常是
```
www-data
```
登录后复制
）对 Gunicorn socket 文件有读写权限。
检查防火墙： 检查防火墙是否阻止了 Nginx 与 Gunicorn 之间的通信。