Nginx location匹配模拟

  • 打赏支持
  • 分享链接
  • 反馈建议
只需要粘贴 location 行(含所在 server 块也行)。命中判定按 nginx 顺序:= 精确 → ^~ 或最长前缀拦住正则 → 正则按出现顺序 → 普通前缀最长优先。

功能说明

location 优先级是 nginx 配置事故的头号来源

nginx 的 location 不是「从上到下依次匹配」,而是分四步走:先找 = 精确匹配;再找普通前缀里最长的那条,如果它带 ^~ 就直接定案、不再看正则;否则按配置文件里的顺序逐条试正则,第一条命中即止;正则全不中时,回到刚才那条最长前缀。顺序理解错了,就会出现「明明写了规则却没生效」。

四类写法各自的角色

  • location = /path:一字不差才算命中,性能最好,适合首页与固定探活地址。
  • location ^~ /path/:前缀命中后跳过正则,静态资源目录用它防正则抢先。
  • location ~ 正则:区分大小写,~* 不区分。多条正则按书写顺序,所以 .php 这类规则要放在通配正则之前。
  • location /path:普通前缀,只做兜底;多条同时命中取最长的。

一个经典事故

有人为了缓存静态资源写了 location ~ \.(js|css)$,又写了 location /static/ 做特殊头。结果 /static/app.css 被正则抢走,/static/ 里的特殊配置永远不生效。把静态规则改成 ^~ /static/ 就能拦住正则——这类问题用本工具模拟一遍 URL 就能当场发现。

边界说明

本工具模拟 location 选择,不执行 rewrite、try_files 等指令;嵌套 location 只按顶层行解析。正则写法以 PCRE 为准,与 nginx 实际行为一致。

使用步骤

1. 在「location 配置」中粘贴要处理的内容。

2. 点击「模拟匹配」按钮执行。

3. 在结果区核对输出结果,需要留档时手动复制。

常见问题

Nginx location匹配模拟能做什么?

粘贴 nginx 的 location 配置块,输入任意 URL 即按 nginx 真实优先级模拟命中结果:精确 =、^~ 前缀、正则顺序、普通前缀最长匹配,支持多 URL 批量。全部处理在浏览器本地完成,无需注册、无需安装。

这个工具需要注册或付费吗?

不需要。打开页面就能用,没有账号体系、没有次数限制,也不调用任何付费接口。

处理过程在本地还是服务器?

全部在浏览器本地完成,输入内容不上传、不留存。断网状态下页面加载后仍可继续使用。

结果怎么保存或分享?

结果区支持复制,需要留档时用页面提供的下载入口保存到本地。页面不做云端存储,关掉浏览器后需重新处理。

你可能还想问

这个工具需要联网才能用吗?

第一次打开页面需要联网加载,之后的计算与处理都在本地完成,断网也能继续操作。数据不经过服务器,也不受网络波动影响。

处理结果怎么保存或分享?

结果区支持一键复制,也可按页面提供的下载入口保存到本地;页面不做云端存储,关掉浏览器后需要重新处理。