Docker容器中Nginx配置端口代理失败，请求排查错误原因

核心错误原因 #

Docker容器拥有独立的网络命名空间，Nginx容器内的127.0.0.1指向容器自身的回环地址，而非宿主机或Node.js容器。当前proxy_pass配置试图访问Nginx容器内部的3010端口，但该端口并未运行Node.js服务，因此出现连接拒绝错误。

具体错误点 #

• proxy_pass目标地址错误：使用http://127.0.0.1:3010导致Nginx在自身容器内寻找服务，而非Node.js容器。

修正方法 #

方法一：使用Docker容器名称（推荐，稳定可靠） #

Docker自定义网络支持容器名称解析，只需将两个容器加入同一网络，即可通过容器名互相访问：

1. 创建自定义Docker网络（避免默认bridge网络的限制）：

docker network create app-network

2. 启动Node.js容器时加入该网络，并指定容器名：

docker run --name node-service --network app-network -p 3010:3010 [你的Node.js镜像名]

3. 启动Nginx容器时加入同一网络：

docker run --name nginx-proxy --network app-network -p 2010:2010 [你的Nginx镜像名]

4. 修改nginx.conf的proxy_pass配置：

server {
   listen 2010;
   server_name 127.0.0.1; 
   root /usr/share/nginx/html;
   
   location ^~ /login {
      proxy_pass http://node-service:3010;
      # 可选：添加常用代理头，确保Node服务能获取正确的客户端信息
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   }
}

解释：node-service是你给Node.js容器指定的名称，Docker会自动将其解析为对应容器的IP地址，无需手动维护IP。

方法二：使用宿主机的Docker网络IP（不推荐，依赖环境） #

如果不想使用自定义网络，可通过宿主机在Docker网络中的IP访问Node服务：

1. 从错误日志可知，宿主机在Docker bridge网络的IP为172.17.0.1（不同环境可能略有差异，可通过docker inspect bridge查看）。
2. 修改proxy_pass为：

proxy_pass http://172.17.0.1:3010;

3. 确保Node.js容器启动时已将3010端口映射到宿主机（即启动命令包含-p 3010:3010）。

额外检查项 #

• 确认Node.js服务在容器内监听的是0.0.0.0:3010，而非仅127.0.0.1（否则容器外部无法访问）。
• 验证Node.js容器正常运行，可通过docker exec node-service curl 127.0.0.1:3010测试容器内部服务是否可用。

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