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

本文说明规则的匹配顺序:按从上到下逐条比对,命中即停。并说明 FINAL 兜底的作用,以及三种策略各自适合放哪类域名与 IP。

本文速览

适用于已经有自己的服务商配置、需要调整 Shadowrocket 分流行为的用户。先确认 Global Routing 使用 Config,再按“具体例外在前、宽泛条件在后、FINAL 最后”编排规则。下文用保留示例域名与私有网段说明语法,并给出保存、测试和恢复的操作顺序;示例仅用于解释匹配行为,不是可直接覆盖现有配置的完整文件。

一、先确认 Global Routing,再检查规则

Shadowrocket(小火箭)的连接状态与规则是否被采用是两件事。Home 中的连接开关用于建立连接,Config 管理配置文件,Settings 提供应用设置。已经连接,不代表当前正在按自定义规则分流;排查前应先检查 Home 中的 Global Routing。

4 种
Global Routing:Proxy / Direct / Config / Scene
3 类
本文策略:PROXY / DIRECT / REJECT
1 条
每次规则判断采用首条命中的规则

测试本文规则时,将 Global Routing 设为 Config,并确认 Config 中实际启用的是刚修改的文件。Proxy 表示使用全局代理姿态,Direct 表示使用全局直连姿态;两者不能用来验证配置中每一条分流规则。Scene 按已配置的场景选择相应行为,也应先核对场景结果,不能直接等同于 Config。

  1. 在 Home 核对当前选中的可用连接,保留用户已有的服务商参数。
  2. 进入 Config,确认启用的配置文件,并先备份原内容。
  3. 回到 Home,将 Global Routing 设为 Config,再建立新请求测试。
  4. 测试期间保持网络、所选连接和目标地址不变,每次只调整一处规则。

Settings → On Demand 控制的是满足条件时是否自动发起或恢复连接,不负责改变规则先后顺序。如果测试时发现连接被自动恢复,应检查该项;不要通过反复调整 On Demand 来解决域名命中错误。

二、规则从上到下检查,命中后停止

规则不是按“看起来更精确”自动排序。对于当前可供匹配的请求信息,Shadowrocket 按配置顺序逐条检查,第一条符合条件的规则决定策略,后面的规则不再参与这次判断。精确域名写在宽泛后缀规则下面,也不会自动取得更高优先级。

新请求 可用目标信息 按序检查 首条命中 执行策略
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

在这段示例中,访问 login.example.com 会先命中第一行域名规则,采用 DIRECT;访问 docs.example.com 则命中第二行,采用 PROXY。如果把第二行放在第一行前面,login.example.com 也属于 example.com 的后缀范围,便会先采用 PROXY。

实际网页通常连接多个主机名。首页走 DIRECT,并不表示页面中的图片、登录接口和视频请求也走 DIRECT。判断时应查看出问题的具体请求,而不是只根据浏览器地址栏中的主域名修改规则。

三、PROXY、DIRECT、REJECT 的用途与边界

规则行通常由规则类型、匹配值、策略构成,字段之间用英文逗号分隔。PROXY、DIRECT、REJECT 是策略,不是协议;Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等连接协议解决的是另一层问题。将规则改成 PROXY 不会修复错误的服务器端口或认证参数。

策略处理方式适用条件与限制
PROXY交给代理出口处理。用于需要代理的目标;仍依赖所选连接可用及服务商允许访问。
DIRECT通过当前网络直接访问。用于已确认可直连的服务或局域网目标;仍受本地网络与系统权限影响。
REJECT拒绝匹配的连接。用于明确需要阻止的目标;不是“失败后自动换线路”。

例如,对局域网设备可以使用精确 IP 规则;对一个确认需要阻止的示例主机名,可以使用精确域名拒绝规则。先用范围较小的条件验证,再考虑是否扩大到整个域名后缀,避免误伤同域名下的登录或静态资源。

[Rule]
IP-CIDR,192.168.1.20/32,DIRECT,no-resolve
DOMAIN,blocked.example.net,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

192.168.1.20/32 仅表示一个 IPv4 地址。如果设备在该地址的 8080 端口提供服务,访问时仍需使用正确端口;这条 IP-CIDR 规则本身没有限制端口,也不能让尚未开放的端口变得可达。涉及自定义策略组时,还需要核对策略名称与组内选择,不能仅凭规则末尾的文字判断最终出口。

四、DOMAIN-SUFFIX、IP-CIDR 与 GEOIP 的编排

域名规则与 IP 规则的输入不同。DOMAIN-SUFFIX 依赖可用的域名信息;IP-CIDR 判断地址是否属于指定网段;GEOIP 根据 IP 地理数据库分类。一个域名的内容语言、企业所在地与其解析出的 IP 所属地区不是同一概念,因此不能用 GEOIP 代替精确的域名需求。

域名匹配示例

精确主机
DOMAIN,login.example.com,DIRECT
域名后缀
DOMAIN-SUFFIX,example.com,PROXY
放置顺序
精确例外在前,后缀范围在后。

域名字段不填写 URL 路径,示例域名不代表可用服务。

地址匹配示例

私有网段
IP-CIDR,192.168.1.0/24,DIRECT,no-resolve
地区分类
GEOIP,CN,DIRECT
末尾兜底
FINAL,PROXY

IP 规则需具备目标地址;地区分类结果受所用数据库影响。

192.168.1.0/24 表示该 IPv4 子网,范围比 192.168.1.20/32 更宽。只有实际局域网使用这个子网时才有对应意义,不能把所有家庭或办公网络都视为同一地址范围。局域网不可达时,还应检查设备地址、网络隔离及系统的本地网络访问权限。

no-resolve 表示不要为了这条 IP 规则主动发起域名解析;请求目标本身是 IP 或已经有可用地址时,仍可据此判断。它不是“关闭所有 DNS”,也不保证任何带域名的请求都会命中这条网段规则。如果依赖 IP 分类进行分流,需同时确认请求的目标信息和 DNS 行为。

五、FINAL 放在末尾,决定未命中请求的去向

FINAL 是兜底规则,不需要域名或网段匹配值。其常见写法为 FINAL,PROXY 或 FINAL,DIRECT。只有前面的规则都未命中,请求才到达这里;如果把 FINAL 提到中间,后面的普通规则就失去了参与匹配的机会。

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

这段规则片段按顺序处理精确例外、阻止目标、指定域名、局域网与地区分类,最后让剩余请求采用 PROXY。它只演示规则顺序,不包含完整的连接、DNS 或策略组设置。不要直接用它覆盖已有配置中的其他区段。

兜底写法未命中前文时调整前核对
FINAL,PROXY进入代理出口。是否接受未知目标也经代理处理,以及当前连接是否可用。
FINAL,DIRECT使用当前网络直连。需要代理的域名是否已经被前面的规则覆盖。
FINAL,REJECT拒绝剩余请求。是否明确采用允许列表模式,并已覆盖必要依赖。

FINAL 不是故障转移。命中 FINAL,PROXY 后,如果所选代理不可用,不应预期自动改成 DIRECT;同样,前面的 DIRECT 规则连接失败,也不会继续向下寻找 FINAL。规则判断与连接成功与否应分开排查。

六、保存后按单个请求验证,异常时恢复

修改前保存原文件,修改后确认文件已经保存并处于启用状态。测试应建立新连接:已存在的长连接可能继续使用原路径,浏览器缓存也可能让页面看起来没有变化。需要重新连接时,先留意正在进行的下载或通话,避免中断业务。

  1. 先只添加一条精确域名规则,例如 DOMAIN,login.example.com,DIRECT,放在已有宽泛规则之前。
  2. 确认 Home → Global Routing 为 Config,重新发起该主机名的新请求。
  3. 在应用的连接记录或日志中核对目标主机、命中规则与实际策略;不要把延迟测试结果当作分流证据。
  4. 如果命中符合预期但连接失败,转查 DNS、目标端口、所选连接和服务商参数,不再盲目移动规则。
  5. 若修改影响其他服务,恢复备份,再把规则范围缩小后重新测试。

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

先检查 Home → Global Routing 是否为 Config,再检查 DIRECT 上方是否有已命中的 DOMAIN-SUFFIX、规则集或其他宽泛规则。把精确例外移到覆盖它的规则前,保存后用新请求验证;同时确认记录中的主机名就是修改的目标。

把 FINAL 改成 DIRECT,指定网站还是不能直连?

FINAL 只处理前面未命中的请求。先看是否被较早的 PROXY 或 REJECT 规则处理;如果需要覆盖它们,应在前面添加目标域名的精确规则,而不是继续修改末尾兜底。

订阅刷新以后,自定义规则怎么不见了?

先区分刷新的是 Home 中的连接订阅,还是 Config 中的远程配置。前者主要更新连接列表,不等于重写规则;后者更新时可能替换文件内容。需要保留定制时,先备份并另存为本地配置,再核对当前启用文件,避免直接在会被替换的远程内容上反复修改。

一个网站要添加整组域名吗?

先从失败请求记录确认依赖。登录接口、静态资源与媒体地址可能属于不同域名,按实际目标逐项补充;不要因为一个请求失败就放宽成大范围后缀规则,也不要将包含路径的完整 URL 填入 DOMAIN。

规则决定路径,不提供线路

本文以用户已有自己的服务商与订阅为前提。本站不提供、不销售、不推荐节点或订阅。客户端买断 ≠ 线路套餐;规则命中正确后,仍需分别确认本地网络、服务商连接与目标服务是否可用。

免费下载 Shadowrocket