nginx lcoaltion 匹配规则 nginx匹配规则顺序

转载

mob64ca140a59b0 2024-06-26 14:28:54

文章标签 nginx location 动态proxy 正则表达式 Nginx 文章分类 运维

文章目录

官网
location 规则详解
动态Proxy

使用多个 if 指令指定不同的 proxy_pass
根据参数选择不同的 proxy_pass

nginx lcoaltion 匹配规则 nginx匹配规则顺序_动态proxy

官网

https://nginx.org/en/docs/http/ngx_http_core_module.html#location

nginx lcoaltion 匹配规则 nginx匹配规则顺序_location_02

nginx lcoaltion 匹配规则 nginx匹配规则顺序_正则表达式_03

nginx lcoaltion 匹配规则 nginx匹配规则顺序_Nginx_04

nginx lcoaltion 匹配规则 nginx匹配规则顺序_动态proxy_05

location 规则详解

Nginx的location指令工作原理如下：

位置匹配：

Nginx根据规范化的URI进行位置匹配。
解码以"%XX"形式编码的文本。
解析相对路径组件".“和”…"的引用。
可能将两个或多个相邻的斜杠压缩为单个斜杠。

位置定义：

位置可以由前缀字符串或正则表达式定义。
正则表达式可以是不区分大小写的(~*修饰符)或区分大小写的(~修饰符)。
首先检查前缀位置，并选择具有最长匹配前缀的位置。
正则表达式按照它们在配置文件中出现的顺序进行检查。
一旦找到正则表达式匹配项，将使用相应的配置，并终止进一步检查。

修饰符：

^~修饰符：如果具有最长匹配前缀的位置具有此修饰符，则不会检查正则表达式。
=修饰符：定义URI和位置的精确匹配。一旦找到，搜索终止。
@前缀：为请求重定向定义了一个命名位置，而不是用于常规请求处理。不能嵌套，也不能包含嵌套位置。

匹配指令：

~：执行区分大小写的正则表达式匹配。
~*：执行不区分大小写的正则表达式匹配。
^~：执行普通字符匹配，不是正则表达式。如果匹配成功，只使用该选项，不再匹配其他选项，通常用于匹配目录。
=：执行精确匹配，即普通字符的精确匹配。
@：定义一个命名的location，用于内部重定向，例如error_page，try_files。

匹配优先级：

精确匹配(=)优先级最高。如果找到精确匹配，Nginx停止搜索其他匹配。
普通字符匹配，正则表达式匹配以及长的块规则将优先于其他查询匹配。换句话说，如果某个项匹配成功，Nginx还会继续检查是否有正则表达式匹配和更长的匹配。
如果使用了^~，则只匹配该规则，Nginx停止搜索其他匹配；否则，Nginx会继续处理其他location指令。
最后，按照匹配程度最高的逐字匹配指令，如果找到相应的匹配，Nginx停止搜索其他匹配。

这些规则确保了location指令的匹配行为，并使得开发者能够有序地控制请求的路由和处理。

特殊处理：

如果位置由以斜杠结尾的前缀字符串定义，并且请求由某些指令（如proxy_pass）处理，则如果请求的URI没有尾部斜杠，则执行永久重定向（301）。

以下是基于提供的配置的示例：

location = / {
    [ 配置 A ]
}

location / {
    [ 配置 B ]
}

location /documents/ {
    [ 配置 C ]
}

location ^~ /images/ {
    [ 配置 D ]
}

location ~* \.(gif|jpg|jpeg)$ {
    [ 配置 E ]
}

请求：

“/”: 匹配配置 A。
“/index.html”: 匹配配置 B。
“/documents/document.html”: 匹配配置 C。
“/images/1.gif”: 匹配配置 D。
“/documents/1.jpg”: 匹配配置 E。

特殊处理的示例：

location /user/ {
    proxy_pass http://user.example.com;
}

location = /user {
    proxy_pass http://login.example.com;
}

请求：

“/user/”: 代理到http://user.example.com。
“/user”: 代理到http://login.example.com。

动态Proxy

使用多个 if 指令指定不同的 proxy_pass

server {
    listen 127.0.0.1:80;
    set $test  A; 
    set $testB B;

    location / {
        if ($test ~* "A") { 
            proxy_pass http://www.so.com; 
            break; 
        } 
        if ($testB ~* "B") { 
            proxy_pass http://www.sogou.com; 
            #break; 
        } 
    }
}

当希望根据不同的条件执行不同的proxy_pass时，可以使用多个if指令。例如，在上述配置中，如果多个条件都满足，比如在第一个if中没有使用break，那么下一个条件也会被执行。为了确保匹配到第一个条件后就执行相应的proxy_pass，可以在第一个if指令中加上break关键字。（在Nginx中没有if-else这样的结构）

在这种情况下，可以使用多个if语句来满足不同条件下的处理逻辑。但需要注意的是，if语句是在Nginx的rewrite模块中执行的，并且在性能方面可能会有一些影响。另外，需要小心使用if语句，因为它们可能会引起一些意想不到的问题

根据参数选择不同的 proxy_pass

location / {
    root    html;
    index   index.html index.htm index.php;
    proxy_redirect      off;
    proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header    X-Real-IP $remote_addr;
    proxy_set_header    Host $http_host;
    proxy_http_version  1.1;
    proxy_set_header    Connection "";

    if ( $query_string ~* "usg=0" ) {
        proxy_pass      http://local_workera;
    }

    if ( $query_string ~* "usg=1" ) {
        proxy_pass      http://local_workerb;
    }

    if ( $arg_uid ~* "(.*[AB]$)" ) {
        proxy_pass      http://local_workerf;
    }

    proxy_pass    http://local_workera;
}

请求路径中的 usg=0 和 usg=1 这两个参数是固定的，因此可以使用 $query_string 进行正则匹配。
接下来，如果要对参数 uid 的值以 A 或 B 结尾的请求进行处理，就无法使用 $query_string 进行匹配了；因此，需要使用 $arg_uid 进行正则匹配。
由于 usg=0 和 usg=1 这两个参数是互斥的，因此放在 location 块的顶部即可正确处理。而对于 uid 的匹配，则应放在最底部或者使用 break 关键字，以避免与 usg 参数的匹配冲突。