Docker Swarm中nginx_proxy依赖nginx_1/nginx_2的启动方案咨询

针对你遇到的Docker Swarm中nginx_proxy因后端nginx_1/nginx_2未启动而崩溃的问题，以下是几个可行的替代方案：

方案1：修改Nginx配置，容忍后端服务不可用 #

核心思路是让Nginx在后端服务DNS解析失败或不可用时，不会直接崩溃，而是返回友好错误或重试。

修改你的Nginx配置，添加以下关键配置：

# 配置Swarm内置DNS解析器（Swarm中DNS默认地址是127.0.0.11）
resolver 127.0.0.11 valid=30s;

server {
    listen 80;
    server_name www.app1.com;

    location / {
        # 使用变量存储后端地址，让Nginx每次请求都重新解析DNS
        set $backend http://nginx_1;
        proxy_pass $backend;

        # 配置后端不可用时的重试策略
        proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        # 缩短连接超时，避免长时间阻塞
        proxy_connect_timeout 5s;
        proxy_send_timeout 5s;
        proxy_read_timeout 5s;

        # 保留原有的proxy_set_header配置
        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;
        proxy_set_header X-Forwarded-Host $host:$server_port;
        proxy_http_version 1.1;
    }
}

server {
    listen 80;
    server_name www.app2.com;

    location / {
        set $backend http://nginx_2;
        proxy_pass $backend;

        proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        proxy_connect_timeout 5s;
        proxy_send_timeout 5s;
        proxy_read_timeout 5s;

        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;
        proxy_set_header X-Forwarded-Host $host:$server_port;
        proxy_http_version 1.1;
    }
}

原理说明： #

• resolver 127.0.0.11：指定Swarm内置的DNS服务器，确保Nginx能正确解析Swarm服务名
• set $backend：用变量存储后端地址，强制Nginx每次请求都重新查询DNS，避免缓存失效的问题
• proxy_next_upstream：配置当后端返回错误、超时等情况时，自动重试（单后端场景下主要避免Nginx崩溃）
• 缩短超时时间：避免Nginx因等待无响应的后端而挂起

方案2：启动前检查后端服务可用性 #

在nginx_proxy的启动脚本中，先检查nginx_1和nginx_2是否可访问，确认正常后再启动Nginx。

步骤1：创建启动脚本start-proxy.sh #

#!/bin/sh
set -e

# 等待nginx_1和nginx_2的DNS解析可用
echo "Waiting for nginx_1 to be ready..."
until nslookup nginx_1; do
    sleep 2
done

echo "Waiting for nginx_2 to be ready..."
until nslookup nginx_2; do
    sleep 2
done

# 可选：进一步检查后端服务是否能正常响应
echo "Checking nginx_1 service..."
until curl -f http://nginx_1; do
    sleep 2
done

echo "Checking nginx_2 service..."
until curl -f http://nginx_2; do
    sleep 2
done

# 启动Nginx
exec nginx -g 'daemon off;'

步骤2：修改Docker栈文件，使用该脚本作为入口点 #

在你的nginx_proxy服务配置中，添加entrypoint配置，并给后端服务加上健康检查：

version: '3.9'

services:
  nginx_proxy:
    image: nginx:alpine
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - ./start-proxy.sh:/usr/local/bin/start-proxy.sh
    entrypoint: ["sh", "/usr/local/bin/start-proxy.sh"]
    # 其他配置如ports、deploy等
  nginx_1:
    image: your-nginx-1-image
    deploy:
      replicas: 1
      # 添加健康检查，确保服务真正就绪
      healthcheck:
        test: ["CMD", "curl", "-f", "http://localhost"]
        interval: 5s
        timeout: 3s
        retries: 3
  nginx_2:
    image: your-nginx-2-image
    deploy:
      replicas: 1
      healthcheck:
        test: ["CMD", "curl", "-f", "http://localhost"]
        interval: 5s
        timeout: 3s
        retries: 3

原理说明： #

• 启动脚本通过nslookup检查服务DNS是否可解析（确认Swarm已注册服务）
• 可选的curl检查配合后端服务的healthcheck，确保后端服务真正能处理请求
• 只有当两个后端都就绪后，才启动Nginx，从根源避免解析失败崩溃的问题

方案3：通过Swarm部署顺序控制（适合CI/CD场景） #

如果使用CI/CD工具部署Swarm栈，可以分步骤部署：

1. 先部署nginx_1和nginx_2服务：

   docker stack deploy -c docker-compose.yml my_stack --prune --with-registry-auth --services nginx_1 nginx_2
   

2. 等待服务就绪（可以用docker service ps检查状态，或结合健康检查脚本）
3. 再部署nginx_proxy服务：

   docker stack deploy -c docker-compose.yml my_stack --prune --with-registry-auth --services nginx_proxy
   

这种方式适合自动化部署流程，手动操作也可以分两步执行。

关于depends_on的小提示 #

你遇到的services.nginx.depends_on must be a list错误，是因为depends_on的格式必须是数组（即使只有一个依赖），比如：

nginx_proxy:
  depends_on:
    - nginx_1
    - nginx_2

但要注意，即使格式正确，Swarm模式下depends_on仅控制服务的创建顺序，不会等待依赖服务完全就绪，所以还是会出现后端未就绪导致的崩溃问题，因此不推荐依赖这个配置。

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