解决nginx-proxy连接上游服务被拒绝的问题

问题背景

在使用nginx-proxy作为反向代理时，经常会遇到"connect() failed (111: Connection refused)"的错误。这个错误表明nginx-proxy无法连接到上游服务，通常是由于配置不当导致的。

错误现象

当nginx-proxy尝试将请求转发到上游服务时，会在日志中记录类似以下错误：

connect() failed (111: Connection refused) while connecting to upstream

根本原因分析

通过分析典型的docker-compose配置，我们发现最常见的错误原因是混淆了VIRTUAL_PORT的配置。在nginx-proxy项目中：

1. VIRTUAL_PORT应该指向容器内部实际监听的端口，而不是主机映射的端口
2. 很多用户错误地将主机发布的端口号配置为VIRTUAL_PORT

正确配置示例

反向代理配置(docker-compose.yml)

services:
  nginxproxy:
    image: nginxproxy/nginx-proxy
    # 其他配置...

上游服务配置

services:
  webapp:
    image: nginx:latest
    environment:
      VIRTUAL_HOST: example.com
      VIRTUAL_PORT: 80  # 这是容器内部监听的端口
    ports:
      - 8080:80  # 这是主机映射端口，与VIRTUAL_PORT无关

配置要点解析

1. VIRTUAL_PORT：必须设置为容器内部应用实际监听的端口号
2. ports映射：主机端口与容器端口的映射关系，不影响nginx-proxy的连接
3. 网络连通性：确保所有服务在同一个Docker网络中

排查步骤

当遇到连接拒绝错误时，可以按照以下步骤排查：

1. 检查容器内部实际监听的端口
2. 确认VIRTUAL_PORT设置是否正确
3. 验证网络连通性
4. 检查nginx-proxy生成的upstream配置

总结

正确理解和使用VIRTUAL_PORT是解决nginx-proxy连接问题的关键。记住这个简单的规则：VIRTUAL_PORT总是容器内部的端口，而不是主机映射的端口。通过遵循这个原则，可以避免大多数连接被拒绝的问题。

对于初学者来说，理解Docker网络和端口映射的基本概念是使用nginx-proxy这类工具的基础。当遇到问题时，仔细检查端口配置往往能快速找到解决方案。