Docker化Nginx反向代理返回502错误排查求助

核心错误原因 #

在Docker容器内部，localhost指向的是容器自身的网络命名空间，而非宿主机。你的Nginx容器尝试访问自己的7000端口，但该端口并未运行对应服务，因此返回502 Bad Gateway错误。

具体解决办法 #

方法1：使用宿主机实际IP地址 #

将Nginx配置中的proxy_pass目标地址替换为宿主机的真实IP（比如你的192.168.1.103）：

location /service {
  proxy_pass http://192.168.1.103:7000/;
}

注意：需确保7000端口的服务监听在0.0.0.0而非仅localhost，否则宿主机外部（包括容器）无法访问该服务。可在宿主机执行netstat -tulpn | grep 7000检查监听地址。

方法2：使用Docker自定义网络（推荐） #

通过Docker自定义网络实现容器间的DNS解析，无需依赖固定IP：

1. 创建自定义网络：

docker network create service-network

2. 重新启动7000端口的服务，加入该网络并设置别名：

docker run --network service-network --name backend-service [你的服务镜像]

3. 重新启动Nginx容器，同样加入该网络：

docker run --network service-network -p 80:80 [你的Nginx镜像]

4. 修改Nginx配置中的proxy_pass为服务容器的别名：

location /service {
  proxy_pass http://backend-service:7000/;
}

方法3：使用Host网络模式（不推荐） #

启动Nginx容器时添加--network host参数，让容器共享宿主机的网络栈，此时容器内的localhost等同于宿主机的localhost：

docker run --network host [你的Nginx镜像]

这种方式会丢失容器的网络隔离性，易引发端口冲突，仅适合测试场景。

额外检查点 #

• 执行docker logs <nginx容器名>查看容器日志，确认具体错误类型（如连接拒绝、地址无法解析等）
• 通过docker ps确认7000端口的服务容器处于运行状态

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