通过Docker运行Nginx反向代理Node.js应用时返回502错误该如何解决

• 核心原因是Docker容器的默认网络隔离机制：你配置中proxy_pass http://localhost:1337里的localhost指向的是Nginx容器自身的环回地址，而非运行Node.js应用的宿主机环回地址，Nginx在容器内找不到1337端口的服务，所以返回502错误。
• 额外可能原因：如果你的Node.js应用也运行在Docker容器中，两个容器未加入同一网络时，也会出现网络不通的问题。

场景一：Node.js应用直接运行在宿主机（未容器化） #

方案1：使用宿主机网络启动Nginx容器 #

启动容器时添加--network host参数，让Nginx容器直接共享宿主机的网络栈，此时容器内的localhost和宿主机完全一致，无需额外端口映射：

docker run -d --network host back-nginx-docker

方案2：修改代理地址为宿主机IP #

先获取宿主机的局域网IP（比如192.168.3.20，不要用127.0.0.1），将Nginx配置中的proxy_pass改为：

proxy_pass http://你的宿主机IP:1337;

重新构建镜像后，用原命令启动即可：

docker build -t back-nginx-docker .
docker run -d -p 80:80 back-nginx-docker

场景二：Node.js应用也运行在Docker容器中 #

1. 先创建自定义Docker网桥网络，实现同网络下容器可通过容器名互相访问：

docker network create app-net

2. 启动Node.js容器时加入该网络，并指定容器名（比如叫node-service）：

docker run -d --name node-service --network app-net 你的Node.js镜像名

3. 修改Nginx配置中proxy_pass为Node.js容器名+端口：

proxy_pass http://node-service:1337;

4. 重新构建Nginx镜像后，加入同一网络启动：

docker build -t back-nginx-docker .
docker run -d -p 80:80 --network app-net back-nginx-docker

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