Nginx 中如何为静态资源配置备用服务器地址-Nginx-PHP中文网

nginx不支持静态资源直配备用服务器，但可通过error_page+proxy_pass实现伪备用：本地404时内部重定向至命名location代理远程服务；支持按文件类型分流回源；高可用场景可结合upstream与健康检查。

nginx 中如何为静态资源配置备用服务器地址

Nginx 本身不支持为静态资源直接配置“备用服务器地址”——因为静态资源默认由本机文件系统提供，不涉及后端转发。所谓“备用服务器”，本质上是针对动态请求代理失败时的故障转移机制，需依赖 proxy_pass + upstream 实现。但如果你的目标是：当本地静态文件缺失、读取失败或服务不可用时，自动回退到另一台服务器（如 CDN 或备用 Nginx 节点）提供相同资源，那可以通过组合 error_page、location 和 proxy_pass 实现“伪备用”。

下面分三种典型场景说明可行方案：

静态资源本地缺失时回退到远程备用服务器

适用于主服务器存放部分资源，缺失时由远端（如另一台 Nginx 或对象存储）兜底。

server {
    listen 80;
    server_name static.example.com;

    # 主静态根目录
    root /var/www/static;

    location / {
        index index.html;
        # 尝试本地文件，404时触发错误页重定向
        error_page 404 = @fallback;
    }

    # 备用代理：转发到另一台服务器（如备用 Nginx 或 CDN 回源地址）
    location @fallback {
        proxy_pass https://backup-static.example.com;  # 注意协议和域名
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

✅ 关键点：error_page 404 = @fallback 中的 = 表示内部重定向（不改变客户端 URL），且仅对 location / 内部 404 生效；@fallback 是命名 location，专用于内部跳转。

按文件类型分流 + 备用回源

比如图片缺失时走备用图床，JS/CSS 缺失时走 CDN：

Nginx

在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能，一键优化高并发性能，助您高效搭建稳定、快速的网站运行环境。

下载

location ~* \.(jpg|jpeg|png|gif|webp)$ {
    root /var/www/static/images;
    error_page 404 = @image_fallback;
}

location @image_fallback {
    proxy_pass https://cdn.example.com/images/;
    proxy_set_header Host cdn.example.com;
}

location ~* \.(js|css|woff2|ttf)$ {
    root /var/www/static/assets;
    error_page 404 = @asset_fallback;
}

location @asset_fallback {
    proxy_pass https://assets-cdn.example.com/;
}

⚠️ 注意：proxy_pass 末尾是否带 / 决定路径拼接方式。例如 proxy_pass https://a.com/; 会把 /static/a.js 映射为 https://a.com/static/a.js；若写成 proxy_pass https://a.com;（无斜杠），则变为 https://a.com/static/a.js —— 效果相同；但若 proxy_pass https://a.com/cdn/;，则 /static/a.js → https://a.com/cdn/static/a.js。

用 upstream 实现健康检查 + 多备用节点（推荐用于高可用）

当备用服务本身也是 Nginx 集群时，可定义 upstream 并启用主动健康检查（需 nginx-plus 或开源版配合 ngx_http_upstream_check_module）：

upstream fallback_servers {
    server backup1.example.com max_fails=2 fail_timeout=30s;
    server backup2.example.com max_fails=2 fail_timeout=30s;
    # 可加 backup 标记为纯备用（仅当所有非 backup 都不可用时才启用）
    # server backup3.example.com backup;
}

server {
    location / {
        root /var/www/static;
        error_page 404 = @try_fallback;
    }

    location @try_fallback {
        proxy_pass http://fallback_servers;
        proxy_intercept_errors on;  # 允许捕获上游返回的 4xx/5xx
        error_page 404 = /404.html; # 最终兜底页面
    }
}