Django 504 网关超时 uwsgi + nginx Django 应用

在本文中，我们将介绍如何使用 uwsgi 和 nginx 部署 Django 应用，并解决可能出现的 504 网关超时错误。我们会先介绍 uwsgi 和 nginx 的作用及其工作原理，然后详细说明如何配置和启动 uwsgi 和 nginx，并最终解决 504 网关超时错误。

阅读更多：Django 教程

uwsgi 和 nginx 的作用及工作原理

uwsgi 是一个 Web 服务器网关接口（Web Server Gateway Interface，简称 WSGI），它定义了 Web 服务器如何与 Python 应用进行交互。uwsgi 提供了在生产环境中部署 Django 应用所需的各种功能，如负载均衡、多线程处理和静态文件处理等。

nginx 是一个高性能的 HTTP 和反向代理服务器，它可以作为一个独立的 Web 服务器来处理静态文件，并将动态请求转发给 uwsgi 进程。nginx 还支持负载均衡和缓存等功能，可以有效提高 Django 应用的性能和稳定性。

uwsgi 和 nginx 之间的工作原理如下：
1. 当用户发送请求时，nginx 接收到该请求并进行初步处理，如判断是否为静态文件请求等。
2. 如果请求为静态文件请求，nginx 直接返回静态文件给用户；否则，转发请求给 uwsgi 进程。
3. uwsgi 进程接收到转发的请求后，根据配置文件中的规则处理请求，并将响应返回给 nginx。
4. nginx 将响应返回给用户。

配置和启动 uwsgi

首先，我们需要安装 uwsgi：

pip install uwsgi

然后，创建一个 uwsgi 配置文件 myapp_uwsgi.ini，内容如下：

[uwsgi]
http-timeout = 600
http-timeout-keep-alive = 600

# Django specific settings
module = myapp.wsgi:application
env = DJANGO_SETTINGS_MODULE=myapp.settings
master = true
processes = 4
harakiri = 60
buffer-size = 65535
vacuum = true
max-requests = 5000
thunder-lock = true
socket-timeout = 600

die-on-term = true

# Socket settings
socket = /tmp/uwsgi.sock
chmod-socket = 664
chown-socket = nginx:nginx

# Log settings
logto = /var/log/uwsgi.log

说明：
– http-timeout 和 http-timeout-keep-alive 设置了 uwsgi 与 nginx 之间的超时时间，防止出现 504 网关超时错误。
– module 指定了 Django 应用的 WSGI 入口。
– env 设置了 Django 应用的配置文件路径。
– master 开启了主进程模式，可以更好地利用服务器资源。
– processes 设置了 uwsgi 进程的数量。
– harakiri 设置了最大请求处理时间，超过该时间的请求会被终止。
– buffer-size 设置了 uwsgi 的缓冲区大小。
– vacuum 设置为 true 可以自动清理 uwsgi 进程。
– max-requests 设置了每个 uwsgi 进程处理的最大请求数量。
– thunder-lock 开启了锁机制，避免多个 uwsgi 进程同时写入日志文件。
– socket-timeout 设置了与 nginx 之间的 socket 连接超时时间。
– die-on-term 当 uwsgi 进程接收到 TERM 信号时，立即终止。

完成配置后，我们可以使用以下命令启动 uwsgi：

uwsgi --ini myapp_uwsgi.ini

配置和启动 nginx

首先，我们需要安装 nginx：

sudo apt-get install nginx

然后，创建一个 nginx 配置文件 myapp_nginx.conf，内容如下：

server {
    listen 80;
    server_name example.com;

    # Proxy settings
    location / {
        uwsgi_pass unix:///tmp/uwsgi.sock;
        include uwsgi_params;
    }

    # Static files settings
    location /static/ {
        alias /path/to/static/files/;
    }

    # Media files settings
    location /media/ {
        alias /path/to/media/files/;
    }
}

说明：
– listen 指定了监听的端口号。
– server_name 指定了服务器的域名。
– location / 配置了 uwsgi 请求的转发规则。
– location /static/ 配置了静态文件请求的路径。
– location /media/ 配置了媒体文件请求的路径。

完成配置后，我们可以使用以下命令启动 nginx：

sudo service nginx start

解决 504 网关超时错误

当 uwsgi 返回的响应时间超过了 nginx 的超时时间，就会出现 504 网关超时错误。为了解决该错误，我们需要调整 nginx 的超时时间。

编辑 nginx 的配置文件 /etc/nginx/nginx.conf，找到以下配置项：

http {
    ...
    proxy_connect_timeout 600s;
    proxy_send_timeout 600s;
    proxy_read_timeout 600s;
    ...
}

将超时时间调整为较大的值，保存并退出。

然后重启 nginx 服务：

sudo service nginx restart

此时，您的 Django 应用应该能够正常运行，而不会遇到 504 网关超时错误。

总结

本文介绍了如何使用 uwsgi 和 nginx 部署 Django 应用，并解决可能出现的 504 网关超时错误。我们简要介绍了 uwsgi 和 nginx 的作用及其工作原理，然后详细说明了如何配置和启动 uwsgi 和 nginx，并最终解决了 504 网关超时错误。希望本文对您在部署 Django 应用时有所帮助。