nginx 的 index 指令仅用于本地静态文件查找，不能代理请求至 upstream；需用 location / { proxy_pass ... } 实现全路径转发，或 try_files 配合 proxy_pass 处理混合场景。
Nginx 的 index 指令本身不能把请求交给 upstream 处理。它只负责在访问目录（如 / 或 /admin/）时，自动查找并返回本地文件（如 index.html），不支持跳转、代理或转发逻辑。
如果你希望「用户访问根路径 / 时，不返回静态首页，而是直接交给上游应用服务器（如 Tomcat、Node.js）处理」，那就不该用 index，而该用 proxy_pass + try_files 或直接 location / 转发。
✅ 正确做法：用 proxy_pass 替代 index
upstream backend {
server 127.0.0.1:8080;
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
# 其他常用代理头...
}
}
这样，所有 / 及子路径请求（包括裸域名 example.com）都会被完整转发给 upstream，由后端决定返回什么——比如 Spring Boot 返回欢迎页、React Router 处理 SPA 路由等。
❌ 常见误解与错误尝试
index index.php;+proxy_pass混用？
不行。index是文件查找指令，proxy_pass是代理指令，二者逻辑冲突。Nginx 不会先找index.php再转发；它要么查文件，要么转发，不能“查不到就转发”。-
try_files $uri @backend;配合index？
可以，但index在这里仍是冗余的。真正起作用的是try_files：location / { root /var/www/html; try_files $uri $uri/ @backend; # 先找静态文件，找不到就走 @backend } location @backend { proxy_pass http://backend; }注意：这种写法适合「静态+动态混合」场景（如前端静态资源 + 后端 API），但如果你明确不要任何静态首页，全部交由上游处理，就无需
root和try_files，直接proxy_pass更干净。
⚠️ 特别注意：SPA 应用的常见陷阱
比如 Vue/React 单页应用部署时，你可能想：
- 所有路径都由前端路由接管（如
/user/123） - 但 Nginx 默认对
/user/123这种路径不带尾斜杠，又没对应物理文件，会返回 404
此时正确解法不是靠 index，而是：
location / {
root /var/www/dist;
try_files $uri $uri/ /index.html; # 所有未命中文件的请求，都 fallback 到 index.html
}
这和「交给 upstream」是两回事：前者是前端路由兜底，后者是后端逻辑兜底。选哪个，取决于你的架构设计。
总结关键点
-
index只用于服务本地静态文件，不参与代理逻辑 - 要交由 upstream 处理，默认路径就用
location / { proxy_pass ... } - 混合场景（静态资源 + 动态接口）用
try_files+proxy_pass分流，而非index -
index放错位置（如 http 块）、root 路径多斜杠、文件权限不对，都会导致首页异常，但这些和 upstream 无关
不复杂，但方向不能反。
