Django基础教程（147）Django部署上线之配置Nginx：Django上线大冒险：别让你的项目在本地“躺平”，Nginx保姆级攻略来也！

Django部署Nginx保姆级教程

最新推荐文章于 2025-11-25 14:10:45 发布

原创最新推荐文章于 2025-11-25 14:10:45 发布 · 351 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#django #nginx #数据库

Django基础教程专栏收录该内容

170 篇文章

订阅专栏

嘿，各位Django侠客们！是不是感觉经过九九八十一难，你的Django项目终于在本地runserver命令下跑得风生水起了？界面炫酷，功能完美，数据库操作666。

但是，兄弟，醒醒！那只是新手村的幻象。

python manage.py runserver 这个Django自带的开发服务器，就像一个穿着睡衣在家里晃悠的你——舒服、随意，但绝对见不得客人。它性能孱弱、不安全，随便来个线上流量就能把它冲垮，Django官方都明说了：别在生产环境用这货！

所以，是时候给你的项目穿上正装，推到公网的聚光灯下了！今天，咱们就来一场轰轰烈烈的“Django上线大冒险”，而这场冒险的男主角，就是大名鼎鼎的 Nginx。

第一幕：为啥不能是“Runserver”独闯天涯？

我们先来搞明白，一个合格的生产环境需要什么：

并发处理能力：runserver是单线程的，一次只能接待一个用户。想象一下你的网站门口排起了长龙，而门卫一次只放一个人进去，其他人只能干等着，这体验得多差？
静态文件服务：CSS、JS、图片这些，runserver能处理，但效率极低。这好比让米其林大厨去端盘子，大材小用且不专业。
安全性：runserver会暴露许多调试信息，在线上环境这就是开着门让黑客进来参观，太危险了。
稳定性和可靠性：它太脆弱了，进程说挂就挂，需要有个“守护神”在它挂了之后能立刻把它拉起来。

所以，我们需要一个“黄金搭档”阵容。

第二幕：梦之队登场——WSGI Server + Nginx

这个梦幻组合的分工非常明确：

Gunicorn（我们的WSGI Server）：专门负责“搞业务”。它是一个用Python写的高性能WSGI服务器，能启动多个“工人进程”来处理Django的核心Python逻辑。当用户请求一个动态页面（比如查看个人主页）时，Gunicorn的工人就会去调用你的Django代码，生成HTML。

- 简单理解：Gunicorn是后厨，专门负责炒菜（处理Django逻辑）。

Nginx：负责“接客”和“打杂”。它是个高性能的HTTP和反向代理服务器。

1. 反向代理：它站在Gunicorn前面，对外接收所有用户请求。如果是动态请求，它就转发给后厨Gunicorn；如果是静态文件请求，它就直接自己处理了，又快又省力。
2. 处理静态文件：这是Nginx的强项，速度飞快。
3. 负载均衡：如果后厨一个Gunicorn忙不过来，它可以分发给多个Gunicorn实例。
4. SSL终端：HTTPS加密那些事儿，也交给它。

- 简单理解：Nginx是餐厅前台和传菜员，接待客人、端茶倒水（处理静态文件），然后把点菜单（动态请求）递给后厨。

这个架构，专业！

第三幕：实战开始！手把手配置你的服务器

假设你已经有一台Ubuntu服务器（可以是云服务器，也可以是你的虚拟机），并且已经在上面部署好了Python环境和你的Django项目代码。

步骤一：请出我们的“后厨总管”——Gunicorn

首先，得把Gunicorn安装到你的项目环境里。

pip install gunicorn

然后，我们简单测试一下，在没有Nginx的情况下，Gunicorn能不能独自撑起Django。在你的项目根目录（manage.py所在目录）下运行：

gunicorn --bind 0.0.0.0:8000 你的项目名称.wsgi:application

--bind 0.0.0.0:8000：告诉Gunicorn监听所有网络接口的8000端口。
你的项目名称.wsgi:application：这是指向你Django项目WSGI应用的路径。

现在，用浏览器访问 http://你的服务器IP:8000，如果能看到你的网站（但可能没有样式，因为静态文件还没处理），恭喜你，Gunicorn配置初步成功！

但这只是临时测试，我们需要一个更持久的方式。创建一个Gunicorn配置文件gunicorn_config.py：

# gunicorn_config.py
bind = "127.0.0.1:8000"  # 这次只绑定到本地，因为Nginx会来连接
workers = 3  # 工人进程数，通常为 (CPU核心数 * 2) + 1
max_requests = 1000  # 每个工人处理1000个请求后重启，防止内存泄漏
max_requests_jitter = 100  # 增加一个随机抖动，避免所有工人同时重启
accesslog = "/path/to/your/log/gunicorn_access.log"  # 访问日志
errorlog = "/path/to/your/log/gunicorn_error.log"  # 错误日志

以后就可以用 gunicorn -c gunicorn_config.py 你的项目名称.wsgi:application 来启动了。

步骤二：恭迎“前台大神”——Nginx

在Ubuntu上安装Nginx非常简单：

sudo apt update
sudo apt install nginx

安装完成后，它默认已经启动。你可以访问 http://你的服务器IP，应该能看到Nginx的欢迎页面。

现在，最关键的一步来了：为我们的Django项目创建一个Nginx站点配置文件。

别急着动默认的default文件，我们为自己项目专门创建一个：

sudo nano /etc/nginx/sites-available/my_django_project

然后把下面的配置一字不差地（当然，路径要改成你自己的）贴进去：

server {
    listen 80;
    server_name _;  # 这里先使用通配符，或者换成你的域名，如 www.example.com

    # 处理静态文件！这是提升性能的关键！
    location /static/ {
        alias /path/to/your/django/project/staticfiles/;  # 指向你收集静态文件的目录
        # 例如 alias /home/ubuntu/myproject/staticfiles/;
        expires 30d;  # 告诉浏览器缓存30天，减少请求
        add_header Cache-Control "public, immutable";
    }

    # 处理媒体文件（用户上传的）
    location /media/ {
        alias /path/to/your/django/project/media/;
        expires 30d;
    }

    # 最重要的部分：将所有非静态文件的请求，反向代理给Gunicorn
    location / {
        proxy_pass http://127.0.0.1:8000;  # 这里和Gunicorn配置的bind地址一致！
        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;
        # 这几行header配置是为了让Django能拿到用户的真实IP等信息
    }

    # 可选：屏蔽favicon.ico的日志记录，避免找不到时刷屏
    location = /favicon.ico {
        access_log off;
        log_not_found off;
    }
}

敲黑板！重点解析：

location /static/：Nginx会直接拦截所有以/static/开头的URL，然后直接从硬盘上的staticfiles目录读取文件并返回，完全不经过Django和Gunicorn，效率极高！
location /：对于其他所有请求，proxy_pass指令会把它原封不动地转发给在本机8000端口监听的Gunicorn。
proxy_set_header：这非常重要！因为经过Nginx代理后，Django看到的每个请求都来自127.0.0.1。通过这些Header，Django才能知道最初发起请求的真实客户端IP是什么。

保存文件后，我们需要启用这个站点。在Nginx里，这是通过创建一个符号链接到sites-enabled目录完成的。

sudo ln -s /etc/nginx/sites-available/my_django_project /etc/nginx/sites-enabled/

重要一步：为了防止默认配置冲突，我们删掉或禁用默认站点。

sudo rm /etc/nginx/sites-enabled/default

现在，检查一下我们的Nginx配置语法是否正确，Nginx对此非常严格，一个分号错了都不行：

sudo nginx -t

如果看到 syntax is ok 和 test is successful，就可以放心地重启Nginx了：

sudo systemctl restart nginx

步骤三：最后的准备——Django的收尾工作

设置ALLOWED_HOSTS：在你的settings.py中，必须将你的服务器IP或域名加进去，否则Django会拒绝服务。

ALLOWED_HOSTS = [‘你的服务器IP’， ‘你的域名’]  # 例如 ['123.123.123.123', 'www.mysite.com']

收集静态文件：这是很多新手会栽跟头的地方！Django在开发时静态文件是散落的，生产环境需要把它们收集到一个统一的目录，也就是Nginx配置里alias指向的那个目录。
在settings.py中设置：

STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

然后运行魔法命令：

python manage.py collectstatic

这会把你所有App里的static文件，以及Admin后台的静态文件，全部拷贝到STATIC_ROOT目录。

第四幕：启动服务，迎接高光时刻！

现在，万事俱备。回到你的项目根目录，用配置文件启动Gunicorn：

gunicorn -c gunicorn_config.py 你的项目名称.wsgi:application

或者，更专业的方式是使用systemd来管理Gunicorn进程，让它成为系统服务，实现开机自启和自动守护，这里就不展开了。

最后，打开浏览器，直接访问 http://你的服务器IP （不需要端口8000了，因为Nginx在80端口监听）。

如果一切顺利，你应该能看到一个样式完整、运行流畅的Django网站！它再也不是那个只能在本地“自嗨”的项目，而是一个能经受住公网考验的成熟应用了！

尾声：避坑与进阶

部署路上难免踩坑，记住几个排查命令：

sudo systemctl status nginx：查看Nginx状态。
sudo tail -f /var/log/nginx/error.log：实时查看Nginx错误日志。
tail -f /path/to/your/log/gunicorn_error.log：实时查看Gunicorn错误日志。

遇到502错误？大概率是Nginx连接不上Gunicorn，检查Gunicorn是否在运行，IP和端口是否匹配。
样式丢失？99%是静态文件配置路径错误，或者collectstatic没执行。

恭喜你，朋友！你已经成功完成了Django上线的成人礼。这套Nginx + Gunicorn的组合拳，足以应对大多数中小型项目。未来，你还可以探索Supervisor进程管理、Redis缓存、数据库优化、HTTPS配置等更高级的玩法。

现在，去享受你的项目被真实用户访问的成就感吧！