You need to enable JavaScript to run this app. Docker Compose部署Nginx反向代理转发后端服务报502 Bad Gateway
优惠活动
大模型
产品
解决方案
定价
更多

Docker Compose部署Nginx反向代理转发后端服务报502 Bad Gateway

问题根因定位

502 Bad Gateway的核心触发原因,是反向代理容器的转发配置存在网络地址误用:

  • 当前反代配置中,proxy_pass指向的127.0.0.1:8081、127.0.0.1:8082,是反向代理Nginx容器自身的内部回环地址,而非宿主机或其他业务容器的网络位置
  • 每个容器都有独立的网络栈,回环地址仅指向容器自身,反代容器内部并没有监听8081、8082端口的服务,因此转发请求根本无法到达后端业务服务,直接返回502
  • 宿主机直接访问8081、8082端口能正常响应,是因为这是Docker端口映射暴露到宿主机的地址,容器内部无法通过这个映射端口访问对应服务,必须走Docker内部网络的服务通道连通
修正方案

1. 调整反向代理的转发地址

将原conf.d/default.conf的内容替换为基于Docker内部网络服务名的配置,删除对回环地址的错误引用:

server {
    listen 80;

    # 匹配/one路径的请求,转发到nginx-one容器的服务端口
    location /one/ {
        proxy_pass http://nginx-one:80/;
        # 补充常规代理请求头,保障后端服务能获取真实请求信息
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # 匹配/two路径的请求,转发到nginx-two容器的服务端口
    location /two/ {
        proxy_pass http://nginx-two:80/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

注意:location路径末尾的斜杠和proxy_pass地址末尾的斜杠需要匹配,配置完成后访问/one路径时,请求会自动去掉/one前缀,转发到后端服务的根路径,和预期的路由逻辑一致。

2. 优化网络边界配置

原docker-compose.yml中所有容器同时接入frontend、backend网络的配置可以调整,让网络隔离更符合生产规范,同时保留服务连通性:

version: "3.3"
services:
  nginx-one:
    image: nginx:1.17.8
    ports:
      - "8081:80"
    # 后端业务服务仅接入内部backend网络,不直接对外暴露
    networks: 
      - backend
    volumes: 
      - ./nginx-one/html:/usr/share/nginx/html

  nginx-two:
    image: nginx:1.17.8
    ports:
      - "8082:80"
    networks: 
      - backend
    volumes: 
      - ./nginx-two/html:/usr/share/nginx/html

  nginx-reverse-proxy:
    image: nginx:1.17.8
    ports:
      - "8080:80"
    # 反向代理同时接入对外的frontend网络和内部backend网络
    networks: 
      - frontend
      - backend
    volumes: 
      - ./nginx-reverse-proxy/html:/usr/share/nginx/html
      - ./nginx-reverse-proxy/conf.d:/etc/nginx/conf.d

  debian-network:
    image: cslev/debian_networking
    stdin_open: true
    tty: true
    # 网络测试容器接入内部backend网络,可直接探测后端服务连通性
    networks: 
      - backend

networks:
  frontend:
    internal: false
  backend:
    internal: true
连通性测试说明

之前的测试脚本执行报连接拒绝,是因为两个认知误区导致:

  • 测试容器作为独立容器,自身的127.0.0.1回环网络和宿主机完全隔离,直接访问127.0.0.1:8080、127.0.0.1:8081这类映射到宿主机的端口,在容器内是无法连通的
  • 同处于Docker网络内的容器,需要通过服务名完成DNS解析访问,不需要使用容器名或宿主机端口映射地址
  • 调整配置后,可在测试容器内执行curl http://nginx-one、curl http://nginx-two验证连通性,能正常返回页面内容时,再从宿主机访问反代入口,就不会再出现502错误

内容的提问来源于stack exchange,提问作者Jimmix

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 17:36:10