19、nginx中location语法

1. 概述

• 在实际应用中，权限控制的需求更加复杂。例如，对于网站下的img目录允许所有用户访问,但对于网站下的admin目录则仅允许管理员身份的用户访问。此时,仅靠deny和allow这两个权限指令不能满足用户的需求,还需要使用location块来完成相关需求的匹配。

2.location语法

location [=|~| ~* | ^~] URI { .... } #语法类型1
location @name { .... } 			 #语法类型2

• 在上述语法中=、~、~*、^~、@都是location用于实现访问控制的前缀，且在使用时只能选择一种，当然也可以不设置前缀。

2.1 精准匹配

• 所谓精准匹配指的就是用户访问的URI与指定的URI完全一致的情况,才会执行其后的指令块,示例配置如下。

server {
    listen 80;
    server_name localhost;
    root html;
    index index.html index.htm;
    
    location=/js {
        allow 192.168.78.128;
    }
    
    location =/admin/auth{
        allow 192.168.78.200;
    }
    
    deny all;
}

符合匹配规则,网页显示404 Not Found,不符合时显示403 Forbidden。

2.2 正则匹配

• Nginx配置文件中,多个正则 location之间按照正则location 在配置文件中的书写顺序进行匹配,且只要匹配成功就不会继续匹配后面定义的正则location。

location ~\.html$ {
    allow all;
}

location ~^/aaa/.*\.html${
    deny all;
}

当location中的URI与用户请求中以.html为结尾的文件匹配上时,正则location停止了继续匹配,因此显示结果都为404 Not Found

调换上述两个location代码块的编写顺序，再次访问 http://192.168.78.3/test.html结果依然为404 Not Found,而访问 http://192.168.78.3/aaa/test.html的结果为403 Forbidden.

正则location的编写顺序不同,则结果不同,且只有前面定义的正则location匹配不成功的情况下,才会继续匹配后面的正则location。

2.3 最大前缀匹配

• 由于location可以同时定义多个,当一个配置文件中同时出现多个location时,普通 location 之间遵循最大前缀匹配原则。通俗地讲就是，匹配度最高的location 将会执行。

location /ng.test {
    allow all;
}

location /ng.test/log {
    deny all;
}

• 当最大前缀location与正则location同时存在时,如果正则 location 匹配成功,则不会执行最大前缀location。

  location / {
      deny all;
  }
  
  location ~\.html$ {
      allow all;
  }
  

• location / {} 与location = / {}的区别
  • location / {} 遵守普通 location的最大前缀匹配，由于任何 URI 都必然以/根开头，所以对于一个URI，若配置文件中有更合适的匹配则会将其替代，否则返回location / {} 匹配到的结果，它相当于站点默认配置。
  • location = / {} 遵守的是精准匹配，也就是只能匹配该站点根目录，同时会禁止继续搜索正则 location ,效率比 location/ {} 要高。因此,若在开发中能确定精准匹配的情况,可以采用location = / {} 的方式,提升匹配效率。

2.4 禁用正则匹配

• 利用=精准匹配或^~非正则匹配可以在正则匹配之前优先匹配，从而禁止执行原有的正则匹配。下面在server块中添加以下几条location匹配规则，具体如下。

location =/aaa/test.html {
	allow all;
}

location ^~/ {   
	deny all;
}

location ~\.html${
	allow all;
}

• =用于精准匹配网站根目录下的/aaa/test.html
• ^~用于非正则匹配网站根目录下的文件
• ~用于正则匹配网站根目录下以.html为结尾的文件

在使用了=或^~前缀时,普通 location 匹配后将不再执行正则 location的匹配。

前缀=和^~虽然都能阻止继续搜索正则 location ，不同的地方是它们遵循的规则不同，^~依然遵循最大前缀匹配规则，而=则严格按照精准匹配执行。因此,当多种类型的 location 匹配同时出现时，最终执行结果为=匹配优先于^~匹配，^~匹配优先于正则匹配，正则匹配优先于普通的最大前缀匹配。只要优先的location匹配成功，就不会执行其他的 location。