Docker for Mac下Nginx提示无可用上游服务器问题求助

我之前也碰到过一模一样的情况——在Ubuntu上跑的好好的Docker环境，搬到Mac上就出502，日志还报“no live upstreams”，核心原因其实是Docker for Mac的网络隔离机制和Linux原生Docker不一样，咱们一步步来解决：

一、先改Nginx的上游配置（最常见原因） #

你大概率是在Nginx配置里用了localhost或者127.0.0.1来指向后端/前端服务，但在Docker for Mac的容器里，localhost指的是容器自身，不是宿主机也不是其他容器。

举个例子，如果你的Nginx配置原来写的是：

upstream backend_service {
    server localhost:9000;
}

直接改成docker-compose里的服务名就行，比如你的后端服务叫backend，就写成：

upstream backend_service {
    server backend:9000;
}

因为docker-compose会自动创建内部DNS服务，服务名可以直接解析到对应容器的IP地址，这招在Linux上也能用，但Mac上必须这么做。

二、确保容器启动顺序正确 #

有时候Nginx启动得比后端/前端服务早，这时候去请求上游自然找不到活的服务。你可以在docker-compose.yml里给web-server加上depends_on，让它等后端和前端服务启动后再启动：

version: '2'
services:
  web-server:
    build: web-server
    container_name: mysite_web_server
    ports:
      - 80:80
      - 443:443
      - 3010:3010
    volumes:
      - ${BACKEND_PATH}:/var/www/backend
      # 你的其他卷配置
    depends_on:
      - backend
      - frontend
  backend:
    # 你的后端服务配置（比如PHP-FPM之类的）
  frontend:
    # 你的Node/Angular服务配置

不过要注意，depends_on只保证启动顺序，不保证服务完全就绪（比如后端可能启动了但还没加载完配置）。如果要更稳妥，可以用wait-for-it脚本，在Nginx启动前检查上游服务的端口是否开放：

1. 下载wait-for-it.sh脚本放到web-server目录下
2. 在web-server的Dockerfile里添加：

COPY wait-for-it.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/wait-for-it.sh

3. 修改docker-compose.yml里web-server的command：

command: ["wait-for-it.sh", "backend:9000", "--", "nginx", "-g", "daemon off;"]

（把backend:9000换成你实际的后端服务端口）

三、排查网络连通性 #

如果改了配置还是不行，进Nginx容器里ping一下后端服务名，看看能不能解析到IP：

docker exec -it mysite_web_server ping backend

如果ping不通，检查这几点：

• 所有服务是不是在同一个docker-compose网络里（默认是自动创建的，除非你自定义了网络但没把服务加进去）
• 有没有开VPN或者防火墙？Docker for Mac的网络有时候会被VPN拦截，试试关掉VPN再重启Docker。

四、确认上游服务真的在运行 #

最后，别光看Nginx日志，去检查前端/后端服务的状态：

• 看前端容器日志，确认Angular服务正常启动：

docker logs 你的前端容器名

• 进前端容器检查端口是否在监听：

docker exec -it 你的前端容器名 netstat -tulpn

要是服务没启动起来，那Nginx肯定报502，得先把服务本身的问题解决。

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