文章目录
- 官网
- location 规则详解
- 动态Proxy
- 使用多个 if 指令指定不同的 proxy_pass
- 根据参数选择不同的 proxy_pass
官网
https://nginx.org/en/docs/http/ngx_http_core_module.html#location
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。
- “/user/”: 代理到
动态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参数的匹配冲突。
对于固定参数值，可以使用
$query_string进行正则匹配，而对于变量参数值，则需要使用$arg_parameter进行匹配。对于可能互斥的参数匹配条件，确保按照正确的优先级进行排列，或者在适当的地方使用break来终止后续的if语句执行
