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

用真实规则片段讲解自定义规则的书写格式、自上而下首条命中的优先级逻辑、FINAL 兜底的位置,以及三种策略各自的效果。

本文速览

自定义规则按列表从上到下检查,首条命中后采用该条策略,不会继续寻找“更精确”的规则。本文适合已经完成连接配置、需要处理域名例外与局域网访问的用户;先确认 Global Routing 使用 Config,再把例外放在宽泛规则前,将 FINAL 留在末尾。示例语法可用于理解各平台配置,具体操作以当前设备的 Home、Config、Settings 界面为准。

先确认规则生效条件

Shadowrocket(小火箭)的连接成功与规则生效是两件事。Home 中选定的连接决定可用的代理出站,Config 中启用的配置决定规则内容;Global Routing 则决定当前请求是否按配置分流。排查“写了规则却没变化”,应先核对这三处,而不是继续叠加规则。

本文以 Global Routing → Config 为前提。Proxy 是整体采用代理的姿态,Direct 是整体直连的姿态,不能用这两种姿态验证一份配置中的逐条分流结果。使用 Scene 时还要检查场景实际应用的设置,避免网络切换后测试条件已经变化。Global Routing 中的 Proxy 与规则行里的 PROXY 不在同一层级:前者是全局姿态,后者是单条规则的策略。

  1. 在 Home 确认当前连接可用;规则中的 PROXY 仍需要有效的代理出站。
  2. 进入 Config,确认选中的是准备修改的配置,而非名称相近的另一份文件。
  3. 把 Global Routing 设为 Config,再开始添加和验证规则。
  4. 测试期间保持网络环境不变;如启用了 Settings → On Demand,留意自动连接行为,但不要把它当作规则优先级开关。

下文只讨论配置中的规则判断,不修改协议参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等出站协议的连接设置,与 DOMAIN-SUFFIX 等分流条件应分开排查。

规则行的基本写法

配置文件里的规则写在 [Rule] 段。一条常见规则由规则类型、匹配值、策略三部分组成,使用英文逗号分隔;FINAL 不需要匹配值,因此只有类型和策略两部分。请保留关键字原文,不把英文逗号替换为中文逗号,也不要把域名写成带路径的完整网址。

[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

这里的 example.com 是说明用途的示例域名,不代表服务入口。不要直接用示例域名的访问结果判断线路质量。若现有文件已经有 [Rule] 段,应在该段内编辑对应条目,而不是反复追加段名或把规则粘到 [General] 中。

域名条件

DOMAIN
login.example.com,DIRECT
DOMAIN-SUFFIX
example.com,PROXY
匹配值
填写域名,不带 https://、端口或路径

DOMAIN 精确匹配;DOMAIN-SUFFIX 覆盖指定域名及其子域名。

地址与兜底

IP-CIDR
192.168.0.0/16,DIRECT,no-resolve
GEOIP
CN,DIRECT
FINAL
PROXY

IP 条件处理目标地址;FINAL 处理此前未命中的请求。

no-resolve 是 IP 类规则可用的附加选项,用于避免仅为匹配该条规则而触发域名解析。它不是“关闭所有 DNS”,也不保证一个仅有域名、尚无目标 IP 的请求能命中该网段。域名条件与 IP 条件依赖的信息不同,测试时需要区分。

优先级由位置决定

规则列表不是先给域名、网段、地理位置各打一个分数,再挑选最精确的条件。基本逻辑是从上到下检查:第一条满足条件的规则决定策略。把精确域名放在宽泛后缀之后,精确规则也可能永远没有执行机会。

收到新请求 读取首条规则 逐条检查条件 首条命中停止 执行对应策略

以上一节的列表为例,请求 login.example.com 时先命中 DOMAIN,因此采用 DIRECT;请求 static.example.com 时跳过首条,再命中 DOMAIN-SUFFIX,因此采用 PROXY。若把两行交换,login.example.com 已经符合 example.com 的后缀条件,会在前面被送往 PROXY,后面的 DOMAIN 不会再把它改成 DIRECT。

请求目标首条命中采用策略判断依据
login.example.comDOMAINDIRECT精确例外位于后缀规则之前
static.example.comDOMAIN-SUFFIXPROXY属于 example.com 的子域名
192.168.1.20IP-CIDRDIRECT目标地址位于 192.168.0.0/16
其他目标GEOIP 或 FINAL按首条命中决定先检查地址归属,未命中再到兜底

结论:先移动例外,再增加规则

已有精确规则却仍走错策略时,先找它上方是否存在覆盖同一目标的宽泛条件;把例外移到该条件之前,再发起新连接验证,不要在列表末尾重复追加同一条。

FINAL 放在规则末尾

FINAL 不再检查某个域名或网段,而是接住执行到这里的剩余请求。因此它必须位于所有希望参与判断的规则之后。在 FINAL 下方写一个域名例外,语法看起来完整,也不会让这个例外获得执行机会。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
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
FINAL,PROXY

这份片段展示“特定拒绝、域名例外、域名通则、私有网段、最终策略”的顺序,但不是适合所有环境的通用配置。如果一个 example.com 子域名实际解析到私有地址,它仍可能先命中上方的域名规则;如需求是让私有地址优先直连,就需要结合 DNS 与目标地址可见性重新安排顺序。

1 条
首条命中决定本次规则匹配结果
3 种
本文使用 PROXY / DIRECT / REJECT 策略
末尾
FINAL 位于所有待检查条件之后

FINAL,PROXY 表示未命中前述条件的请求采用代理;FINAL,DIRECT 则表示其余请求直连。它们没有普遍适用的优劣,应根据默认出站需求选择。需要修改默认策略时,替换原有 FINAL,而不是保留多条互相冲突的 FINAL。

区分三种执行策略

规则类型回答“哪些请求符合条件”,策略回答“符合后怎么处理”。修改策略不会改变匹配范围。例如把 DOMAIN-SUFFIX 的 PROXY 改成 REJECT,影响的是这个后缀覆盖的所有目标,而不是只影响某一张网页中的某个资源。

策略作用验证重点
PROXY经配置使用的代理出站发送请求确认出站可用,不能只看规则是否命中
DIRECT由本地网络直接连接目标确认当前网络能访问目标及其地址
REJECT拒绝匹配请求对应请求失败通常符合预期,不是代理延迟变高

DIRECT 不等于关闭 Shadowrocket 的连接开关,也不等于在 Global Routing 中切换为 Direct。连接保持开启时,不同请求仍可分别命中 DIRECT、PROXY 或 REJECT。REJECT 也不是隐藏网页元素的规则;若页面所需的脚本、登录接口或图片域名被拒绝,页面可能部分加载失败。

保存与验证的顺序

编辑前先保留原配置,优先在副本上验证。远程配置更新可能覆盖本地改动;服务商的连接订阅更新与规则配置更新也不是同一操作。订阅链接从你的服务商处获取,不要为了调整一条域名规则而重新导入全部连接。

  1. 记录测试条件。记下目标域名、当前网络、Global Routing 姿态和当前使用的配置,避免同时改变多个变量。
  2. 编辑生效文件。在 Config 找到当前配置,使用其编辑入口检查 [Rule];将例外插到覆盖它的规则之前。
  3. 检查语法。核对英文逗号、规则关键字、域名和网段;FINAL 只写策略,不添加空的匹配字段。
  4. 保存并确认启用。保存后再次核对 Config 中选中的文件。若修改后仍保留旧连接,可断开再连接以排除旧会话影响。
  5. 重新产生请求。关闭目标页面的旧连接后重新访问,在当前平台提供的连接记录或日志中核对目标、命中规则和出站策略。
  6. 只改一个条件复测。若结果不符,先调整规则位置,再检查 DNS 和出站,避免同时更换协议、网络和整份配置。

验证应以新连接为对象。浏览器连接复用、页面缓存和应用后台长连接,都可能让保存后的规则没有立即体现在画面上。一个页面还可能访问多个域名:主文档直连,不代表图片、接口和视频连接也使用相同策略。

常见规则问题

已经写了 DIRECT,为什么还走 PROXY?

先到 Home 检查 Global Routing 是否为 Config,再到 Config 确认启用文件。随后检查 DIRECT 上方是否有 DOMAIN-SUFFIX、GEOIP 或 FINAL 先命中;把必要的精确例外前移,保存后用新连接复测。

DOMAIN-SUFFIX 要写星号吗?

匹配 example.com 及其子域名时写 DOMAIN-SUFFIX,example.com,PROXY 即可,不写 *.example.com,也不带网址路径。只针对 login.example.com 时,改用 DOMAIN,并放在宽泛后缀之前。

加了私有网段规则,为什么局域网域名仍打不开?

先区分“直接访问 192.168.1.20”和“访问解析到该地址的域名”。检查局域网 DNS 是否能解析该域名,以及上方域名规则是否提前命中。带 no-resolve 的 IP-CIDR 不会单独为匹配而触发解析,必要时为已知局域网域名添加更靠前的 DOMAIN 例外。

更新配置以后,自定义规则怎么不见了?

检查被更新的是远程规则配置还是 Home 中的连接订阅。如果远程配置覆盖了本地文件,恢复事先保存的副本,再核对新增规则;不要假定手动改动会自动合并到远程来源。长期使用前应明确自己的配置保存与更新方式。

需要查询更多条件与配置格式,可继续阅读规则参考;对 Config、Global Routing 或 DNS 的含义不确定时,先查阅术语手册。先把少量规则的命中结果验证清楚,再逐步扩展列表,更容易定位覆盖与顺序问题。

下载 Shadowrocket