Shadowrocket 自定义规则写法:从上到下匹配、FINAL 兜底与 PROXY / DIRECT / REJECT

讲解 Config 里规则的书写格式与匹配顺序:规则命中即停,FINAL 作为最后兜底。文中用 DOMAIN-SUFFIX、IP-CIDR、GEOIP 示例说明三种策略各自的效果。

本文速览

Shadowrocket(小火箭)的规则按配置顺序检查,第一条命中的规则决定处理策略,FINAL 负责其余连接。本文适合已有自己的服务商与订阅、需要修改 Config 的用户;以 iPhone / iPad 界面为操作参照,说明规则语法、顺序、保存启用与验证方法。Mac、Windows、安卓、Linux 用户可参考相同规则概念,具体编辑入口以各平台界面为准。

1. 先确认 Global Routing 使用 Config

自定义规则不是保存后就一定参与连接处理。先在 Home 核对 Global Routing:需要按配置中的规则分流时,选择 Config。Proxy 是全局代理姿态,Direct 是全局直连姿态,不能用它们的访问结果判断某条 Config 规则是否命中。Scene 用于场景切换,也不等同于某一条规则的策略。

Home 中选中的服务器与 Config 中启用的配置承担不同任务:前者提供代理出站所需的连接参数,后者描述流量如何分配。把规则写成 PROXY 不会生成可用服务器,也不会补全地址、端口或密码。订阅链接应从你的服务商处获取。

4 项
Global Routing:Proxy / Direct / Config / Scene
3 种
本文策略:PROXY / DIRECT / REJECT
1 条
基础示例末尾保留一条 FINAL

2. 理解从上到下匹配与命中即停

规则列表不是把所有匹配结果合并后再选择,也不是自动把“更具体”的规则放在前面。对于参与规则判断的连接,应用沿列表向下检查;某条规则一旦命中,就采用该条指定的策略,不再用后面的规则覆盖。应把例外放在宽泛规则之前,把 FINAL 放在最后。

连接进入 首条规则 逐条判断 首次命中 执行策略
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY

在这个顺序下,api.example.com 先命中 DOMAIN,采用 DIRECT;www.example.com 不满足第一条,但满足第二条,采用 PROXY。若把 DOMAIN-SUFFIX 提到第一行,api.example.com 也会先被后缀规则匹配,下面的精确例外便没有机会生效。

3. 规则字段与 PROXY / DIRECT / REJECT

文本配置的规则写在 [Rule] 段内。常见形式为“规则类型,匹配目标,处理策略”,使用英文逗号。FINAL 是例外,形式为 FINAL,PROXY,不要写成带一个空目标字段的三段式。图形编辑界面会把这些字段拆开显示,不需要把整行都塞进域名输入框。

域名与末尾规则

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

精确例外在前,宽泛后缀在后,FINAL 位于末尾。

三种处理策略

PROXY
交给代理出站处理
DIRECT
直接连接目标,不经代理服务器转发
REJECT
拒绝匹配的连接

策略是处理结果,不是协议名,也不替代服务器参数。

PROXY 的实际出站还要结合当前服务器与配置中的策略设置核对;如果使用自定义策略组,组名必须与配置定义一致。DIRECT 并不等于系统 VPN 开关关闭,只表示这条连接采用直连处理。REJECT 适合明确需要阻断的目标,但不要一开始就用于覆盖范围过大的域名后缀,否则登录、图片或验证请求可能一起失败。

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

这组规则里的 blocked.example.com 会先被拒绝,即使后面存在允许同一后缀走 PROXY 的规则也不会改变结果。示例域名只用于说明语法,不代表可用线路或测试服务。

4. IP-CIDR、GEOIP 与 DNS 判断边界

域名规则判断名称,IP-CIDR 判断目标地址是否属于指定网段,GEOIP 则依赖 IP 地理数据库分类。三者不是互相替代的写法。访问域名时,后续 IP 类规则可能涉及 DNS 解析;若客户端没有可用域名信息,域名规则也无法仅凭目标 IP 还原所有原始主机名。

规则示例判断依据注意事项
DOMAIN-SUFFIX,example.com,PROXY目标域名后缀不填写 https:// 或 URL 路径。
IP-CIDR,192.168.0.0/16,DIRECT,no-resolveIPv4 网段覆盖 192.168.0.0 至 192.168.255.255。
GEOIP,CN,DIRECT目标 IP 的数据库分类仅依据目标 IP 的数据库记录,不依据域名文字或账号地区。
FINAL,PROXY此前均未命中放在规则段末尾。

no-resolve 表示不为匹配该条 IP 规则而主动触发域名解析,不表示整个应用停用 DNS,也不保证这条规则一定命中。对于直接以 192.168.1.20 为目标的连接,上述网段条件可以判断;对于尚无可用 IP 的域名连接,不能把这条带 no-resolve 的规则当作必定生效的域名规则。

5. 在 Config 保存、启用并验证规则

修改前先保留当前配置副本,尤其是从远程地址获取的配置。服务器订阅更新与远程 Config 更新不是同一件事:前者主要更新服务器资料,后者可能替换规则内容。不要仅凭“更新成功”就认为手动修改仍然存在,应重新打开生效配置核对。

  1. 确认配置。进入 Config,找到正在使用的配置,保留副本;不要直接清空原文件中的其他配置段。
  2. 进入编辑。打开该配置的编辑入口,在规则列表中添加条目,或在文本编辑中定位 [Rule] 段。只粘贴需要的规则,避免重复插入多个同名配置段。
  3. 检查顺序。把精确域名例外、明确的局域网规则放在相应宽泛规则之前;检查是否有更靠前的规则已经覆盖目标。
  4. 保存并启用。保存编辑结果,在 Config 确认该配置已选为当前配置;回到 Home,将 Global Routing 设为 Config 并确认连接已开启。
  5. 新建连接测试。关闭目标页面后重新打开,必要时重新建立连接;已有的长连接不能代表新规则的判断结果。
  6. 核对记录。查看应用内连接记录中的目标域名、IP、命中规则与策略信息;如果测试异常,先恢复副本,再缩小修改范围。

6. FINAL 选 PROXY 还是 DIRECT

FINAL 没有脱离配置目标的统一答案。FINAL,PROXY 表示其余未分类连接交给代理;FINAL,DIRECT 则表示其余连接直连,只让明确命中的目标走其他策略。两者都会放大前面规则遗漏的影响,选择时应先明确“未列出的目标”需要如何处理。

初次排查时不建议用 FINAL,REJECT 作为通用模板,因为遗漏的目标都会被拒绝。更稳妥的做法是保留已知可用的兜底,仅对一个明确目标添加 REJECT,再通过连接记录确认影响范围。

7. 自定义规则常见问题

规则写了,为什么还是全部走代理?

先在 Home 检查 Global Routing 是否为 Proxy;需要规则分流时切换到 Config。随后确认 Config 中启用的是刚才编辑的文件,重新发起目标连接,再看是否被更靠前的宽泛规则命中。

DOMAIN-SUFFIX 里要不要写网址前缀和端口?

不要。目标字段写 example.com,不写网址前缀、路径或 :443。DOMAIN-SUFFIX 判断域名后缀,不区分同一域名的 80 与 443 端口,也不能按网页路径分流。

改成 DIRECT 后页面能开,是否说明规则已经正确?

只能说明此次访问出现了可用结果。还要核对连接记录里的命中规则与策略,并重新测试该页面的资源请求。缓存、已有连接和不同子域名都会影响观察,不能只看页面是否显示。

更新之后自定义规则不见了怎么办?

先在 Config 检查当前文件和保留副本,确认是否更新了远程配置或切换了文件。恢复副本后重新启用,再决定把自定义规则维护在本地副本中;不要反复刷新远程文件来恢复手工编辑内容。

PROXY 已命中但连接超时,还需要改规则吗?

先保留已验证的规则,回到 Home 检查所选服务器及 Connectivity Test,再核对服务商给出的地址、端口和协议参数。规则决定去向,不会修复服务器不可达、认证错误或传输参数不一致。

下载 Shadowrocket