Nginx-基础-基础配置（Server,Location语法,匹配优先级，rewrite）

developer@liyong

已于 2024-05-13 16:39:30 修改

阅读量873

点赞数 1

分类专栏： Nginx 学习笔记文章标签： nginx 运维 location 配置 rewrite

于 2023-11-13 19:46:05 首次发布

本文链接：https://blog.csdn.net/qq_43259860/article/details/134282224

版权

学习笔记同时被 2 个专栏收录

16 篇文章 0 订阅

订阅专栏

Nginx

9 篇文章 0 订阅

订阅专栏

请求定位(Server模块)

nginx有两层指令来匹配请求 URL ：

第一个层次是 server 指令，它通过域名、ip和端口来做第一层级匹配，当找到匹配的 server 后就进入此 server 的 location 匹配。
第二个层次是location指令，它通过请求uri来做第二层匹配。
1 示范例子

server {
    listen       81; # 监听的端口
    server_name  localhost; # 域名或ip
    
    location / {  # 访问路径配置
        return 400;
    }
    location /xx/xx {  # 访问路径配置
        return 402;
    }

}
server {
    listen       82; # 监听的端口
    server_name  localhost; # 域名或ip
    
    location / {  # 访问路径配置
        return 401;
    }  
}

注解：每一个端口为一个Server，用于做不同的事情。

补充知识点：
域名访问
1） windows
C:\Windows\System32\drivers\etc\hosts 在这个目录下增加域名与ip的映射
2） linux
/etc/hosts 在这个目录下增加域名和ip的映射关系

2 基于域名的例子

 server {
    listen 82;
    server_name www.liyong.f.com;
    location / {
        return 401;   
    }
}
server {
    listen 83;
    server_name www.liyong.s.com;
    location / { 
        return 402;
    }
}

然后再服务客户端配置域名ip映射，windows和linux配置文件不同参考上面的路径。
访问：http://www.liyong.s.com:83/ http://www.liyong.f.com:82/

请求定位（Location ）

每个server块中可以包含多个location块。location块的主要作用是，基于nginx服务器接收到的客户端发送过来的请求uri（例如， server_name/uri-string），对除虚拟主机名称（也可以是IP别名）之外的字符串（前例中“/uri-string”部分）进行匹配，对特定的请求进行处理。
地址定向、数据缓存和应答控制等功能都是在这部分实现。许多第三方模块的配置也是在location块中提供功能。

location 语法

location [ = | ~ | ~* | ^~ ] /uri { #配置location可以配置的属性 } #[] 里面的意思是多种写法 | 表示或 不要错误的理解为location的配置还有[] 里面配一串之类的 实际配置 location =,  location ^~ 是这样的

location匹配参数解释

参数	匹配方式	匹配模式	说明	注意事项
`=`	精准匹配	普通字符串匹配	用于`标准uri`前，要求请求字符串与uri精准匹配，成功则立即处理，nginx停止搜索其他匹配。
`~`	正则匹配	正则表达式匹配	用于`正则uri`，表示uri包含正则表达式，并且区分大小写。	如果uri包含正则表达式，就必须要使用“～”或者“～*”标识。
`~*`		正则表达式匹配	用于`正则uri`，表示uri包含正则表达式，并且不区分大小写。
`^~`	带参前缀匹配（短路匹配）	普通字符串匹配	用于`标准uri`前，并要求一旦匹配到就会立即处理，不再去匹配其他的正则URI，一般用来匹配目录。
`空`	普通前缀匹配	普通字符串匹配	location后没有参数直接跟着`标准uri`，表示前缀匹配，代表跟请求中的uri从头开始匹配。

location匹配顺序
location 的匹配并不完全按照其在配置文件中出现的顺序来匹配，请求URI 会按如下规则进行匹配,优先级从高到低依次为（序号越小优先级越高）：

1. location =    # 精准匹配，精准匹配成功则会立即停止其他类型匹配；
2. location ^~   # 带参前缀匹配。如果是带有 ^~ 的前缀匹配，匹配成功则立即停止其他类型匹配；如果是普通前缀匹配（不带参数 ^~ ）成功则会暂存，继续查找正则匹配；
3. location ~    # 正则匹配（区分大小写）。当同时有多个正则匹配时，按其在配置文件中出现的先后顺序优先匹配，命中则立即停止其他类型匹配；
4. location ~*   # 正则匹配（不区分大小写）
5. location /a   # 普通前缀匹配，优先级低于带参数前缀匹配。所有正则匹配均未成功时，返回步骤 2 中暂存的普通前缀匹配（不带参数 ^~ ）结果。普通字符串匹配则无视顺序，只会选择最精确的匹配。
6. location /    # 任何没有匹配成功的，都会匹配这里处理

表达式	说明
^	匹配输入字符串的起始位置（以什么开头）。
$	匹配输入字符串的结束位置（以什么结尾）。
*	匹配`前面的字符`零次或多次。如"01*“能够匹配到"0”、“01”、“011”、“0111…”。
+	匹配`前面的字符`一次或多次。如"01*“能够匹配到"01”、“011”、“0111…”。
?	匹配`前面字符`零次或一次。如01？只能能够匹配到"0"、“01”。
.	匹配除”\n“之外的任意一个字符，若要匹配包括”\n“在内的任意字符则使用”[.\n]“之类的表达式	.*
\|转义符
\d	匹配出数字效果于[0-9]一致
\s	空白符
\w	任意单词字符包括下划线
{n}	匹配前面表字符n次
{n,}	匹配前面字符不少于n次
{n,m}	匹配前面字符n到m次
[]	定义匹配的字符范围
[c]	匹配单个字符c
[a-z]	匹配a-z小写字母任意一个
[a-zA-Z0-9]	匹配范围大小写字母及数字
()	看成整体匹配
		或运算符

location 匹配规则优先级验证

1 通用匹配
相当于是兜底处理，所有的规则匹配不成功就会走兜底处理。

server {
      listen 82;
      server_name www.liyong.f.com;
       # 因为所有的地址都以 /开头，所以这条规则将匹配到所有请求，比如访问 / 和 /testOrder , 则 / 匹配 /data,/test也匹配，
      location / { #作为最后的匹配项
        return 401;
      }
      location /testOrder { #普通前缀匹配
        root html;
        index index.html 
      }
  }

访问：
http://www.liyong.f.com:82/data,http://www.liyong.f.com:82/test 都是401
访问testOrder 会走下面的匹配其实它也是能匹配上/的，但是/testOrder优先级更高就会去服务器相对路径/html/testOrder/寻找资源。
在这里插入图片描述
同时通过上面的例子也验证了，匹配与location的书写顺序无关。如果有关就会被/ 先匹配。
2 普通前缀匹配
就是根据普通路径进行匹配,非等值匹配匹配最长的路径。

server {
   listen 82;
   server_name www.liyong.f.com;
   location /doc {
       return 402;
   }
   location /docu {
       return 500;
   }
}

访问：http://www.liyong.f.com:82/document
在这里插入图片描述
说明：前缀匹配下，返回最长匹配的 location，与 location 所在配置文件中的顺序无关。
3 正则匹配
3.1 正则匹配与普通匹配

location ~ ^/proxy { #正则匹配
    return 500;
}
location /proxy { #普通匹配
    return 410;
}

访问：http://www.liyong.f.com:82/proxy 可以发现正则匹配的优先级更高
在这里插入图片描述
3.2 正则匹配与正则匹配

location ~ ^/proxy[0-9]+ {
   return 500;
}
location ~ ^/proxy[0-9]+ {
   return 401;
}

访问：http://www.liyong.f.com:82/proxy114445
在这里插入图片描述
但是如果我们交换顺序：

location ~ ^/proxy[0-9]+ {
   return 401;
}
location ~ ^/proxy[0-9]+ {
   return 500;
}

访问：http://www.liyong.f.com:82/proxy114445
在这里插入图片描述
说明：通过上面的案例可以看到，如果路径满足多个正则，则配置顺序决定了优先级，在前面location会匹配成功。
3.3 区分大小写的正则匹配

server {
    listen 82;
    server_name www.liyong.f.com;
    location ~ /doc{
        return 401;
    }

    location ~* /doc { #正则匹配区分大小写
        return 402;
    }
}

访问： www.liyong.f.com:82/DOC 402
访问：www.liyong.f.com:82/doc 401
4 带参前缀匹配
4.1 多个带参前缀与正则的优先级

server {
    listen 82;
    server_name www.liyong.f.com;
    location ^~ /doc {
        return 401;
    }
    location ^~ /document {
        return 402;
    }
    location ~ /document {
        return 500;
    }
}

http://www.liyong.f.com:82/document
在这里插入图片描述
说明：都是带参的情况下也是会匹配最长路径，但是这点和正则不同，正则是谁先成功就就走谁。而且我们后面还配了一个路径更长的正则匹配确没有走，证实了带参前缀匹配 ^~ 命中以后会再搜寻其他带参前缀匹配，不会搜索正则匹配。

5 精准匹配
5.1 多个精准匹配

location = /doc {
  return 401; 
}
location = /document {
  return 402; 
}

精准匹配：
只有访问http://www.liyong.f.com:82/doc，http://www.liyong.f.com:82/document 才能正确处理。也就是路径必须一模一样。

5.2 精准匹配与带参前缀匹配

location ^~ /document {
    return 402;
}
             
location = / {
    return 400;
}

location = /document {
    return 401;
}

访问：/document 返回401 所以精准匹配的优先级高于带参匹配

location配置运用的几个准则

1 第一个必选规则

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

location = /index.html {
     root   html
     index  index.html index.htm
 }
 
 location = / {
     root   html
     index  index.html index.htm
 }

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

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

3 通用匹配,作为兜底

location / {
    return 500;
}

location 的其它配置项

1 匹配问号后的参数

请求 URI 中问号后面的参数是不能在 location 中匹配到的，这些参数存储在 $query_string 变量中，可以用 if 来判断。

location /idx {

  if ($query_string ~* ".*id.*" ) {
     return 500;
  }
  return 401;
}

访问：http://www.liyong.s.com:83/idx?jdid 500
访问：http://www.liyong.s.com:83/idx?xx 401
2 URI 结尾带不带/
1)在location 中配置的URI有没有 / 都没有影响。也就是说 /user/ 和 /user 是一样的。
2)如果浏览中发送的 URI 结构是 https://domain.com/ 的形式，尾部有没有 / 都不会造成重定向。因为浏览器在发起请求的时候，默认加上了 / 。虽然很多浏览器在地址栏里也不会显示 / 。这一点，可以访问baidu验证一下。
3)如果浏览中发送的 URI 结构是 https://domain.com/``some-dir/ 。尾部如果缺少 / 将导致重定向。因为根据约定，URI 尾部有 / 表示目录，没有 / 表示文件。
a. 所以访问 /some-dir/ 时，服务器会自动去该目录下找对应的默认文件。
b. 如果访问 /some-dir 的话，服务器会先去找 some-dir 文件，找不到的话会将 some-dir 当成目录，重定向到 /some-dir/ ，去该目录下找默认文件。

rewrite指令

rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标记位实现URL重写以及重定向。
比如：更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。

rewrite只能放在server{},location{},if{}中，并且默认只能对域名后边的除去传递的参数外的字符串起作用。

rewrite 跳转实现

nginx 是通过 ngx_http_rewrite_module 模块支持 url 重写、支持 if 条件判断，但不支持 else。
另外该模块需要 PCRE 支持，应在编译 nginx 时指定 PCRE 支持，默认已经安装。
根据相关变量重定向和选择不同的配置，从一个 location 跳转到另一个 location，不过这样的循环最多可以执行 10 次，超过后 nginx 将返回 500 错误。
rewrite 执行顺序
执行 server 块里面的 rewrite 指令。
执行 location 匹配。
执行选定的 location 中的 rewrite 指令。

flag标记说明

last ：本条规则匹配完成后，不终止重写后的url匹配，一般用在 server 和 if 中。
break ：本条规则匹配完成即终止，终止重写后的url匹配，一般使用在 location 中。
redirect ：返回302临时重定向，浏览器地址会显示跳转后的URL地址。
permanent ：返回301永久重定向，浏览器地址栏会显示跳转后的URL地址。

示范例子

1 重新定向到nginx中的路径

server {
listen 82;
server_name www.liyong.f.com;
    location / {
        # 判断主机名为www.itxh.com则重写为www.newitxh.com
        if ($host = 'www.liyong.f.com'){
            rewrite ^/(.*)/(.*)$ /demo/$2 permanent; #这里$2 表示第二个括号的内容
        }
        root   html;
        index  index.html index.htm;
    }
    location /demo/aaa {
       alias html;
       index index.html index.htm;
    }
}

访问：http://www.liyong.f.com:82/test/aaa 可以看到被重新定向
结合这个uri解释一下$2 这个$2就是aaa,如果我们写$1则值是test
在这里插入图片描述
拓展：

location /test/ {
    # 判断主机名为www.itxh.com则重写为www.newitxh.com
    if ($host = 'www.liyong.f.com'){
        rewrite ^/(.*)/(.*)$ /demo/$2 permanent;
    }
    root   html;
    index  index.html index.htm;
}
location /demo/aaa {
   alias html;
   index index.html index.htm;
}

这个时候我们访问路径：http://www.liyong.f.com:82/test/test/aaa 才能狗重定向到 /demo/aaa 。由此我们验证了rewrite 后面的正则表达式^/(.)/(.)$是不包含location的路径的，是除去location路径向后匹配。就比如http://www.liyong.f.com:82/test/aaa/bbb被重定向以后是http://www.liyong.f.com:82/demo/bbb
2 基于域名的跳转

 rewrite ^/(.*)$ http://www.liyong.demo.com/$1 permanent;

3 结合ip 或者其它内置变量使用（以ip为例子）
错误配置并且浏览器会缓存重定向，如果你修改了nginx配置发现依然重定向到之前的地址，可以清空浏览缓存试试。
在这里插入图片描述

server {
      listen 82; 
      server_name www.liyong.f.com;
      set $is_rewrite false; 
      if ($remote_addr = '15.195.14.17') {
          set $is_rewrite  true;
      }
      if ($is_rewrite = true) {
         rewrite (.+) /demo/aaa permanent ;
       }
       location /test/ {
           if ($host = 'www.liyong.f.com'){
               add_header X-Remote-Addr  $remote_addr;
               rewrite ^/(.*)/(.*)$ /demo/$2 permanent;
           }
           root   html;
           index  index.html index.htm;
       }
       location /demo/aaa {
          alias html;
          index index.html index.htm;
       }
  }

这个配置会导致死循环，这个是实战中一定要注意的，但是实际上重定向超过一定次数也就不会再发送请求到nginx了，会报错误重定向次数过多
正确的配置：

 server {
     listen       80;
     server_name  localhost;     
 
     # 设置变量为$rewrite,变量值为boolean类型的true
     set $rewrite true;        
     # 当客户端IP为15.195.14.17时，将$rewrite变量值设为false              
     if ($remote_addr = "15.195.14.17"){       
         set $rewrite false;
     }
     # 当变量值为true时，进行rewrite重写，将域名后面的路径重写为/weihu.html
     if ($rewrite = true){                       
         rewrite (.+) /weihu.html;               
     }
     
     # 精确匹配/weihu.html请求
     location = /weihu.html {
         # 看到400页面，就表示重定向成功了
         return 400;                    
     }
     location / {
         return 401;
     }
 }

4 基于参数匹配的跳转
4.1

 server {
     listen       80;
     server_name  localhost;    
     #正则匹配成功就跳转
     if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
         rewrite (.+) http://www.liyong.com permanent;
     }
     
     location / {
         return 400;
     }
 
 }

4.2

 server {
     listen       80;
     server_name localhost;
 
     location ~* ^/abc/123.html {
         rewrite (.+) http://www.liyong.com permanent
     }
     
     location / {
         return 400;
     }
 }

4.3

 server {
     listen       80;
     server_name  localhost;
 
     location ~* ^/abc/123.html {
         rewrite (.+) http://www.liyong.com permanent
     }
     
     location / {
         return 400;
     }
 }

developer@liyong

关注

1
点赞
踩
3

收藏

觉得还不错? 一键收藏
0
评论
Nginx-基础-基础配置（Server,Location语法,匹配优先级，rewrite）

就比如http://www.liyong.f.com:82/test/aaa/bbb被重定向以后是http://www.liyong.f.com:82/demo/bbb。只有访问http://www.liyong.f.com:82/doc，http://www.liyong.f.com:82/document 才能正确处理。也就是路径必须一模一样。http://www.liyong.f.com:82/data,http://www.liyong.f.com:82/test 都是401。
复制链接

扫一扫

专栏目录