领先的免费Web技术教程,涵盖HTML到ASP.NET

网站首页 > 知识剖析 正文

Nginx 的 location 指令定义规则和匹配规则

nixiaole 2024-12-02 23:56:12 知识剖析 13 ℃

Nginx 的 location 指令用于定义请求的 URI 到配置文件的映射规则,是 Nginx 路由和反向代理中非常重要的部分。

以下是 Nginx location 匹配的一些基本规则:

  1. 精确匹配:使用等号 = 进行精确匹配。如果请求的 URI 与 location 块中定义的字符串完全相同,则使用该 location 快进行处理。
  2. 这是最高级的匹配,如果我们需要将某个URI独立出来的时候,往往使用这种方式,比如设置独立location将流量指向特定的机器。location = /exact-match { # 配置... }
  3. 前缀匹配:默认情况下,没有指定任何特殊字符的 location 是一个前缀匹配。Nginx 会查找最长的前缀匹配。
  4. --javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown
  5. location /prefix-match {
    # 配置...
    }
  6. 正则表达式匹配:使用 ~ 开头表示进行正则表达式匹配。如果请求的 URI 与正则表达式匹配,则使用该 location 块。
  7. 正则匹配是有顺序的匹配,使用时需要特别注册,容易将不需要的请求也导入其中,容易出现错误,在使用时,需要观察流量是否符合预期。
  8. --javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown
  9. location ~ ^/regex-match {
    # 配置...
    }
  10. 不区分大小写的正则匹配:使用 ~* 开头表示进行不区分大小写的正则表达式匹配。这个没有什么特别的,也比较少的使用,一般用于解决特定的问题。
  11. --javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown
  12. location ~* ^/case-insensitive-match {
    # 配置...
    }
  13. 最长非正则匹配:如果有多个正则 location 匹配同一个请求,Nginx 会选择最长的非正则表达式匹配。一道的location遵循这种法则,这要求我们在配置时,将长度最长的请求放到其它location前面
  14. 正则表达式捕获:在正则表达式中,可以使用圆括号 ( 和 ) 来捕获 URI 中的部分内容,这些内容可以在 location 块内使用 $1, $2, ... 来引用。用来作location重定向的神器。
  15. --javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown
  16. location ~ ^/capture-regex/(.*) {
    try_files /backend/$1 =404;
    }
  17. 默认匹配:如果没有找到任何匹配的 location,则 Nginx 会使用 default_type 指令指定的默认类型来处理请求。
  18. location 块的顺序:Nginx 会按照配置文件中 location 块出现的顺序进行匹配,直到找到第一个匹配的 location 块。
  19. 变量优先级:如果 location 块使用了变量(例如 $arg_variable),则在每次请求中都会重新计算变量值。
  20. 命名 location:可以使用 name 属性给 location 命名,然后在其他 location 中通过 include 引用。
  21. --javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown
  22. location /named-location {
    name = named;
    # 配置...
    }

    location /include-named {
    include /path/to/named.conf;
    }

以下是 Nginxlocation匹配优先级的主要决定因素:

  1. 精确匹配:使用 = 定义的精确匹配具有最高优先级。如果请求的 URI 与 location 块中的精确字符串完全匹配,将立即选择该 location 块进行处理。
  2. 最长非正则表达式匹配:如果没有精确匹配,Nginx 会选择最长的非正则表达式前缀匹配。这意味着,如果有多个非正则 location 块与请求 URI 匹配,Nginx 会选择最长的那个。
  3. 正则表达式匹配:使用 ~ 或 ~* 定义的正则表达式匹配在非正则表达式匹配之后考虑。如果有多个正则 location 块与请求 URI 匹配,Nginx 将选择第一个出现的匹配项。
  4. 不区分大小写的正则表达式匹配:使用 ~* 定义的不区分大小写的正则表达式匹配在区分大小写的正则表达式匹配之后考虑。
  5. 普通前缀匹配:如果没有上述匹配,Nginx 将选择普通的前缀匹配。如果有多个普通前缀 location 块与请求 URI 匹配,Nginx 同样会选择最长的前缀。
  6. 配置顺序:如果以上所有条件都相同,Nginx 将根据 location 块在配置文件中出现的顺序来选择。第一个出现的匹配 location 将被使用。
  7. 命名 location 的 include:如果 location 块被命名,并且通过 include 指令包含在其他 location 块中,那么命名 location 的匹配规则将按照其在配置文件中出现的顺序来确定优先级。
  8. 默认匹配:如果没有找到任何匹配的 location,则 Nginx 会使用 default_type 指令指定的默认类型来处理请求。






了解这些优先级规则对于编写高效且预期行为的 Nginx 配置至关重要。正确配置可以确保请求被正确地路由到预期的处理程序。

最近发表
标签列表