【nginx】nginx的location路径及优先级

nginx是通过server块中location的配置用来匹配不同url访问d的。

location配置匹配方式主要包括三种:精准匹配、普通匹配和正则匹配

location [ = | ~ | ~* | ^~ ] uri { ... }
location @name { ... }

常见的location路径映射路径有以下几种:

  • = 进行普通字符精确匹配。也就是完全匹配

  • ^~ 前缀匹配。如果匹配成功,则不再匹配其他location

  • ~ 表示执行一个正则匹配,区分大小写

  • ~* 表示执行一个正则匹配,不区分大小写

  • /xxx/ 常规字符串路径匹配

  • / 通用匹配,任何请求都会匹配到

location优先级

当一个路径匹配多个location时究竟哪个location能匹配到时有优先级顺序的,而优先级的顺序于location值的表达式类型有关,和在配置文件中的先后顺序无关。
相同类型的表达式,字符串长的会优先匹配。

以下是按优先级排列说明:

  • 等号类型(=)的优先级最高。一旦匹配成功,则不再查找其他匹配项,停止搜索。

  • ^~类型表达式,不属于正则表达式。一旦匹配成功,则不再查找其他匹配项,停止搜索。

  • 正则表达式类型(~ ~*)的优先级次之。如果有多个location的正则能匹配的话,则使用正则表达式最长的那个。

  • 常规字符串匹配类型。按前缀匹配。

  • / 通用匹配,如果没有匹配到,就匹配通用的

优先级搜索问题:不同类型的location映射决定是否继续向下搜索。

等号类型、^类型:一旦匹配上就停止搜索了,不会再匹配其他location了正则表达式类型( ~*),常规字符串匹配类型/xxx/:匹配到之后,还会继续搜索其他其它location,直到找到优先级最高的,或者找到第一种情况而停止搜索。

location优先级从高到底:

location =)>(location 完整路径)>(location ^~ 路径)>(location ,* 正则顺序)>(location 部分起始路径)>(/)

注意:location的优先级与location配置的位置无关。

location = / {
    # 精确匹配/,主机名后面不能带任何字符串 /
    [ configuration A ]
}
location / {
    # 匹配所有以 / 开头的请求。
    # 但是如果有更长的同类型的表达式,则选择更长的表达式。
    # 如果有正则表达式可以匹配,则优先匹配正则表达式。
    [ configuration B ]
}
location /documents/ {
    # 匹配所有以 /documents/ 开头的请求,匹配符合以后,还要继续往下搜索。
    # 但是如果有更长的同类型的表达式,则选择更长的表达式。
    # 如果有正则表达式可以匹配,则优先匹配正则表达式。
    [ configuration C ]
}
location ^~ /images/ {
    # 匹配所有以 /images/ 开头的表达式,如果匹配成功,则停止匹配查找,停止搜索。
    # 所以,即便有符合的正则表达式location,也不会被使用
    [ configuration D ]
}

location ~* \.(gif|jpg|jpeg)$ {
    # 匹配所有以gif jpg jpeg结尾的请求。
    # 但是 以/images/开头的请求,将使用Configuration D,D具有更高的优先级
    [ configuration E ]
}

location /images/ {
    # 字符匹配到/images/,还会继续往下搜索
    [ configuration F ]
}


location = /test.htm {
    root   /usr/local/var/www/htm;
    index  index.htm;
}

nginx location 配置如下:

location  =/ {
    proxy_pass  https://www.example.com
}

location  ^~ /test  {
    proxy_pass  192.168.1.101:12345
}

对 /test 接口访问转发给谁?

对于 /test 接口的访问将会被转发给 192.168.1.101:12345。

nginx使用location指令来匹配请求的URL路径,并根据匹配规则来执行相应的操作。在这个配置中:

  1. location =/ 表示精确匹配根路径 /,即只匹配访问根路径的请求。当请求根路径时,会将请求代理到 http://www.example.com

  2. location ^~ /test 表示前缀匹配 /test,即匹配以 /test 开头的所有请求。当请求路径以 /test 开头时,会将请求代理到 192.168.1.101:12345

因此,对于 /test 接口的访问将会被转发给 192.168.1.101:12345

在nginx的location配置中,=和没有= /之间的区别在于匹配路径的方式和优先级。

具体来说:

  1. location =/:表示精确匹配根路径 /。只有当请求路径为根路径 / 时,才会匹配到该location块。这种精确匹配优先级高,会覆盖其他相同路径前缀的location配置。

  2. location /:表示前缀匹配根路径 /,即匹配所有请求路径(包括根路径)。这种匹配方式会匹配所有请求路径,而不仅仅是根路径。通常用于处理多个路径的情况。

因此,加不加 / 的区别在于精确匹配和前缀匹配的不同。
如果只需要匹配根路径,则使用location =/;如果需要匹配所有请求路径,则使用location /

参考

Nginx的location路径及优先级
https://www.cnblogs.com/huif/p/16469947.html

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容