Django：连接上游时(111: 连接被拒绝)的 gunicorn nginx 错误

在本文中，我们将介绍 Django、gunicorn 和 nginx 在连接上游时出现(111: 连接被拒绝)的错误及解决办法。

什么是 Django、gunicorn 和 nginx？

Django 是一个使用 Python 编写的开源 web 框架，广泛应用于构建高性能和可扩展的网站和应用程序。Django 提供了一套简洁而强大的工具和功能，可以快速开发复杂的 web 应用。

gunicorn（Green Unicorn）是一个 Python WSGI( Web 服务器网关接口) HTTP 服务器，被广泛用于在 Django 项目中处理并发请求。

nginx 是一个流行的高性能 HTTP 和反向代理服务器。它可以用来负载均衡和缓存静态资源，也可以作为反向代理服务器用于将请求转发到后端的 gunicorn 服务器。

错误和原因

当我们将 Django 项目部署到生产环境中，使用 gunicorn 和 nginx 进行服务器配置时，有时候会遇到以下错误信息：

(111: Connection refused) while connecting to upstream

这个错误消息表示 nginx 无法连接到 gunicorn 服务器的上游。

这个错误的主要原因可能有以下几种：

gunicorn 未能正确启动或已经停止运行；
gunicorn 的配置文件中的主机名或端口号设置不正确；
防火墙或代理服务器设置导致请求无法到达 gunicorn；
gunicorn 监听的 ip 地址配置错误。

解决方法

下面是几种常见的解决方法，可以帮助您解决这个错误。

1. 检查 gunicorn 是否正确运行

确保 gunicorn 服务器已经正确启动并且正在运行。您可以使用以下命令检查 gunicorn 进程是否正在运行：

ps aux | grep gunicorn

如果没有输出结果或者没有找到 gunicorn 进程，则需要重新启动 gunicorn。

2. 检查 gunicorn 的配置文件

查看 gunicorn 的配置文件，并确保主机名和端口号的设置正确。您可以通过以下方式找到配置文件的位置：

gunicorn --help | grep "configuration file"

然后编辑配置文件，检查配置是否正确，特别是 bind 参数是否与 nginx 配置的地址和端口一致。

例如，如果 nginx 配置中使用 proxy_pass http://127.0.0.1:8000;，则 gunicorn 配置中应该有类似的设置：bind = "127.0.0.1:8000"。

3. 检查防火墙或代理设置

如果您的服务器上启用了防火墙或代理服务器，请确保它们没有阻止请求到达 gunicorn。您可以检查防火墙规则并确认是否允许 gunicorn 相应的端口。

如果使用了代理服务器，请确保代理服务器的配置正确，并且请求被正确转发到 gunicorn。

4. 检查 gunicorn 监听的 ip 地址

确认 gunicorn 配置中监听的 ip 地址正确。一般来说，使用 "0.0.0.0" 表示监听所有可用的网络接口。

如果您的服务器有多个网络接口，请确保 gunicorn 配置中指定的 ip 地址与 nginx 配置一致。

示例

以下是一个示例 nginx 配置文件的简化版本：

server {
    listen 80;
    server_name example.com;
    access_log /var/log/nginx/access.log;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host host;
        proxy_set_header X-Real-IPremote_addr;
    }
}

在这个配置中，我们将请求通过代理转发到运行在 127.0.0.1:8000 的 gunicorn 服务器上。

要解决 (111: Connection refused) while connecting to upstream 错误，您可以按照以下步骤进行排查：

确保 gunicorn 正在运行：ps aux | grep gunicorn；
检查 gunicorn 配置文件中的绑定地址是否正确；
确认防火墙规则和代理服务器没有阻止请求到达 gunicorn；
确认 gunicorn 配置中监听的 ip 地址与 nginx 配置一致。

总结

在本文中，我们介绍了 Django、gunicorn 和 nginx 在连接上游时出现(111: 连接被拒绝)的错误，并提供了解决办法。当您遇到这个错误时，可以通过检查 gunicorn 是否正常运行、配置文件的设置、防火墙和代理设置以及 gunicorn 的监听地址等方面来解决。希望本文对您理解和解决这个错误有所帮助。