Shadowrocket 规则类型详解:DOMAIN-SUFFIX、GEOIP、IP-CIDR 与 FINAL 各匹配什么

逐条拆解 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 的匹配对象与写法,附示例片段,并说明它们的先后顺序。

本文速览

在 Home → Global Routing 选择 Config 后,Shadowrocket 按当前配置中的规则从上到下匹配,第一条命中即决定策略。域名规则看主机名,地址规则看目标 IP,FINAL 处理前面都未命中的连接。适合正在整理分流配置、想判断一条连接为何走 DIRECT 或 PROXY 的读者。

规则匹配顺序:先确认 Config,再找第一条命中

在 Home → Global Routing 选择 Config,再到 Config 页核对当前使用的配置文件。Config 在前一处是路由模式,在后一处是管理配置文件的页面;编辑了另一份文件,当前连接不会按那份文件的新规则处理。Proxy 和 Direct 也不是用来验证这份分流顺序的模式。

连接请求目标信息逐条匹配策略选择连接出站

规则通常写成“类型、匹配值、策略”,例如 DOMAIN,api.example.com,DIRECT。DIRECT 表示直接连接,PROXY 表示走代理。配置不会自动挑选更精确的规则:即使某条 DOMAIN 比 DOMAIN-SUFFIX 写得更具体,只要排在它前面的后缀规则已经命中,就不会再看这条精确规则。

3 种
本文涉及的域名规则:精确、后缀、关键词
256 个
IPv4 的 /24 网段包含的地址数
2 个字段
FINAL 只写规则类型和策略

域名规则:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD

三种规则都匹配主机名,不匹配整个 URL。以 https://api.example.com:443/v1/status 为例,域名字段写 api.example.com,不带 https://、端口 443 或路径 /v1/status。如果同一主机的两个路径需要不同处理,单靠这三种规则不能区分它们。

规则类型匹配值命中示例不命中示例
DOMAINapi.example.comapi.example.comimg.api.example.com
DOMAIN-SUFFIXexample.comexample.com、api.example.comnotexample.com
DOMAIN-KEYWORDexamplenotexample.netapi.example.net 以外的无关主机,如 api.demo.test

只想给一个主机设例外,用 DOMAIN。需要覆盖根域及其子域,用 DOMAIN-SUFFIX,匹配值不必写成 *.example.com。DOMAIN-KEYWORD 则按子串匹配,不要求关键词位于两个点之间。上表的 notexample.net 也含有 example,因此会命中;即使域名所属站点完全不同,也不会改变这个结果。已知目标域名时,使用精确或后缀规则更容易控制范围。

地址规则:IP-CIDR 看网段,GEOIP 看 IP 归属

当连接给出的是域名时,地址类规则需要有目标 IP 才能比较。以 IP-CIDR,192.0.2.0/24,DIRECT,no-resolve 为例,no-resolve 表示不为匹配这条规则额外发起 DNS 解析,不是关闭整个配置的 DNS。已有目标 IP 时仍可判断是否落入该网段;如果只有主机名且没有可用地址,不应指望这条规则把主机名解析出来再命中。

同一主机名可能返回不同的地址。域名后缀规则的匹配条件不随这些地址改变,而 GEOIP 的结果取决于用于匹配的目标 IP 及其数据库归属。如果要求某个主机始终使用同一策略,把对应的域名规则放在地域规则之前。

FINAL 兜底与顺序示例

FINAL 不填写域名、网段或地区代码,例如 FINAL,PROXY 让前面未命中的连接走代理。将它放在 [Rule] 末尾。下面是用于推演顺序的规则片段,不是完整配置;验证 PROXY 路径时,应使用自己已配置且可用的代理。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,demo-example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
  1. 目标主机名为 api.example.com 时,第一行已选中 DIRECT。如果交换前两条规则,同一个主机名会先命中后缀规则,改走 PROXY。
  2. 目标主机名为 demo-example.example.com 时,后缀和关键词都符合,但后缀规则在前,因此走 PROXY。关键词匹配不会覆盖已选中的策略。
  3. 目标直接以 192.0.2.18 给出时,前三条域名条件不命中,网段规则选中 DIRECT。换成 192.0.3.18 只说明没有命中该网段,还要检查后面的 GEOIP,不能直接认定走 FINAL。
  4. 域名、网段和地区条件都未命中时,才使用末行的 PROXY。如果这一出站连接失败,FINAL 不会再提供另一个策略;它处理的是“未匹配”,不是“连接失败”。

排查规则未生效与连接失败

先确认是策略选错,还是选对策略后连接失败。用一个明确的目标主机重试:例如为自己能访问的测试主机添加一条 DOMAIN 规则,把它放在更宽的规则之前,保存后重新发起连接。网页往往会同时请求图片和脚本所在的其他主机,不能只根据整页是否打开来推断所有请求的策略。

浏览器报错

以下为浏览器可能显示的错误原文,不是 Shadowrocket 的规则命中结果。

报错:ERR_NAME_NOT_RESOLVED

原因:浏览器未能将请求的主机名解析为地址。解法:先核对请求的主机名拼写和 DNS 解析,再判断是否需要调整依赖目标 IP 的规则。

报错:ERR_CONNECTION_TIMED_OUT

原因:连接在规定时间内未建立,错误本身不能说明是哪条规则命中。解法:按当前配置顺序核对预期策略;若预期走 PROXY,再在 Home 对当前使用的代理做 Connectivity Test。

常见问题

为什么补了 DOMAIN 还是走代理?

先确认 Home → Global Routing 选的是 Config,并核对编辑的是在用文件。再检查前面是否有已经命中的 DOMAIN-SUFFIX 或 DOMAIN-KEYWORD;有的话,把精确例外移到它们前面并重新发起连接。

访问同一个域名,为什么 GEOIP 的结果会变?

先比对两次连接实际使用的目标 IP。域名保持不变,不代表两次连接使用了同一地址。如果要求按域名固定策略,就用一条靠前的 DOMAIN,而不是依赖后面的 GEOIP。

改 FINAL 之前,要检查哪些规则?

先用一个未命中已知域名规则的测试目标,继续检查它是否命中任何 IP-CIDR 或 GEOIP。只有前面的条件都不成立,改动 FINAL 才会影响该连接。验证时一次只改一项,便于对照结果。

下载 Shadowrocket 与快速上手

iPhone / iPad 版通过 App Store 获取,$2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片及 Intel)、Windows、安卓、Linux 版免费,从本站下载页获取。

下载 Shadowrocket