Nginx反向代理返回502 Bad Gateway错误求助

问题根源 #

你的Nginx运行在Docker容器内部，配置文件中使用的localhost指向的是容器自身的网络环境，而非你的物理宿主机。虽然你在宿主机上能直接访问localhost:3000和localhost:8086/test，但容器内部无法通过localhost访问到宿主机上的服务，因此反向代理请求失败，返回502 Bad Gateway错误。

解决方案 #

1. 替换为宿主机实际IP地址 #

找到你的宿主机在局域网内的IP地址（可通过ip addr（Linux/mac）或ipconfig（Windows）查看，例如192.168.1.105），修改Nginx配置中的proxy_pass地址：

location /test {
    proxy_pass http://192.168.1.105:8086/test;
}

location /home {
    proxy_pass http://192.168.1.105:3000;
}

location /home/auth {
    proxy_pass http://192.168.1.105:3000/auth;
}

修改后重启Nginx容器：

sudo docker restart nginx-base

2. 使用Docker内置的宿主机别名（推荐） #

Docker提供了host.docker.internal内置域名，用于在容器内部访问宿主机服务：

• Windows/macOS Docker Desktop：直接修改配置即可：

location /test {
    proxy_pass http://host.docker.internal:8086/test;
}

location /home {
    proxy_pass http://host.docker.internal:3000;
}

• Linux系统：需要在启动容器时添加--add-host参数，将host.docker.internal映射到宿主机网关：

sudo docker run -d --name nginx-base -p 80:80 --add-host=host.docker.internal:host-gateway nginx:latest

之后修改配置文件使用host.docker.internal，重启容器生效。

3. 使用Host网络模式启动容器 #

让Nginx容器直接共享宿主机的网络栈，这样容器内的localhost就等同于宿主机的localhost：
停止并删除原有容器：

sudo docker stop nginx-base && sudo docker rm nginx-base

用host网络模式重新启动：

sudo docker run -d --name nginx-base --network host nginx:latest

注意：此模式下不需要-p 80:80端口映射，容器会直接使用宿主机的80端口，需确保宿主机80端口未被其他服务占用。

额外优化建议 #

你的location /home/auth配置可以简化：如果在location /home的proxy_pass末尾添加斜杠/，Nginx会自动将/home后面的路径追加到目标地址后。修改后配置如下，可删除单独的/home/auth规则：

location /home {
    proxy_pass http://host.docker.internal:3000/;
}

此时访问http://localhost/home/auth会自动转发到http://host.docker.internal:3000/auth，效果和之前一致。

内容的提问来源于stack exchange，提问作者MrRobot9