Shadowrocket 自定义规则写法与匹配优先级:从上到下匹配与 FINAL 兜底

讲清规则自上而下逐条匹配、命中即停的机制,PROXY / DIRECT / REJECT 三种策略的区别,以及 FINAL 放在末尾的原因。

本文速览

本文适合已经导入自己已有服务信息、准备在 Shadowrocket(小火箭)中调整分流的用户。先确认 Home → Global Routing 使用 Config,再理解规则顺序、域名与 IP 条件以及 FINAL 的位置,最后用单条请求核对实际命中结果。示例域名与地址仅用于说明语法,不能作为可用服务信息。

先确认 Config 分流是否启用

规则写入文件并不等于规则已经参与当前连接。Home 管理连接与服务选择,Config 管理配置文件,Settings 管理应用设置。排查前需要分别确认“当前启用哪份配置”和“当前使用哪种 Global Routing 姿态”,不要只看文件里有没有刚添加的一行。

Global Routing 下的 Proxy、Direct、Config、Scene 是连接采用的工作姿态;规则行中的大写 PROXY、DIRECT、REJECT 则是匹配后的策略。两组词所处层级不同。本文讨论的是 Config 姿态下,当前生效配置中 Rule 列表的顺序。

Global Routing检查重点与本文规则的关系
Config确认 Config 中当前启用的文件按配置中的规则执行分流,是本文验证使用的姿态。
Proxy确认当前选择的代理服务可用以代理姿态处理连接,不能用它验证完整的 Config 分流顺序。
Direct确认设备当前网络能否直接访问目标以直连姿态处理连接,不用于验证规则中的 PROXY 是否命中。
Scene检查当前生效的场景及其设置先确认场景实际采用的行为,再分析配置规则,不能只看 Scene 名称推断结果。

Settings → On Demand 处理按需连接条件,不负责把一条域名规则提到另一条前面。测试期间应保持连接状态稳定,避免网络切换触发连接变化后,把连接状态问题误判为规则不生效。

匹配优先级:第一条命中即停止

Rule 列表不是按“域名一定比 IP 优先”或“越长的规则自动优先”排序。对于能够判断匹配条件的请求,Shadowrocket 从上往下检查规则,第一条命中后采用该行策略,不再让后面的普通规则覆盖它。因此,具体例外通常需要放在宽泛条件之前。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

当请求的域名是 api.example.com 时,第一行域名规则已经命中,结果是 DIRECT。访问 www.example.com 时,第一条不匹配,第二条后缀规则命中,结果是 PROXY。访问 example.net 且前面均不匹配时,才会落到 FINAL。

3 种策略
本文区分 PROXY、DIRECT、REJECT
4 类关键字
重点检查 DOMAIN-SUFFIX、GEOIP、IP-CIDR、FINAL
末尾 1 条
简化配置保留一条 FINAL 作为兜底

如果把上例第二行移到第一行之前,api.example.com 也会先命中后缀规则,后面的精确域名规则便失去作用。这就是“规则存在但没有生效”的常见原因:不是语法错误,而是请求已经被上方条件接走。

规则写法:域名、地址段与地区条件

普通规则通常按“类型、匹配内容、策略”书写,使用英文逗号分隔,一行一条。不要用中文逗号,也不要把多个域名用空格塞进同一个匹配字段。FINAL 是例外,它没有域名或地址条件,直接跟策略。

域名与兜底

DOMAIN
api.example.com,DIRECT
DOMAIN-SUFFIX
example.com,PROXY
FINAL
PROXY

以上为关键字与后续字段的对应关系;写入文件时用英文逗号连接。

IP 条件与解析

IP-CIDR
192.0.2.0/24,DIRECT,no-resolve
GEOIP
CN,DIRECT
no-resolve
不为这条 IP 规则主动触发域名解析

192.0.2.0/24 是文档示例地址段,不代表实际应直连的服务网络。

域名规则需要匹配时能获得相应域名信息;IP 规则需要可用于判断的目标地址。对域名请求,是否触发解析还与规则选项及 DNS 设置有关。添加 no-resolve 可以避免该条 IP 规则主动要求解析,但不能据此推断所有域名请求都能命中该地址段。遇到不同访问方式结果不同,应先检查记录里的实际目标是域名还是 IP。

PROXY、DIRECT、REJECT 与 FINAL 的组合

PROXY 表示交给代理策略处理,具体出口取决于当前服务选择或配置中引用的策略设置;DIRECT 表示直接连接目标;REJECT 表示拒绝请求。它们都不是“自动修复连接”的按钮:PROXY 不能让错误的服务参数变正确,DIRECT 也不能保证当前网络可以到达所有目标。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,blocked.example.net,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

此片段只演示 Rule 段,不是完整配置。已有文件包含 [Rule] 时,应把需要的规则合入原段,不要机械地再粘贴一个同名段。示例把精确域名放在较宽的后缀条件前,再放地址与地区条件,最后保留 FINAL。真实顺序应服从用户自己的访问要求,而不是把示例当成通用策略。

FINAL 的两种兜底选择

FINAL,PROXY
  • 前面明确列出需要 DIRECT 或 REJECT 的目标。
  • 其余未匹配请求交给代理策略。
  • 应确认当前选择的代理服务及协议参数可用。
FINAL,DIRECT
  • 前面明确列出需要 PROXY 或 REJECT 的目标。
  • 其余未匹配请求使用设备当前网络直连。
  • 新目标未加入规则时,不会自动走代理策略。

两种写法改变的是未匹配流量的去向;选择其中一种,并将 FINAL 放在普通匹配规则之后。

FINAL 本身没有条件。如果它出现在列表中间,走到这一行的请求就已经确定策略,后面的普通规则没有机会再处理这些请求。若文件存在多条 FINAL,先清理为一条明确的末尾兜底,再继续排查其他规则。

修改与验证:一次只改变一个条件

以下操作以 Home、Config、Settings 的页面结构为参照;不同平台的编辑控件位置可能不同,应以当前页面实际提供的文件操作为准。验证前保留原文件副本,记录测试目标、预期策略和实际结果,避免一次改动多个条件后无法定位原因。

  1. 保留副本

    进入 Config,找到当前使用的配置文件,先通过文件操作保存副本或导出备份。远程配置宜保留一份独立的本地测试副本,避免后续更新覆盖实验内容。

  2. 编辑规则

    在 Config 打开目标文件的编辑功能,定位 [Rule]。把一条具体域名规则放到宽泛后缀规则之前,检查英文逗号、策略拼写及末尾 FINAL,然后保存。

  3. 确认启用

    在 Config 确认刚保存的文件处于启用状态,再到 Home → Global Routing 选择 Config。仅编辑副本而未启用副本,不会改变正在使用的配置。

  4. 重新建连

    结束测试应用对目标的旧连接,必要时关闭后重新打开 Shadowrocket 的连接开关,再发起一次新请求。已有连接可能继续沿用建立时的策略,不能只刷新一个复用连接的页面就下结论。

  5. 核对记录

    查看应用提供的连接记录或日志,按测试时间定位目标域名或 IP,核对实际策略及可见的匹配信息。若请求发生重定向,应分别检查原域名与跳转后的域名。

验证标准应是“指定目标的新连接是否采用预期策略”,不是网页是否恰好打开。例如新连接已显示 PROXY 但握手失败,应转向检查用户已有服务的连接参数;新连接显示 DIRECT 且命中上方宽规则,则应先调整规则顺序。两种现象的排查方向不同。

规则不生效时的具体检查项

已经加了 DIRECT,为什么还是 PROXY?

先在 Home → Global Routing 确认 Config,再到 Config 核对启用文件。随后搜索目标域名,检查上方是否存在更宽的 DOMAIN-SUFFIX 或提前出现的 FINAL。将具体例外移到宽规则前,保存后使用新连接复测。

同一个网站,为什么有的请求走了别的策略?

查看连接记录中的完整域名。主页面、图片、登录接口可能使用不同域名;匹配 example.com 的规则不会自动涵盖独立的 example.net。按实际请求补充必要条件,不要只根据浏览器地址栏判断全部流量。

为什么 IP-CIDR 没有拦到域名请求?

检查记录中的目标地址是否属于该网段、是否使用 IPv6,以及该条是否带 no-resolve。域名解析可能返回多个地址;不要用另一次解析得到的单个地址推断当前连接。目标稳定为域名时,可以先用精确 DOMAIN 规则验证。

更新后自定义规则怎么消失了?

先区分更新的是 Home 中已有服务订阅,还是 Config 中的远程配置。前者与 Rule 文件不是同一对象;后者可能重新拉取文件内容。检查当前文件来源及启用状态,恢复本地备份后,决定继续维护独立配置还是采用该远程配置提供的更新方式。

下载 Shadowrocket