vlambda博客
学习文章列表

Nginx——location匹配与在配置中的优先级

  1. location表达式类型

location ^~ /api/v7/ { proxy_next_upstream http_404 http_500 http_502 http_503 http_504 error timeout invalid_header; proxy_set_header Connection "keep-alive"; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://www.hello.world; proxy_set_header tenant-id $tenantId; }

 

上面是一个location匹配的例子,实际上,location匹配表达式还有多种:


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

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

^~ 表示普通字符匹配。使用前缀匹配。如果匹配成功,则不再匹配其他location。

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

@ "@" 定义一个命名的 location,使用在内部定向时,例如 error_page, try_files

/ 通用匹配, 如果没有其它匹配,任何请求都会匹配到


2. location优先级说明

在nginx的location和配置中location的顺序没有太大关系。与location表达式的类型有关。相同类型的表达式,字符串长的会优先匹配。


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

第一优先级:等号类型(=)的优先级最高。一旦匹配成功,则不再查找其他匹配项。第二优先级:^~类型表达式。一旦匹配成功,则不再查找其他匹配项。第三优先级:正则表达式类型(~ ~*)的优先级次之。如果有多个location的正则           能匹配的话,则使用正则表达式最长的那个。第四优先级:常规字符串匹配类型。按前缀匹配。



#顺序不等于优先级

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

3. location优先级示例

配置项如下:


location = / {  # 精确匹配 / ,主机名后面不能带任何字符串  [ configuration A ]}
location / {  # 因为所有的地址都以 / 开头,所以这条规则将匹配到所有请求  # 但是正则和最长字符串会优先匹配  [ configuration B ]}
location /documents/ {  # 匹配任何以 /documents/ 开头的地址,匹配符合以后,还要继续往下搜索  # 只有后面的正则表达式没有匹配到时,这一条才会采用这一条  [ configuration C ]}
location ~ /documents/Abc {  # 匹配任何以 /documents/ 开头的地址,匹配符合以后,还要继续往下搜索  # 只有后面的正则表达式没有匹配到时,这一条才会采用这一条  [ configuration CC ]}
location ^~ /images/ {  # 匹配任何以 /images/ 开头的地址,匹配符合以后,停止往下搜索正则,采用这一条。  [ configuration D ]}
location ~* \.(gif|jpg|jpeg)$ {  # 匹配所有以 gif,jpg或jpeg 结尾的请求  # 然而,所有请求 /images/ 下的图片会被 config D 处理,因为 ^~ 到达不了这一条正则  [ configuration E ]}
location /images/ {  # 字符匹配到 /images/,继续往下,会发现 ^~ 存在  [ configuration F ]}
location /images/abc {  # 最长字符匹配到 /images/abc,继续往下,会发现 ^~ 存在  # F与G的放置顺序是没有关系的  [ configuration G ]}
location ~ /images/abc/ {  # 只有去掉 config D 才有效:先最长匹配 config G 开头的地址,继续往下搜索,匹配到这一条正则,采用  [ configuration H ]}


请求匹配示例


#精确完全匹配,即使/index.html也匹配不了/ -> config A #匹配B以后,往下没有任何匹配,采用B/downloads/download.html -> config B # 匹配到F,往下匹配到D,停止往下 /images/1.gif -> configuration D #最长匹配到G,往下匹配D,停止往下 可以看到 任何以/images/开头的都会匹配到D#并停止,FG写在这里是没有任何意义的,H是永远轮不到的,这里只是为了说明匹配顺序/images/abc/def -> config D #匹配到C,往下没有任何匹配,采用C/documents/document.html -> config C #匹配到C,往下正则匹配到E /documents/1.jpg -> configuration E  #最长匹配到C,往下正则顺序匹配到CC,不会往下到E/documents/Abc.jpg -> config CC