nginx 默认首页fallback由try_files驱动，index仅辅助目录请求；三类场景：①静态优先fallback后端，②api故障降级维护页，③无静态文件直连后端；核心依赖try_files、error_page和proxy_intercept_errors。
Nginx 本身不直接用 index 指令“配合后端代理”来 fallback，默认首页的 fallback 逻辑主要靠 try_files + proxy_pass 协同完成；index 在这个场景里只起辅助作用——它确保当请求的是一个目录（如 /）且该目录下存在 index.html 时，能正确返回静态首页；而真正的“后端 fallback”（比如首页静态文件不存在时转给后端渲染），必须由 try_files 驱动。
下面分三类典型场景讲清楚怎么做：
默认首页优先静态，缺失则交由后端处理
适用于前后端分离但允许服务端渲染兜底的项目（如 Next.js、Nuxt SSR 或自建 PHP/Node 入口）：
-
index指令仍需配置，用于目录请求（/）时查找静态入口 -
try_files负责按顺序试探：先找真实文件 → 再找目录（触发index）→ 最后内部重定向到命名 location，由 proxy_pass 转发
location / {
root /var/www/myapp;
index index.html; # 仅当请求 / 且 /var/www/myapp/ 下有 index.html 才生效
# 关键：fallback 到后端入口
try_files $uri $uri/ @backend;
}
location @backend {
proxy_pass http://127.0.0.1:3000; # 后端服务地址
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
这样：
- 访问
/，若/var/www/myapp/index.html存在 → 直接返回（200） - 若不存在 →
try_files触发@backend→ 请求被代理到后端，由后端决定返回什么（可渲染首页、重定向或返回 404）
静态首页 + 后端 API 统一 fallback（API 不可用时展示维护页）
适用于前端完全静态部署，但希望 API 故障时降级显示友好提示页：
# 主页静态服务
location / {
root /var/www/myapp;
index index.html;
try_files $uri $uri/ /index.html; # SPA 路由兜底
}
# API 请求单独处理，故障时 fallback 到本地维护页
location /api/ {
proxy_pass http://backend-api;
proxy_intercept_errors on; # 关键：让 Nginx 拦截上游错误
error_page 500 502 503 504 =200 /maintenance.html;
}
location = /maintenance.html {
root /var/www/myapp;
# 此处 index 不生效（因为是精确匹配文件），但需确保 maintenance.html 可访问
}
注意：error_page 500... =200 /maintenance.html 中的 /maintenance.html 是完整 URI，Nginx 会重新匹配 location，所以要保证该路径可被 root 定位到。
根路径动态 fallback：无静态首页时直连后端
有些项目根本没放 index.html，所有首页逻辑都在后端，此时 index 指令其实可以省略，完全交给 try_files 控制：
location / {
# 不配 index，也不依赖静态文件
try_files /dev/null @render;
# 所有请求（包括 /）都走这里
location @render {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
}
}
try_files /dev/null 是个 trick：/dev/null 永远不存在，所以每次都会 fallback 到 @render，实现“零静态依赖”的纯代理首页。
关键点总结：
-
index只响应以/结尾的真实目录请求，不处理/about这类路径，也不参与代理决策 - 真正的 fallback 控制权在
try_files和error_page手里 -
proxy_intercept_errors on是启用error_page拦截后端错误的前提 -
root必须指向含 fallback 文件（如maintenance.html）的物理目录，否则 404
不复杂但容易忽略。
