Nginx Location匹配规则

目录

• x
• Location 语法
• 匹配规则示例
• 实际常用规则
• Location解析过程(顺序)
• alias与root的区别
• 参考

Top~~

Location 语法

语法规则：

location [=|~|~*|^~] /uri/ {… }

首先匹配 =，其次匹配^~,其次是按文件中顺序的正则匹配，最后是交给 /通用匹配。当有匹配成功时候，停止匹配，按当前匹配规则处理请求。

符号	含义
=	= 开头表示精确匹配
~	~ 开头表示区分大小写的正则匹配
~*	~* 开头表示不区分大小写的正则匹配
!~	区分大小写不匹配
!~*	不区分大小写不匹配
^~	^~ 开头表示uri以某个常规字符串开头，理解为匹配 url路径即可。nginx不对url做编码，因此请求为/static/20%/aa，可以被规则^~ /static/ /aa匹配到（注意是空格）。

Top~~

匹配规则示例

      
      location = / {
          #规则A
      }
      
      location = /login {
          #规则B
      }
      
      location ^~ /static/ {
          #规则C
      }
      
      location ~ \.(gif|jpg|png|js|css)$ {
          #规则D
      }
      
      location ~* \.(gif|jpg|png|js|css)$ {
          #规则E
      }
      
      location !~ \.xhtml$ {
          #规则F
      }
      
      location !~* \.xhtml$ {
          #规则G
      }
      
      location / { # 匹配任意请求
          #规则H
      }

• 访问根目录/，比如 http://localhost/ 将匹配规则A
• 访问 http://localhost/login 将匹配规则B，http://localhost/register则匹配规则H
• 访问 http://localhost/static/a.html 将匹配规则C
• 访问 http://localhost/a.gif,http://localhost/b.jpg 将匹配规则D和规则E，但是规则D顺序优先，规则E不起作用，而 http://localhost/static/c.png 则优先匹配到规则C
• 访问 http://localhost/a.PNG 则匹配规则E，而不会匹配规则D，因为规则E不区分大小写。
• 访问 http://localhost/a.xhtml 不会匹配规则F和规则G
• http://localhost/a.XHTML不会匹配规则G，因为不区分大小写。规则F，规则G属于排除法，符合匹配规则但是不会匹配到
• 访问 http://localhost/category/id/1111 则最终匹配到规则H，因为以上规则都不匹配

Top~~

实际常用规则

• 第一个必选规则是直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理。
  这里是直接转发给后端应用服务器了，也可以是一个静态首页

    location = / {
       proxy_passhttp://tomcat:8080/index
    }

• 第二个必选规则是处理静态文件请求，这是nginx作为http服务器的强项。有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用:

    # 目录匹配
    location ^~ /static/ {
       # 请求/static/a.txt 将被映射到实际目录文件:/webroot/res/static/a.txt
       root /webroot/res/;
    }
    
    # 后缀匹配
    location ~* \.(gif|jpg|jpeg|png|css|js|ico)${
       root /webroot/res/;
    }

• 第三个规则就是通用规则，用来转发动态请求到后端应用服务器。一般非静态文件请求就默认是动态请求：

    location / {
       proxy_pass http://tomcat:8080/
    }

Top~~

Location解析过程(顺序)

（1）先判断精准命中，如果命中，立即返回结果并结束解析过程。

（2）判断普通命中，如果有多个命中，“记录”下来“最长”的命中结果（记录但不结束，最长的为准）。

（3）继续判断正则表达式的解析结果，按配置里的正则表达式顺序为准，由上至下开始匹配，一旦匹配成功1个，立即返回结果，并结束解析过程。

（4）普通命中顺序无所谓，是因为按命中的长短来确定。正则命中，顺序有所谓，因为是从前入往后命中的。

Top~~

alias与root的区别

• root 实际访问文件路径会拼接URL中的路径
• alias 实际访问文件路径不会拼接URL中的路径

示例如下：

location ^~ /sta/ {  
   alias /usr/local/nginx/html/static/;  
}

请求：http://test.com/sta/sta1.html,实际访问：/usr/local/nginx/html/static/sta1.html 文件。

location ^~ /tea/ {  
   root /usr/local/nginx/html/;  
}

请求：http://test.com/tea/tea1.html,实际访问：/usr/local/nginx/html/tea/tea1.html 文件。

Top~~

参考

• https://www.cnblogs.com/duhuo/p/8323812.html
• https://blog.csdn.net/zwl18210851801/article/details/81699977