· 规则与分流 · 约 8 分钟

Shadowrocket 规则语法入门:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 匹配范围

逐个说明六种常用规则关键字分别匹配什么、匹配顺序如何生效、和 PROXY / DIRECT / REJECT 怎么组合,并附 example.com 示例片段。

本文速览

在 Global Routing 选用 Config 时,先命中的规则决定当前连接的策略。本文适合第一次编辑规则,或遇到新增规则没有生效的读者。读完可以区分域名、地址和兜底规则,判断一条请求会命中哪一行,并在改动后验证结果。

规则顺序:从第一条匹配到 FINAL

先看规则在文件里的位置,再看它写得有多具体。Shadowrocket 按当前配置中的顺序匹配,命中一行就使用该行指定的策略。规则不会因为使用了 DOMAIN 而自动排到 DOMAIN-SUFFIX 前面。要为单个主机设置例外,就把例外放在能覆盖该主机的宽范围规则之前。

目标主机当前配置顺序匹配策略执行

规则只给当前连接选策略,不给整个应用贴上固定标签。同一次页面加载可能分别连接页面主机、静态资源主机和登录主机,这些连接可以命中不同的规则。排查时要找出失败请求对应的主机名,而不只是查看地址栏里的主机名。

域名规则:完整主机名、域名后缀与关键词

域名规则的匹配值只写主机名或关键词。以 https://www.example.com:443/docs 为例,主机名是 www.example.com;https://、端口 443 和路径 /docs 都不写进规则值。以下结果以连接能取得目标主机名为前提。

规则与匹配值命中示例不命中示例
DOMAIN,example.comexample.comwww.example.com
DOMAIN-SUFFIX,example.comexample.com、www.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,exampleexample.net、notexample.comwww.test.invalid

只调整一个主机时用 DOMAIN;需要覆盖根域名和各级子域名时用 DOMAIN-SUFFIX。后缀匹配有域名标签边界,不是简单地判断字符串是否以 example.com 结尾。DOMAIN-KEYWORD 则查找主机名中出现的字符串,不要求整段标签相等;如果目标只是一个已知域名,写关键词容易顺带匹配其他域名。

地址规则:IP-CIDR 网段与 GEOIP 地区

IP-CIDR 判断目标 IPv4 地址是否落在指定网段,GEOIP 则按目标 IP 在地理地址库中的归属做判断。地区编码不代表域名后缀、网站注册地或设备所在地。

如果需求是让某个主机始终走同一个策略,不要用它某次解析得到的 IP 代替域名规则。把明确的域名规则放在地址规则前面,可以在主机名已知时先处理这一例外,不必等地址规则判定。

示例片段:让单个主机例外先命中

下面的片段用于阅读和推演顺序,不是完整配置。它先拒绝指定主机,再代理同域下的其余请求,随后处理关键词和 IP 条件。接入已有配置时,只把需要的规则放入现有的 [Rule] 段,保留一个位于末尾的 FINAL。

[Rule]
DOMAIN,api.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,DIRECT
  1. api.example.com 同时符合前三行的域名条件,但第一行先命中,结果是 REJECT。若将后缀规则移到第一行,结果就会变成 PROXY。
  2. www.example.com 不符合第一行,第二行匹配后缀,结果是 PROXY。即使其目标 IP 归属为 CN,后面的 GEOIP 也不会覆盖已经命中的策略。
  3. example.net 不符合前两行的域名条件,在第三行命中关键词并走 DIRECT。若误将关键词放在后缀规则前面,www.example.com 也会先走 DIRECT。
  4. 目的地址直接写成 192.0.2.7 时,可以命中第四行。未命中前五行的连接才会走 FINAL,DIRECT。这几行都可能给出 DIRECT,所以单看策略名称不能区分是哪一行命中。

应用规则与验证结果

先确认测试所用的配置和分流姿态,再发起一条新连接。以下操作路径以 iPhone / iPad 界面为例。不要把保存规则当成测试完成:当前选中的配置、仍在复用的连接以及代理服务器状态,都会影响观察到的结果。

  1. 核对配置

    打开底部的 Config,核对当前选中的配置文件。编辑前保留可恢复的副本,避免为一次测试改动多组现有规则。

  2. 保存改动

    将要验证的规则放在同一份配置的 [Rule] 段。检查字段间是否使用英文逗号、例外是否排在宽范围规则之前,并保存。

  3. 确认分流

    返回 Home,打开 Global Routing 并选择 Config。如果此前选的是 Proxy、Direct 或使用场景的 Scene,先切到 Config 再按本文的规则顺序验证。

  4. 测试新连接

    在 Home 确认连接已打开,结束测试应用正在使用的连接,再用自己已知可访问的主机发起新请求。在 Data 查看对应时段的连接记录,核对目标主机、命中规则与所用策略;不要把页面能打开当成命中 PROXY 的证据。

连接失败:先排除 DNS 和服务器问题

浏览器报错只能说明连接在哪类环节失败,不能单独证明某一条规则命中。先核对那次请求的记录;没有对应记录时,先确认测试应用是否重新建立了连接,以及 Shadowrocket 连接是否仍处于开启状态。

浏览器报错与检查动作

报错:ERR_NAME_NOT_RESOLVED

原因:浏览器未能取得目标主机名的有效解析结果。

解法:先核对主机名拼写,再检查 Config 中当前配置的 DNS 设置;不要通过修改 FINAL 来替代解析排查。

报错:ERR_CONNECTION_RESET

原因:连接被重置,单凭报错无法区分是出站链路还是目标端中断连接。

解法:先在 Data 核对策略;若命中 PROXY,回到 Home 对当前服务器执行 Connectivity Test,再测试同一主机。

常见问题:改了规则为什么没变化

按现象定位

我加了 DOMAIN,为什么还是走原来的策略?

先在 Home → Global Routing 确认选的是 Config。再到当前规则段查看新增行之前是否已有匹配的 DOMAIN-SUFFIX、DOMAIN-KEYWORD 或其他规则。把精确例外移到那一行之前,再发起新连接。

只想让一个子域名直连,要改整条后缀规则吗?

保留现有后缀规则,在它前面加一行 DOMAIN,files.example.com,DIRECT。这只处理 files.example.com;重新加载网页时,页面发起的其他主机请求仍按各自命中的规则处理。

用 IP 能连,为什么不能验证我写的域名规则?

直接输入 IP 时,测试目标不再是原来的主机名,不能用这个结果确认 DOMAIN 是否命中。改用原主机名测试并核对连接记录;若浏览器报解析错误,先查 DNS,再重新验证域名规则。

怎么确认是 FINAL 生效,而不是前面某行直连?

在 Data 核对该连接对应的规则,而不只看 DIRECT。如果记录显示此前已命中域名或地址规则,就调整测试目标;只有前面的条件都不满足,才会到达 FINAL。

下载 Shadowrocket