Docker中Nginx无法代理本地主机，持续返回502 Bad Gateway错误

核心问题定位 #

从错误日志看，Nginx已成功解析host.docker.internal到172.17.0.1（Docker默认网关），但连接超时，绝大多数情况是宿主机上的服务仅监听了127.0.0.1地址——Docker容器无法访问宿主机的本地回环地址，必须让服务监听0.0.0.0或容器所在网段的IP。

排查与修复步骤 #

1. 检查宿主机服务的监听地址 #

执行命令查看服务的监听状态：

# Linux 系统用netstat
netstat -tulpn | grep 你的服务端口
# 或更简洁的ss命令
ss -tulpn | grep 你的服务端口

如果输出显示127.0.0.1:端口，说明服务只绑定了本地回环，容器无法访问。需要修改服务启动配置，让它监听0.0.0.0：

• Python Flask：app.run(host='0.0.0.0', port=你的端口)
• Node.js Express：app.listen(你的端口, '0.0.0.0')
• 其他服务：参考对应文档调整监听地址参数

2. 验证容器内的连通性 #

进入Nginx容器直接测试宿主机服务：

docker-compose exec proxy sh
# 替换成你的服务端口
curl http://host.docker.internal:你的服务端口

如果curl仍然超时，说明是宿主机防火墙或网络配置问题：

• Ubuntu（ufw防火墙）允许Docker网段访问：

  ufw allow from 172.17.0.0/16 to any port 你的服务端口
  

• CentOS/Fedora（firewall-cmd）：

  firewall-cmd --add-rich-rule='rule family="ipv4" source address="172.17.0.0/16" port port="你的服务端口" protocol="tcp" accept' --permanent
  firewall-cmd --reload
  

3. 修正Nginx配置 #

如果宿主机服务不在80端口，必须在proxy_pass中指定端口：

location / {
    proxy_pass http://host.docker.internal:你的服务端口;
    # 可选：添加代理头，避免服务识别异常
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

修改后重启Nginx容器：

docker-compose restart proxy

内容的提问来源于stack exchange，提问作者Floris van den Berg