功能说明
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 批量。全部处理在浏览器本地完成,无需注册、无需安装。
这个工具需要注册或付费吗?
不需要。打开页面就能用,没有账号体系、没有次数限制,也不调用任何付费接口。
处理过程在本地还是服务器?
全部在浏览器本地完成,输入内容不上传、不留存。断网状态下页面加载后仍可继续使用。
结果怎么保存或分享?
结果区支持复制,需要留档时用页面提供的下载入口保存到本地。页面不做云端存储,关掉浏览器后需重新处理。
你可能还想问
这个工具需要联网才能用吗?
第一次打开页面需要联网加载,之后的计算与处理都在本地完成,断网也能继续操作。数据不经过服务器,也不受网络波动影响。
处理结果怎么保存或分享?
结果区支持一键复制,也可按页面提供的下载入口保存到本地;页面不做云端存储,关掉浏览器后需要重新处理。
速查在线工具箱