nginx rewrite语法

rewrite regex replacement [flag];
  • regex: 是 PCRE 语法格式的正则表达式,用于匹配字符串。
  • replacement: 是重写 URI 的改写规则。当改写规则以"http://""https://"或"$scheme"开头时,Nginx 重写该语句后将停止执行后续任务,并将改写后的 URI 跳转返回客户端。
  • flag: 是执行该条重写指令后的操作控制符。操作控制符有如下 4 种:

    • break: 执行完当前重写规则跳转到新的 URI 后不再执行后续操作。不影响用户浏览器 URI 显示。
    • last: 执行完当前重写规则跳转到新的 URI 后继续执行后续操作。
    • redirect: 返回响应状态码 302 的临时重定向,返回内容是重定向 URI 的内容,但浏览器网址仍为请求时的 URI;
    • 返回响应状态码 301 的永久重定向,返回内容是重定向 URI 的内容,浏览器网址变为重定向的 URI。
      下面一个例子将本地63561代理到nginx代理80端口上,并且所有URL上添加/prefix前缀。

      location /prefix/ {
         rewrite  ^/prefix/(.*)$ /$1 break;
             proxy_pass  http://localhost:63561;            
          }

      原来URL http://localhost:63561/aaa => localhost/prefix/aaa
      虽然在nginx添加了如下配置,可不一定生效哦,这里就要讲下nginx URI 匹配规则

      URI 匹配规则

      location Modifier pattern { ... }

Modifier为location的修饰语,定义URI的匹配规则。pattern 为匹配项,可以是字符串或正则表达式

  • 没有修饰符: 从指定模式开始,只支持字符串

    location /abc{
    root text;
    }

下面规则都匹配:
http://localhost/abc/sdssd
http://localhost/abc?page=1&s...
http://localhost/abcd
http://localhost/abc/

  • =: 完全匹配 URI 中除访问参数以外的内容,Linux 系统下会区分大小写,Windows 系统下则不会。

    location = /test {
    root text;
    }

下面都匹配
http://localhost/test
http://localhost/test?page=1&...
不匹配
http://localhost/test2ds
http://localhost/test/

  • ~: 区分大小写的正则匹配

    location ~ /abc$ {
    root text;
    }

下面都匹配
http://localhost/abc
http://localhost/abc?p=123
不匹配
http://localhost/abc/
http://localhost/ABC
http://localhost/abc/bbd

  • ~*: 不区分大小的正则匹配

    location ~* /abc$ {
    root text;
    }

下面都匹配
http://localhost/abc
http://localhsot/ABC
http://localhost/abc?p=123
不匹配
http://localhost/abc/
http://localhost/abc/bbd

  • ^~: 作用类似没有修饰符的前缀匹配,nginx对一个请求精确前缀匹配成功后,停止继续搜索其他到匹配项,支持正则表达式。

    location ^~ /abc {
    root text;
    }
  • @: 只能内部访问的 location 区域,可以被其他内部跳转指令使用

    location @images {
    proxy_pass http://images;
    }

匹配顺序

  1. 先检测匹配项的内容为非正则表达式修饰语的 location,然后再检测匹配项的内容为正则表达式修饰语的 location。
  2. 匹配项的内容为正则与非正则都匹配的 location,按照匹配项的内容为正则匹配的 location 执行。
  3. 所有匹配项的内容均为非正则表达式的 location,按照匹配项的内容完全匹配的内容长短进行匹配,即匹配内容多的 location 被执行。
  4. 所有匹配项的内容均为正则表达式的 location,按照书写的先后顺序进行匹配,匹配后就执行,不再做后续检测。

https://www.w3schools.cn/ngin...


神易风
106 声望52 粉丝

alert("hello world")