在 Global Routing 选用 Config 时,先命中的规则决定当前连接的策略。本文适合第一次编辑规则,或遇到新增规则没有生效的读者。读完可以区分域名、地址和兜底规则,判断一条请求会命中哪一行,并在改动后验证结果。
规则顺序:从第一条匹配到 FINAL
先看规则在文件里的位置,再看它写得有多具体。Shadowrocket 按当前配置中的顺序匹配,命中一行就使用该行指定的策略。规则不会因为使用了 DOMAIN 而自动排到 DOMAIN-SUFFIX 前面。要为单个主机设置例外,就把例外放在能覆盖该主机的宽范围规则之前。
PROXY:连接交给代理出站。选定的代理服务器是否可用,决定命中规则后的代理连接能否建立。DIRECT:连接由设备当前网络直接发出。命中DIRECT并不说明目标地址一定可以访问。REJECT:拒绝匹配的连接。应用可能只显示连接失败,不一定会告诉你是哪一行规则造成的。FINAL:接住前面没有匹配的连接。写法是FINAL,DIRECT或FINAL,PROXY,不填域名和地址;应放在[Rule]的最后。
规则只给当前连接选策略,不给整个应用贴上固定标签。同一次页面加载可能分别连接页面主机、静态资源主机和登录主机,这些连接可以命中不同的规则。排查时要找出失败请求对应的主机名,而不只是查看地址栏里的主机名。
域名规则:完整主机名、域名后缀与关键词
域名规则的匹配值只写主机名或关键词。以 https://www.example.com:443/docs 为例,主机名是 www.example.com;https://、端口 443 和路径 /docs 都不写进规则值。以下结果以连接能取得目标主机名为前提。
| 规则与匹配值 | 命中示例 | 不命中示例 |
|---|---|---|
DOMAIN,example.com | example.com | www.example.com |
DOMAIN-SUFFIX,example.com | example.com、www.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,example | example.net、notexample.com | www.test.invalid |
只调整一个主机时用 DOMAIN;需要覆盖根域名和各级子域名时用 DOMAIN-SUFFIX。后缀匹配有域名标签边界,不是简单地判断字符串是否以 example.com 结尾。DOMAIN-KEYWORD 则查找主机名中出现的字符串,不要求整段标签相等;如果目标只是一个已知域名,写关键词容易顺带匹配其他域名。
地址规则:IP-CIDR 网段与 GEOIP 地区
IP-CIDR 判断目标 IPv4 地址是否落在指定网段,GEOIP 则按目标 IP 在地理地址库中的归属做判断。地区编码不代表域名后缀、网站注册地或设备所在地。
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve中的/24表示前 24 位固定。192.0.2.7命中,192.0.3.7不命中。只匹配192.0.2.7这一个 IPv4 地址时,可写192.0.2.7/32。这里用的是文档保留网段,只用于演示规则,不用于测试公网连通性。GEOIP,CN,DIRECT表示目标 IP 在地址库中归为CN时直连。域名以.cn结尾不保证命中,也不能根据访问者的所在地推断结果。同一域名在不同网络下可能解析到不同 IP,因而出现不同的地区匹配结果。no-resolve表示不为了这一行主动把域名解析成 IP;如果此时已有可用于匹配的目标 IP,仍可按网段判断。它不代表关闭整个配置的 DNS,也不保证后面的规则不会使用解析结果。
如果需求是让某个主机始终走同一个策略,不要用它某次解析得到的 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
api.example.com同时符合前三行的域名条件,但第一行先命中,结果是REJECT。若将后缀规则移到第一行,结果就会变成PROXY。www.example.com不符合第一行,第二行匹配后缀,结果是PROXY。即使其目标 IP 归属为CN,后面的GEOIP也不会覆盖已经命中的策略。example.net不符合前两行的域名条件,在第三行命中关键词并走DIRECT。若误将关键词放在后缀规则前面,www.example.com也会先走DIRECT。- 目的地址直接写成
192.0.2.7时,可以命中第四行。未命中前五行的连接才会走FINAL,DIRECT。这几行都可能给出DIRECT,所以单看策略名称不能区分是哪一行命中。
应用规则与验证结果
先确认测试所用的配置和分流姿态,再发起一条新连接。以下操作路径以 iPhone / iPad 界面为例。不要把保存规则当成测试完成:当前选中的配置、仍在复用的连接以及代理服务器状态,都会影响观察到的结果。
核对配置
打开底部的
Config,核对当前选中的配置文件。编辑前保留可恢复的副本,避免为一次测试改动多组现有规则。保存改动
将要验证的规则放在同一份配置的
[Rule]段。检查字段间是否使用英文逗号、例外是否排在宽范围规则之前,并保存。确认分流
返回
Home,打开Global Routing并选择Config。如果此前选的是Proxy、Direct或使用场景的Scene,先切到Config再按本文的规则顺序验证。测试新连接
在
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。