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

讲清规则按从上到下的顺序命中即停,FINAL 负责兜底,以及 PROXY、DIRECT、REJECT 三种策略的含义,附可直接照抄的规则排序示例。

本文速览

Shadowrocket 的规则列表不是按“越具体越优先”自动排序,而是从上到下找到首条匹配规则后执行策略。本文适合已经有可用配置、需要修改分流的用户;规则原理适用于 iPhone、iPad、Mac、Windows、安卓与 Linux,界面步骤以 iPhone / iPad 的 Home、Config 为参照。读完可按“例外在前、宽泛匹配在后、FINAL 最后”的顺序整理规则,并通过新连接验证实际结果。

一、先确认 Global Routing 使用 Config

规则没有按预期生效时,先检查运行姿态,不要立即重排整份配置。在 Home 打开 Global Routing,确认选择的是 Config,再到 Config 核对当前启用的配置文件。仅仅编辑或下载了某份配置,不代表它已经成为当前生效配置。

Global Routing 选项判断方式排查用途
Config按当前配置中的规则决定策略。验证本文的规则顺序时使用。
Proxy以代理姿态处理流量,而不是逐条验证本文的分流安排。可辅助判断代理出口是否可用,不能据此证明规则命中。
Direct以直连姿态处理流量。可辅助比较当前网络的直连表现。
Scene按已配置的场景设置运行。先检查场景关联的配置与条件,避免把场景切换误认成规则变化。

Settings → On Demand 决定何时按条件建立或断开连接,不负责给某个域名排列规则优先级。排查时应记录它是否启用,避免测试中网络切换引起连接状态变化;不要用反复切换 On Demand 代替检查当前配置。

二、首条命中即停止,不自动比较规则精细程度

对进入规则处理流程的新连接,Shadowrocket 按当前生效规则的先后顺序检查匹配条件。一旦命中,就执行该行指定的策略,后面的规则不再为这条连接重新投票。把精确域名写在宽泛后缀规则下面,并不会自动获得更高优先级。

新连接建立 读取生效规则 逐条匹配 首条命中 执行策略

例如希望 api.example.com 走代理,而 example.com 的其余子域名直连,就应先写精确匹配,再写后缀匹配。这里的域名是说明语法的示例,不是线路地址,也不用于验证代理性能。

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

如果交换前两条规则,api.example.com 会先命中 DOMAIN-SUFFIX,后面的精确规则便没有机会执行。“规则写得更细”只有配合正确位置才有意义。

三、区分规则关键字与 PROXY、DIRECT、REJECT

一条普通规则通常由“匹配类型、匹配值、策略”组成。前两部分决定是否命中,最后一部分决定命中之后如何处理。DOMAIN-SUFFIX 是匹配类型,PROXY 是策略,不能把它们当成同一层级的开关。

3 项
普通示例规则:类型、匹配值、策略
2 项
FINAL 示例:关键字、兜底策略
3 种
本文策略:PROXY / DIRECT / REJECT

匹配条件

DOMAIN
精确匹配指定域名,例如 api.example.com。
DOMAIN-SUFFIX
匹配域名本身及其子域名,不是任意字符串包含。
IP-CIDR
按目标 IPv4 地址所属网段匹配。
GEOIP
按目标 IP 的地理数据库归属匹配。

域名与 IP 是不同的匹配依据;IP 数据库的归属结果不一定代表运营主体所在地。

执行策略

PROXY
交给代理出口处理,仍需有可用的代理配置。
DIRECT
由当前网络直接连接目标,不代表请求被阻止。
REJECT
拒绝匹配的连接,访问失败可能正是预期结果。
FINAL
不是出口名称,而是接住前面未匹配流量的规则关键字。

自定义策略组名称须与当前配置一致;本文用 PROXY、DIRECT、REJECT 说明基本行为。

结论:先验证命中,再验证出口

如果记录显示已经命中预期规则,却仍然无法访问,就转查该策略对应的出口、DNS 与目标可达性,不要继续移动已正确命中的规则。

PROXY 不等于某一种协议。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 属于连接协议或隧道协议层面;换协议不能修复一条被更靠前规则遮住的规则。本文也不修改服务端口、认证信息或加密参数。

四、可复制的排序示例:例外、局域网、地域、FINAL

下面是用于理解排序的最小规则段。它先处理明确的域名例外,再处理私有 IPv4 网段,最后按 IP 归属与默认策略处理剩余目标。复制前先备份当前配置;应合并到已有的 [Rule] 段,而不是在文件末尾重复追加一个同名段。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
  1. 拒绝例外先出现:blocked.example.com 必须位于 example.com 后缀规则之前,否则会先被判为直连。
  2. 代理例外随后出现:api.example.com 也必须在宽泛后缀规则之前,才会执行代理策略。
  3. 私有地址单独处理:三个 IP-CIDR 范围覆盖常见私有 IPv4 地址,不代表覆盖全部特殊用途地址或 IPv6。
  4. 地域规则靠后:GEOIP,CN,DIRECT 根据目标 IP 数据判断,不能替代明确域名例外,也不能保证某个网站一定归入该行。
  5. 最后只留明确兜底:FINAL,PROXY 表示前面均未命中时交给代理出口。

no-resolve 表示不要仅为了检查这条 IP 规则而主动触发域名解析。若目标 IP 已经可用,仍可据此匹配;它并不是“关闭 DNS”。本例适合说明按字面 IP 访问局域网资源的情况,例如目标地址为 192.168.1.10。若希望某个内部域名稳定直连,应结合内部 DNS,并在前面添加明确的域名规则。

示例不是完整网络配置

以上内容只包含规则,不包含代理出口、DNS 或策略组定义。保留自己已可用的配置部分;示例域名用于说明匹配关系,替换为实际需要管理的域名后,再逐项测试。

五、FINAL 放最后,兜底策略按目标选择

FINAL 不带域名或网段条件。常用写法是 FINAL,PROXY 或 FINAL,DIRECT,不应写成 FINAL,example.com,PROXY。它位于前面时,后面的普通规则将无法接到剩余流量,因此不应依靠多条 FINAL 表达不同例外。

兜底写法适用意图检查重点
FINAL,PROXY未明确分流的目标默认代理。需要直连的内部资源是否已被前面的规则覆盖。
FINAL,DIRECT只有明确列出的目标代理,其余默认直连。需要代理的域名是否完整,是否遗漏登录或内容子域名。
FINAL,REJECT只允许前面明确匹配的连接,其余拒绝。适用于有意维护允许列表的配置;遗漏依赖域名会造成访问失败。

选择兜底策略时应先确定维护目标,而不是寻找一个对所有网络都正确的取值。一个网页可能同时请求主站、认证、图片与接口等多个域名;主站命中预期规则,不代表页面里的每个连接都采用相同策略。出现“能显示文字但图片失败”时,需要分别查看失败连接的目标与命中结果。

六、在 Config 修改后,用新连接验证

建议先在 Config 备份或复制当前配置,再编辑副本。确认进入的是配置内容编辑入口,而不是只修改显示名称;找到 [Rule] 段,按上述原则调整顺序并保存,然后把该配置设为当前使用项。不同平台的编辑入口呈现可能不同,核对的重点始终是生效文件与规则内容。

  1. 固定条件:在 Home 确认连接已建立,Global Routing 为 Config,测试期间保持同一网络与同一出口。
  2. 只改一处:一次只移动一条规则或改一个策略。保留修改前的顺序,便于回退。
  3. 发起新连接:关闭目标应用后重新打开,必要时重建 Shadowrocket 连接。已有长连接可能沿用建立时的处理结果,单次刷新不一定会新建连接。
  4. 查看匹配依据:在当前平台提供的连接记录或日志中核对目标域名、目标 IP、命中规则与策略;不要仅凭网页能否打开判断是否走代理。
  5. 核查依赖请求:如果主域名正确而登录失败,继续检查认证域名;如果直接访问 IP 与访问域名结果不同,继续检查 DNS 与 IP 类规则。
  6. 确认保存边界:更新远程配置前保留本地改动。远程配置重新下载可能覆盖文件中的手工规则;节点订阅更新与配置文件更新不是同一种操作。

需要补充订阅资料时,从你的服务商处获取。本文以已有可用出口为前提,规则编辑不产生新的连接资源。若想系统核对 Config、DNS 与 On Demand 的设置关系,可查阅选项手册;规则关键字可在术语表中对照。

七、规则优先级常见问题

精确域名规则已经加了,为什么还是直连?

先确认 Home → Global Routing 为 Config,再检查精确规则上方是否存在能覆盖它的 DOMAIN-SUFFIX、GEOIP 或其他宽泛匹配。将例外移到覆盖它的规则之前,保存并用新连接复测。

设成 REJECT 后网页打不开,是规则坏了吗?

若失败请求正好命中 REJECT,这属于该策略的预期行为。核对被拒绝的是需要屏蔽的目标,还是页面必须使用的认证或接口域名;只对误匹配项添加更靠前的例外,不要直接删除全部拒绝规则。

把 FINAL 改成 PROXY,为什么局域网访问也变了?

说明相关连接没有被前面的直连规则接住。检查访问方式是域名还是字面 IP、目标是 IPv4 还是 IPv6,以及内部 DNS 是否返回预期地址。本文的三个私有 IPv4 网段不覆盖 IPv6,不能把它们当作完整局域网策略。

更新之后规则又变回去,应该怎么保存?

先区分更新的是 Home 中的节点订阅,还是 Config 中的远程配置文件。若是后者,先备份本地文件并比较新的 [Rule] 内容,再重新合并自定义例外;不要假定远程文件更新一定保留手工编辑。

下载 Shadowrocket