详解Nginx location 匹配规则

语法规则

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

前缀匹配时，Nginx 不对 url 做编码，因此请求为 /static/20%/aa ，可以被规则 ^~ /static/ /aa 匹配到（注意是空格）

匹配成功后，url的域名+port 替换为root指定的目录，

以请求https://www.cnblogs.com:8080/benwu/articles/2283622.html为例，
1: location配置如下

location /benwu {
　　root /home/files/;
}

匹配到/benwu，url中的域名+port替换为root指定的目录，即将请求地址中的https://www.cnblogs.com:8080被替换为了/home/files/，
所以在服务器端实际访问的路径是：/home/files/benwu/articles/2283622.html

2: location配置如下

location /benwu/articles {
　　root /home/files/;
}

匹配到 /benwu/articles，url的域名+port替换为root指定的目录，即url中的https://www.cnblogs.com:8080被替换为了/home/files，
所以实际访问的路径仍然是：/home/files/benwu/articles/2283622.html。
root在替换时不会替换匹配到的路径。

多个 location 配置的情况下匹配顺序为

首先精确匹配 = ，如果匹配成功，则停止其他匹配
其次前缀匹配 ^~
其次是按文件中顺序的正则匹配
然后匹配不带任何修饰的前缀匹配。
最后是交给 / 通用匹配
当有匹配成功时候，停止匹配，按当前匹配规则处理请

location匹配顺序
"="前缀指令匹配，如果匹配成功，则停止其他匹配
普通字符串指令匹配，顺序是从长到短，匹配成功的location如果使用^~，则停止其他匹配（正则匹配）
正则表达式指令匹配，按照配置文件里的顺序，成功就停止其他匹配
如果第三步中有匹配成功，则使用该结果，否则使用第二步结果
最后是交给 / 通用匹配

注意点
匹配的顺序是先匹配普通字符串，然后再匹配正则表达式。另外普通字符串匹配顺序是根据配置中字符长度从长到短，也就是说使用普通字符串配置的location顺序是无关紧要的，反正最后nginx会根据配置的长短来进行匹配，但是需要注意的是正则表达式按照配置文件里的顺序测试。找到第一个比配的正则表达式将停止搜索。

一般情况下，匹配成功了普通字符串location后还会进行正则表达式location匹配。有两种方法改变这种行为，其一就是使用“=”前缀，这时执行的是严格匹配，并且匹配成功后立即停止其他匹配，同时处理这个请求；另外一种就是使用“^~”前缀，如果把这个前缀用于一个常规字符串那么告诉nginx 如果路径匹配那么不测试正则表达式。

匹配模式及顺序

= 　　 #用于标准uri前，需要请求字串与uri完全匹配，如果匹配成功就停止向下匹配并立即处理请求。
~ 　　 #区分大小写
~* 　　 #不区分大写
!~ 　　 #区分大小写不匹配
!~* 　　#不区分大小写不匹配
^ 　　 #匹配正则开头
$ 　　 #匹配正则结尾
\ 　　 #转义字符。可以转. * ?等
* 　　 #代表任意长度的任意字符

location = /uri　　　　 #开头表示精确匹配，只有完全匹配上才能生效。
location ^~ /uri　　　　#开头对URL路径进行前缀匹配，并且在正则之前。
location ~ pattern #开头表示区分大小写的正则匹配。
location ~* pattern #开头表示不区分大小写的正则匹配。
location /uri 　　 #不带任何修饰符，也表示前缀匹配，但是在正则匹配之后。
location / #通用匹配，任何未匹配到其它location的请求都会匹配到，相当于switch中的default。

#不区分大小写匹配任何以gif、jpg、jpeg结尾的请求
location ~* .(gif|jpg|jpeg)$ ｛  
     
｝

#区分大小写匹配以.txt结尾的请求，并设置此location的路径是/usr/local/nginx/html/。也就是以.txt结尾的请求将访问/usr/local/nginx/html/ 路径下的txt文件
location ~ ^.+\.txt$ {
    root /usr/local/nginx/html/;
}

# ^~ 以 /admin/ 开头的请求，都会匹配上
location ^~ /admin/ {
   root /xvdb/mobai/
}

此时 /xvdb/mobai/目录中必须要有 admin 文件夹

#匹配成功: http://www.cnblogs.com/admin/index.jsp
#匹配成功: http://www.cnblogs.com/admin/login.jsp

#忽略大小写,包含/Images/
location ~* /Images/ {
}
#匹配成功: http://www.cnblogs.com/test/Images/     
#匹配成功: http://www.cnblogs.com/images/    


#不加任何规则则时，默认是大小写敏感，前缀匹配，相当于加了“^”与“~”
location /index/ {
}
#匹配成功: http://www.cnblogs.com/index
#匹配成功: http://www.cnblogs.com/index/index.html
#匹配失败: http://www.cnblogs.com/test/index
#匹配失败: http://www.cnblogs.com/Index

 
#精确匹配, 只匹配http://www.cnblogs.com
location = / {
}
#匹配成功: http://www.cnblogs.com 
#匹配失败: http://www.cnblogs.com/index

# 匹配到所有url
location / {

}

例子，有如下匹配规则：

location = / {
  echo "规则A";
}
location = /login {
  echo "规则B";
}
location^~ /static/ {
  echo "规则C";
}
location^~ /static/files {
  echo "规则X";
}
location ~ \.(gif|jpg|png|js|css)$ {
  echo "规则D";
}
location ~* \.png$ {
  echo "规则E";
}
location /img {
  echo "规则Y";
}
location / {
  echo "规则F";
}

那么产生的效果如下：

访问根目录 / ，比如 http://localhost/ 将匹配规则A
访问 http://localhost/login 将匹配规则B ， http://localhost/register 则匹配规则F
访问 http://localhost/static/a.html 将匹配规则C
访问 http://localhost/static/files/a.exe 将匹配规则X ，虽然规则C 也能匹配到，但因为最大匹配原则，最终选中了规则X 。你可以测试下，去掉规则 X ，则当前 URL 会匹配上规则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/img/a.gif 会匹配上规则D ,虽然规则Y 也可以匹配上，但是因为正则匹配优先，而忽略了规则Y 。
访问 http://localhost/img/a.tiff 会匹配上规则Y 。
访问 http://localhost/category/id/1111 则最终匹配到规则 F ，因为以上规则都不匹配，这个时候应该是 Nginx 转发请求给后端应用服务器，比如 FastCGI（php），tomcat（jsp），Nginx 作为反向代理服务器存在。

详解nginx的root与alias

以请求https://www.cnblogs.com:8080/benwu/articles/2283622.html为例，
测试1: location配置如下

location /benwu {
　　root /home/files/;
}

匹配到/benwu，将url中的前缀(ip/域名)+port+匹配到的路径替换为alias指定的目录，
即url中的https://www.cnblogs.com:8080/benwu 被替换为了/home/files/，所以实际访问的路径为/home/files/articles/2283622.html

测试2: location配置如下

location /benwu/articles {
　　root /home/files/;
}

匹配到/home/files，将url中的前缀(ip/域名)+port+匹配到的路径替换为alias指定的目录，
即url中的https://www.cnblogs.com:8080/benwu 被替换为了/home/files/，所以实际访问的路径为/home/files/2283622.html
alias在替换时会替换匹配到的路径。

alias其余特性，最左匹配、index、location解析url工作流程、末尾’/'与root一致。

所以实际使用中，笔者觉得至少有三个匹配规则定义，如下：

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

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

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

location ^~ /static/ {
  root /webroot/static/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
  root /webroot/res/;
}

# 第三个规则就是通用规则，用来转发动态请求到后端应用服务器
# 非静态文件请求就默认是动态请求，自己根据实际把握
# 毕竟目前的一些框架的流行，带.php、.jsp后缀的情况很少了

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

rewrite 语法

last – 基本上都用这个 Flag
break – 中止 Rewirte，不再继续匹配
redirect – 返回临时重定向的 HTTP 状态 302
permanent – 返回永久重定向的 HTTP 状态 301

1、下面是可以用来判断的表达式：

-f 和 !-f 　　用来判断是否存在文件
-d 和 !-d 　　用来判断是否存在目录
-e 和 !-e 　　用来判断是否存在文件或目录
-x 和 !-x 　　用来判断文件是否可执行

2、下面是可以用作判断的全局变量

例：

http://localhost:88/test1/test2/test.php?k=v
$host：localhost
$server_port：88
$request_uri：/test1/test2/test.php?k=v
$document_uri：/test1/test2/test.php
$document_root：D:\nginx/html
$request_filename：D:\nginx/html/test1/test2/test.php

redirect 语法

server {
  listen 80;
  server_name start.igrow.cn;
  index index.html index.php;
  root html;
  if ($http_host !~ "^star\.igrow\.cn$") {
    rewrite ^(.*) http://star.igrow.cn$1 redirect;
  }
}

防盗链

location ~* \.(gif|jpg|swf)$ {
  valid_referers none blocked start.igrow.cn sta.igrow.cn;
  if ($invalid_referer) {
    rewrite ^/ http://$host/logo.png;
  }
}

根据文件类型设置过期时间

location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ {
  if (-f $request_filename) {
    expires 1h;
    break;
  }
}

参考文档：http://www.zzvips.com/article/33760.html

posted @ 2022-01-25 15:50 南极山阅读(4598) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

南极山

努力学习新技术....

详解Nginx location 匹配规则

详解nginx的root与alias

公告