nginx location URL匹配规则

nginx rewrite语法

rewrite regex replacement [flag];

• regex: 是 PCRE 语法格式的正则表达式,用于匹配字符串。
• replacement: 是重写 URI 的改写规则。当改写规则以"http://""https://"或"$scheme"开头时，Nginx 重写该语句后将停止执行后续任务，并将改写后的 URI 跳转返回客户端。
• flag: 是执行该条重写指令后的操作控制符。操作控制符有如下 4 种：
  • break: 执行完当前重写规则跳转到新的 URI 后不再执行后续操作。不影响用户浏览器 URI 显示。
  • last: 执行完当前重写规则跳转到新的 URI 后继续执行后续操作。
  • redirect: 返回响应状态码 302 的临时重定向，返回内容是重定向 URI 的内容，但浏览器网址仍为请求时的 URI；
  • 返回响应状态码 301 的永久重定向，返回内容是重定向 URI 的内容，浏览器网址变为重定向的 URI。
    下面一个例子将本地63561代理到nginx代理80端口上，并且所有URL上添加/prefix前缀。

    location /prefix/ {
       rewrite  ^/prefix/(.*)$ /$1 break;
           proxy_pass  http://localhost:63561;          
        }

原来URL http://localhost:63561/aaa => localhost/prefix/aaa
虽然在nginx添加了如下配置，可不一定生效哦，这里就要讲下nginx URI 匹配规则

URI 匹配规则

location Modifier pattern { ... }

Modifier为location的修饰语，定义URI的匹配规则。pattern 为匹配项，可以是字符串或正则表达式

• 没有修饰符: 从指定模式开始，只支持字符串

location /abc{
root text;
}

下面规则都匹配:
http://localhost/abc/sdssd
http://localhost/abc?page=1&size=10
http://localhost/abcd
http://localhost/abc/

• =: 完全匹配 URI 中除访问参数以外的内容，Linux 系统下会区分大小写，Windows 系统下则不会。

location = /test {
root text;
}

下面都匹配
http://localhost/test
http://localhost/test?page=1&size=10
不匹配
http://localhost/test2ds
http://localhost/test/

• ~: 区分大小写的正则匹配

location ~ /abc$ {
root text;
}

下面都匹配
http://localhost/abc
http://localhost/abc?p=123
不匹配
http://localhost/abc/
http://localhost/ABC
http://localhost/abc/bbd

• ~*: 不区分大小的正则匹配

location ~* /abc$ {
root text;
}

下面都匹配
http://localhost/abc
http://localhsot/ABC
http://localhost/abc?p=123
不匹配
http://localhost/abc/
http://localhost/abc/bbd

• ^~: 作用类似没有修饰符的前缀匹配，nginx对一个请求精确前缀匹配成功后，停止继续搜索其他到匹配项，支持正则表达式。

location ^~ /abc {
root text;
}

• @: 只能内部访问的 location 区域，可以被其他内部跳转指令使用

location @images {
proxy_pass http://images;
}

匹配顺序

1. 先检测匹配项的内容为非正则表达式修饰语的 location，然后再检测匹配项的内容为正则表达式修饰语的 location。
2. 匹配项的内容为正则与非正则都匹配的 location，按照匹配项的内容为正则匹配的 location 执行。
3. 所有匹配项的内容均为非正则表达式的 location，按照匹配项的内容完全匹配的内容长短进行匹配，即匹配内容多的 location 被执行。
4. 所有匹配项的内容均为正则表达式的 location，按照书写的先后顺序进行匹配，匹配后就执行，不再做后续检测。

---

https://www.w3schools.cn/nginx/nginx_command_localhost.asp