请求匹配器 可用于按特定标准过滤（或分类）请求。

在Caddyfile中，紧跟在指令后面的匹配器标记可以限制该指令的范围。匹配器标记可以是以下形式之一：

匹配器标记通常是可选的。如果省略匹配器标记，则它与通配符匹配器（*）相同。

该指令适用于所有HTTP 请求：

这是一样的：

但此指令仅适用于以/api/开头的路径：

要匹配路径以外的任何内容，请定义一个命名匹配器并使用@name引用它：

通配符（或“catch-all”）匹配器*匹配所有请求，并且仅在需要匹配器标记时才需要。例如，如果你要给出指令的第一个参数也恰好是路径，那么它看起来就像一个路径匹配器！因此，你可以使用通配符匹配器来消除歧义，例如：

否则，这个匹配器不经常使用。尽可能省略它很方便；只是一个偏好问题。

因为按路径匹配非常普遍，所以可以内联单个路径匹配器，如下所示：

路径匹配器标记必须以正斜杠/开头。

**路径匹配 默认为精确匹配；**你必须附加*以进行快速前缀匹配。请注意，/foo*将匹配/foo、/foo/和/foobar；你可能实际是想要/foo/*。

所有不是路径或通配符匹配器的匹配器都必须命名为匹配器。这是一个在任何特定指令之外定义的匹配器，并且可以重用。

定义具有唯一名称的匹配器为你提供了更大的灵活性，允许你将任何可用的匹配器组合成一个集合：

或者，如果集合中只有一个匹配器：

然后你可以像这样使用匹配器：@name

例如：

这仅代理具有名为“Connection”的标头字段（包含“Upgrade”）和另一个名为“Upgrade”且值为“websocket”的字段的请求。

如果匹配器集仅包含一个匹配器，则单行语法也适用：

与指令一样，命名匹配器定义必须放在使用它们的站点块内。

一个命名的匹配器定义构成一个_匹配器集_。集合中的匹配器是“与”的关系，也就是说，必须所有的都被匹配。例如，如果集合中有aheader和path匹配器，则两者都必须匹配。

相同类型的国歌匹配器可以被(AND/OR)组合起来（例如，同一个集合中的多个path匹配器），如下面的相应部分所述。

完整的匹配器文档可以在每个匹配器模块的文档中找到。

⚠️ 此模块仍处于试验阶段，因此可能会发生重大变化。

通过任何CEL(通用表达式语言) 表达式返回true或者false。

作为一种特殊情况，可以在这些CEL表达式中使用Caddy占位符 (或Caddyfile缩写)，因为它们在被CEL环境解释之前经过预处理并转换为常规CEL函数调用。

匹配以P开头的请求方法，例如PUT或POST。

处理返回404错误状态代码的请求，且与handle_errors指令结合起来处理。

通过文件进行匹配。

因为try_files策略first_exist如此普遍，所以有一条捷径：

一个空file 匹配器（后面没有列出任何文件），将通过URI从相对于站点根目录的位置逐字比对查找文件是否存在。

由于基于磁盘上文件的存在进行重写非常普遍，因此还有一个try_files指令，它是file匹配器和rewrite处理器的快捷方式。

匹配后，将可以使用两个新的占位符：

匹配路径是存在文件的请求。

匹配请求，其中后跟的路径.html是存在的文件，或者如果不存在，则路径是存在的文件。

与上面相同，除了使用单行快捷方式，如果找不到文件，则回退到发出404错误。

通过请求头字段进行匹配。

统一集合的不同header字段是“和”的关系。每个字段的多个值之间是“或”的关系。

匹配请求Connection标头字段包含Upgrade的请求：

匹配Foo标头字段包含bar或者baz的请求：

匹配根本没有Foo标头字段的请求：

和header类似，但是支持正则表达式。 捕获组可以通过占位符访问，如{re.name.capture_group}，其中name是正则表达式的名称（可选，单推荐），且capture_group是表达式中捕获组的名称或编号。捕获组0是完整的正则表达式匹配，1是第一个捕获组，2是第二个捕获组，依此类推。

使用的正则表达式语言是GO语言中内置的RE2。具体请查阅RE2语法参考和Go正则语法概述。

每个标头字段仅支持一个正则表达式。多个不同的字段是“与”的关系。

将 Cookie 标头包含login_后跟十六进制字符串的请求，包含了一个可以通过{re.login.1}访问的捕获组。

通过请求的Host标头字段匹配请求。在 Caddyfile 中使用它并不常见，因为大多数站点块已经在站点地址中明确主机。此匹配器主要用于未定义特定主机名的站点块。

多个host匹配器之间是“或”的关系。

通过HTTP请求的方法（动词）匹配请求。动词应该是大写的，比如POST。可以匹配一种或多种方法。

多个method匹配之间是“或”的关系。

匹配请求方法为GET的请求。

匹配请求方法为PUT或者DELETE的请求。

或者，要同时否定多个匹配器，请打开一个块：

包含起来的匹配器的结果将被否定。

匹配路径不以/css/或/js/开头的请求。

匹配两者关系为NEIGHER的请求：

也就是说，必须__没有任何符合这些条件__(none of these)的请求才能被匹配：

匹配两者关系为WITHOUT BOTH的请求：

也就是说，必须__都不或者任何一个不__(neither or either)才能匹配：

通过请求路径进行匹配，表示请求URI的路径部分。路径匹配是精确的，但也可以使用通配符*：

请求路径在匹配前经过URL解码、小写（不区分大小写）和清理（折叠双斜杠和目录遍历点）。例如/foo*也会匹配/FOO、//foo和/%2F/foo。

多个path匹配之间是“或”的关系。

和path类似，但是支持正则表达式。捕获组可以通过占位符访问，如{re.name.capture_group}，其中name是正则表达式的名称（可选，单推荐），且capture_group是表达式中捕获组的名称或编号。捕获组0是完整的正则表达式匹配，1是第一个捕获组，2是第二个捕获组，依此类推。

请求路径在匹配前经过URL解码、小写（不区分大小写）和清理（折叠双斜杠和目录遍历点）。例如/foo*也会匹配/FOO、//foo和/%2F/foo。

使用的正则表达式语言是GO语言中内置的RE2。具体请查阅RE2语法参考和Go正则语法概述。

每个命名匹配器只能有一个path_regexp匹配器。

匹配路径以6个字符的十六进制字符串结尾的请求，后跟.css或.js作为文件扩展名，捕获组可以分别用{re.static.1}和{re.static.2}访问包含在( )中间的每个部分。

通过请求协议进行匹配。

每个命名匹配器只能有一个protocol。

通过查询字符串参数匹配请求。应该是key=value的键值对。键完全匹配，区分大小写。值可以包含占位符。值完全匹配，但也支持*匹配任何值。

每个命名匹配器可以有多个query匹配器，具有相同键的对之间是“或”的关系。

匹配带有sort查询参数且值为asc的请求。

通过远程（客户端）IP地址。接受确切的IP或CIDR 范围。如果第一个参数是forwarded，则X-Forwarded-For请求标头中的第一个IP（如果存在）将被首选作为参考IP，而不是默认的直接对等点(immediate peer)的IP。

多个remote_ip匹配器是“或”的关系。

匹配来自私有 IPv4 地址的请求。