基于docker-compose的Nginx反向代理无法转发请求如何解决？

问题原因 #

你遇到的故障由两个核心错误共同导致：

1. 配置加载优先级错误
   你将自定义nginx.conf放到了/etc/nginx/conf.d/nginx.conf路径下，而官方nginx:alpine镜像默认存在/etc/nginx/conf.d/default.conf文件，其中的80端口server块优先级高于你的自定义配置，导致你的转发规则完全未生效，所有请求都走了默认的静态文件服务逻辑，所以根路径返回默认欢迎页，子路径报错找不到本地静态文件。
2. upstream节点地址错误
   Docker容器网络与宿主机网络隔离，你在nginx容器配置中写的localhost:3001访问的是nginx容器自身的环回地址，而非宿主机上映射的其他服务端口。Docker Compose为同一项目下的服务提供了内部DNS解析，直接使用服务名即可访问对应容器，端口使用容器内部暴露的端口即可（本次场景中三个业务服务内部暴露的都是80端口）。

修复步骤 #

1. 修正Nginx服务的Dockerfile：

FROM nginx:alpine
# 清理默认配置避免冲突
RUN rm -rf /etc/nginx/conf.d/*
# 覆盖主配置文件
COPY ./nginx.conf /etc/nginx/nginx.conf

2. 修正nginx.conf的upstream配置：

upstream shell {
  server shell:80;
}

upstream app1 {
  server app1:80;
}

upstream app2 {
  server app2:80;
}

# 其余原有配置保持不变即可

3. 重新构建启动服务：

docker-compose -f docker-compose.local.yaml up -d --build

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