Nginx 中 location 匹配中 @ 符号命名 location 的用途-Nginx-PHP中文网

命名 location 是以 @ 开头的内部跳转目标，仅供 nginx 内部指令（如 try_files、error_page、rewrite）调用，不响应外部请求，不参与 uri 匹配，且内部跳转时保持原始 uri 不变。

nginx 中 location 匹配中 @ 符号命名 location 的用途

@ 符号定义的命名 location 是内部专用的跳转目标，不响应外部请求，只供 Nginx 内部指令（如 try_files、error_page、rewrite）触发跳转使用。

核心用途：实现内部重定向

命名 location 不是给用户直接访问的，它像一个“隐藏函数”，只能被 Nginx 自己调用。典型场景包括：

当静态文件不存在时，用 try_files $uri $uri/ @fallback 跳转到前端路由入口（如 Vue/React 的 /index.html）
自定义错误页时，用 error_page 404 @notfound 把 404 请求交给命名 location 处理
在 rewrite 中配合 last 或 break 实现内部路径改写后继续匹配

@ 与普通 location 的关键区别

命名 location 有三个明显特征：

Nginx Hosting

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

下载

以 @ 开头，比如 location @app，客户端无法通过 URL 直接访问 /@app 或类似路径
不参与常规的 URI 匹配流程，不会被 location /xxx 这类规则竞争或覆盖
内部跳转时不改变原始请求 URI，只是切换处理逻辑，对浏览器完全透明

常见配置示例

一个典型的单页应用（SPA）配置：

location / {
    try_files $uri $uri/ @router;
}
location @router {
    rewrite ^(.*)$ /index.html last;
}

这里：
– 用户请求 /user/profile，Nginx 先查静态文件，找不到就跳进 @router
– @router 内部把路径重写为 /index.html，再重新进入 location 匹配流程
– 最终由 root 和 index 指令返回 index.html，前端路由接管后续渲染