Docker容器内请求访问宿主机API报错502的解决方法

首先咱们先理清两个关键问题，一步步来解决：

1. 先解决端口冲突的隐患 #

你当前启动容器的命令是：

sudo docker run -p 9002:9000 pitstop-nginx

但你提到宿主机上的API服务器已经占用了9002端口，这会直接导致容器启动失败（端口被抢占）。所以第一步得先调整容器的映射端口，比如换成9003：

sudo docker run -p 9003:9000 pitstop-nginx

这样容器的9000端口映射到宿主机9003，不会和API的9002端口冲突。

2. 容器访问宿主机服务的核心问题 #

容器里的localhost或127.0.0.1指向的是容器自身，不是宿主机——这就是JS调用API出现502的根本原因。下面给你几种可行的解决方案：

方案一：使用Docker官方提供的特殊地址（推荐） #

Docker为了方便容器访问宿主机，内置了host.docker.internal这个特殊DNS名称，它会自动解析到宿主机的IP地址：

• 修改静态页面的JS代码，把API请求地址从http://localhost:9002/api/auth/login改成http://host.docker.internal:9002/api/auth/login
• 如果是Linux系统的旧版Docker，可能需要额外加参数确保这个地址生效，启动命令改成：

  sudo docker run -p 9003:9000 --add-host host.docker.internal:host-gateway pitstop-nginx
  

方案二：直接使用宿主机的真实IP地址 #

找到宿主机的局域网IP（比如192.168.1.100，可以用ip addr或ifconfig命令查看），然后修改JS里的API地址为http://192.168.1.100:9002/api/auth/login。这种方式的缺点是如果宿主机IP变化，需要重新调整代码。

方案三：检查宿主机防火墙设置 #

如果上面两种方法还是不行，大概率是宿主机防火墙阻止了容器的请求。比如在Linux上，你需要允许Docker网桥的默认IP段（172.17.0.0/16）访问9002端口：

sudo ufw allow from 172.17.0.0/16 to any port 9002

或者用iptables配置对应的放行规则。

最后可以验证一下：启动容器后，进入容器内部ping一下host.docker.internal或宿主机IP，确认能连通后再测试API请求是否正常。

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