root 适配 try_files 的路径检查逻辑，alias 必须用 $request_filename；禁止混用 root 和 alias；spa 回退需带 location 前缀。

root 和 alias 都能映射静态资源路径，但它们与 try_files 的协作逻辑完全不同。直接混用容易导致 404、路径错乱甚至内部重定向循环。关键不是“怎么结合”，而是“在哪种场景下该用哪个，并配对正确的 try_files 写法”。

用 root + try_files 是最稳妥的通用方案

root 拼接 URI 的方式天然适配 try_files 的路径检查逻辑。Nginx 会把 $uri 自动拼到 root 路径后，再判断文件是否存在。

• 配置示例：

location / {
  root /opt/app/dist;
  try_files $uri $uri/ /index.html;
}

• $uri → 检查 /opt/app/dist/xxx（如 /api.json）
• $uri/ → 检查 /opt/app/dist/xxx/ 目录是否存在（再找 index.html）
• /index.html → 回退到根目录下的 index.html，由前端路由接管

用 alias 时 try_files 必须改用 $request_filename

alias 不参与 try_files 的路径拼接，$uri 仍是原始请求路径（比如 /assets/js/app.js），而 root 并未设置或不匹配 alias 目标目录，直接写 $uri 就会查错位置。唯一可靠的方式是让 try_files 检查 Nginx 已解析出的绝对路径。

Nginx Hosting

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

下载

• 正确写法：

location /assets/ {
  alias /var/www/assets/;
  try_files $request_filename =404;
}

• $request_filename 是 Nginx 内部变量，已根据 alias 映射为真实磁盘路径（如 /var/www/assets/js/app.js）
• 不能写 $uri 或 /$uri，否则会去 root 下找，大概率 404
• alias 块末尾必须带 /，且 location 也建议以 / 结尾，避免路径截断

不要在同一个 location 里混用 root 和 alias

两者作用机制冲突：root 是“追加”，alias 是“替换”。Nginx 不允许在同个 location 中同时定义，即使语法不报错，行为也不可预测。

• 错误示范（禁止）：

location /static/ {
  root /data/www;
  alias /data/assets/;
  try_files $uri =404;
}

• 这种配置会触发 nginx 启动失败或运行时异常
• 若需多路径映射，应拆成多个独立 location 块

SPA 路由回退需注意 fallback 路径前缀

当使用 alias 映射子路径（如 /admin/ → /opt/app/admin/），又希望 404 时回退到该子应用的 index.html，fallback 路径必须带 location 前缀。

• 正确写法：

location /admin/ {
  alias /opt/app/admin/;
  try_files $request_filename /admin/index.html;
}

• 这里 /admin/index.html 是相对于 server 根或 root 的路径，不是 alias 目录
• 如果没设 root，需确保该路径在文件系统中真实存在，或配合另一个 root 块覆盖
• 不写前缀（如 /index.html）会导致前端路由丢失上下文，Vue Router 或 React Router history 模式失效