怎么配置 Nginx 实现静态资源请求的容灾路由-Nginx-PHP中文网

nginx静态资源容灾路由核心是通过try_files+error_page实现多级兜底，或upstream+proxy_next_upstream自动重试，辅以url参数动态路由；需注意alias/root区别、proxy_pass尾部斜杠、error_page的=符号及upstream健康参数配置。

怎么配置 nginx 实现静态资源请求的容灾路由

Nginx 实现静态资源请求的容灾路由，核心是让一次请求在主路径失败时，能自动、无感地切换到备用路径（如备用源站、本地磁盘、降级资源），不依赖外部健康检查，全靠 Nginx 内置指令协同完成。

用 try_files + error_page 实现多级兜底

这是最轻量、最可控的方式，适合静态资源（如 `/static/js/app.js`）按优先级逐层 fallback： - 第一级：尝试本地磁盘缓存（最快，零网络开销） - 第二级：回源到主静态服务器 - 第三级：回源到备用静态服务器 - 第四级：返回统一降级 HTML 或空响应

示例配置：

location /static/ {
    # 1. 先查本地磁盘（/data/static/ 对应 /static/ 路径）
    alias /data/static/;
    try_files $uri @primary;
<pre class="brush:php;toolbar:false;"># 2. 本地没命中，走主源（带错误捕获）
location @primary {
    proxy_pass http://origin-primary;
    proxy_set_header Host $host;
    proxy_intercept_errors on;
    error_page 502 503 504 = @backup;
}

# 3. 主源失败，切到备用源
location @backup {
    proxy_pass http://origin-backup;
    proxy_set_header Host $host;
    proxy_intercept_errors on;
    error_page 502 503 504 = @degrade;
}

# 4. 备用源也失败，返回降级资源（可为本地文件或内嵌响应）
location @degrade {
    # 方式一：返回本地降级页
    alias /data/degrade/;
    try_files /404.html =404;

    # 方式二：直接返回空响应（适合图片/js/css等）
    # return 204;
}

}

用 upstream + proxy_next_upstream 做主备自动重试

适合主备源域名相同、端口一致，且希望由 Nginx 自动探测并重试的场景（例如两台结构相同的静态源站）： - 不需要显式写多个 location，逻辑更简洁 - 但要求主备服务协议、路径完全兼容（否则重试可能 404）

关键点：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

在 upstream 中定义主、备 server，不加 backup 标记（避免仅在主全挂时才启用，我们要的是“单次失败即切换”）
用 proxy_next_upstream 明确指定哪些状态码触发重试（如 502/503/timeout）
配合 proxy_next_upstream_tries 和 proxy_next_upstream_timeout 控制重试行为，防止卡顿

示例：

upstream static_origin {
    server origin-primary.example.com:80 max_fails=1 fail_timeout=10s;
    server origin-backup.example.com:80 max_fails=1 fail_timeout=10s;
}
<p>server {
location /static/ {
proxy_pass <a href="https://www.php.cn/link/20540c599746e70d0787f05c42f002bb">https://www.php.cn/link/20540c599746e70d0787f05c42f002bb</a>;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;</p><pre class="brush:php;toolbar:false;">    proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
    proxy_next_upstream_tries 2;
    proxy_next_upstream_timeout 5s;
}

}

结合 URL 参数做动态路由（按需容灾）

某些场景下，你希望部分请求强制走备用链路（比如灰度发布、AB 测试、或某类资源已知主源不稳定）： - 利用 $arg_xxx 获取 URL 参数（如 ?fallback=1） - 用 if 判断跳转，或直接改写 proxy_pass 目标

示例（带 fallback 参数则直连备用源）：

location /static/ {
    if ($args ~* "fallback=1") {
        proxy_pass http://origin-backup;
        break;
    }
    proxy_pass http://origin-primary;
    proxy_set_header Host $host;
}

⚠️ 注意：if 在 location 中慎用，仅限简单变量判断；复杂逻辑建议用 map 指令预定义变量。