Nginx配置：默认上游服务器不可达时如何设置备用上游服务器？

首先，你的核心问题是Nginx启动时会强制解析所有upstream中定义的主机域名，如果对应的Docker容器未运行，Docker DNS无法解析该主机，就会触发启动失败。同时要实现主服务器不可用时自动切换到备用服务器，可按以下步骤配置：

一、解决Nginx启动失败问题 #

要让Nginx不再在启动时强制解析上游主机，而是运行时动态解析，需要添加DNS resolver并配置动态解析参数：

1. 在你的Nginx配置的http块（或当前server块所在的配置文件顶部）添加Docker内置DNS的resolver：

resolver 127.0.0.11 valid=30s;

127.0.0.11是Docker默认的内置DNS服务器，valid参数设置DNS缓存有效期，避免频繁解析。

2. 修改upstream配置，给每个server添加resolve参数：

upstream somecontainer {
    server somecontainer:5000 resolve;
    server fallbackserver:5000 resolve;
    # 配置失败判定规则：30秒内失败3次则标记为不可用
    max_fails=3 fail_timeout=30s;
}

添加resolve后，Nginx启动时不会验证主机是否可达，而是在每次请求时动态解析，这样即使主容器未运行，Nginx也能正常启动。

二、配置主备自动切换 #

上述upstream配置中已经通过max_fails和fail_timeout实现了自动切换：当主服务器（somecontainer）在30秒内连续失败3次，Nginx会在接下来的30秒内将请求转发到备用服务器（fallbackserver），直到主服务器恢复正常。

如果需要更精准的错误触发逻辑，也可以通过proxy_next_upstream和错误页跳转实现：

server {
    # 省略其他ssl、server_name等配置...

    location / {
        set $main_backend http://somecontainer:5000;
        proxy_pass $main_backend;
        # 指定哪些错误触发切换到备用服务器
        proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        
        # 当主服务器返回5xx错误时，跳转到备用location
        error_page 502 503 504 = @fallback;
        
        # 保留原有的proxy_header配置
        proxy_set_header  Host              $http_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_read_timeout                  900;
    }

    # 备用服务器的location
    location @fallback {
        proxy_pass http://fallbackserver:5000;
        # 同样设置proxy_header
        proxy_set_header  Host              $http_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_read_timeout                  900;
    }
}

注意事项 #

• 确保备用服务器（fallbackserver）始终处于运行状态，或者同样配置动态解析，避免Nginx启动时依赖它。
• 如果使用Docker Compose，容器名会自动被DNS解析，无需额外配置hosts。

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