Docker Compose配置Nginx反向代理路由至错误容器问题

问题场景 #

通过docker-compose搭建包含2个Web应用容器（均运行Nginx）和1个Nginx反向代理容器的网络环境，反向代理配置如下：

events {}
http {
    server {
        listen       8090;
        server_name  localhost;
        location / {
            proxy_pass http://myappui:8080;
        }
        location /admin/ {
            proxy_pass http://myappadmin:8081/;
#  this works  proxy_pass http://microsoft.com/;
        }
    }
}

出现异常：访问/admin/路径时，请求未按预期路由到myappadmin:8081，反而被转发到myappui:8080/admin；但将proxy_pass目标替换为外部域名（如microsoft.com）时路由正常。直接通过宿主机自动分配端口访问myappadmin容器，应用可正常打开。

docker-compose配置如下：

version: '3.4'

services:
  myappui:
    build:
      dockerfile: ./Docker/Dockerfile.ui
    tty: true
    container_name: myappui
    ports:
    - "8080"
    networks:
    - webnet

  myappadmin:
    build:
      dockerfile: ./Docker/Dockerfile.admin
    tty: true
    container_name: myappadmin
    ports:
    - "8081"
    networks:
    - webnet    

  nginx: 
    image: nginx:latest
    tty: true
    container_name: myappreverseproxy
    ports:
    - "8090:8090"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    networks:
    - webnet

networks:
  webnet  :
    driver: bridge

问题分析 #

核心问题出在Nginx的路径匹配与代理转发逻辑，结合场景来看：

• 外部域名代理正常，说明反向代理的基本转发机制没问题；
• 直接访问myappadmin正常，说明目标容器服务本身无故障；
• 错误路由到myappui，大概率是反向代理的Nginx配置存在语法疏漏，或者容器间DNS解析/网络连通性出现偶发异常。

修复方案 #

1. 验证反向代理配置语法 #

进入反向代理容器，执行配置校验命令，确保配置无语法错误：

docker exec -it myappreverseproxy nginx -t

若提示错误，根据输出修正nginx.conf。

2. 优化代理配置 #

调整/admin/的location块，添加必要的代理请求头，确保转发逻辑清晰：

location /admin/ {
    proxy_pass http://myappadmin:8081/;
    # 添加代理头，避免目标容器丢失请求源信息
    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;
}

3. 检查容器间网络连通性 #

在反向代理容器中测试对myappadmin的DNS解析与连通性：

# 测试DNS解析
docker exec -it myappreverseproxy ping myappadmin
# 测试端口连通性
docker exec -it myappreverseproxy curl http://myappadmin:8081

若解析失败，确认所有容器都加入了webnet网络；若端口不通，检查myappadmin容器内的Nginx是否确实监听8081端口。

4. 重启反向代理容器 #

修改配置后，重启容器使配置生效：

docker-compose restart nginx

额外排查 #

• 查看反向代理容器的Nginx日志，定位具体转发错误：

  docker logs myappreverseproxy
  

• 检查myappadmin容器内的Nginx配置，确保根路径/有正确的站点配置，无异常重定向规则。

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