改出站策略用 [Rule],改域名对应的地址用 [Host],改 URL 路径用 [URL Rewrite],调整整个配置的解析等通用行为用 [General]。本文用 iPhone / iPad 的 Home 和 Config 演示核对步骤;在 Mac、Windows、安卓或 Linux 上阅读配置时,可对照段名和规则语法,不必套用相同的点按路径。
01. 确认当前 Config 与 Global Routing
.conf 是分段的纯文本配置。方括号标题标明后续各行属于哪一段:例如,同样写了一个域名,放在 [Rule] 中是匹配条件,放在 [Host] 中则是地址映射的键。下面各段是用于对照的独立片段,不要用它们整份覆盖现用配置。
- 打开 Config,记下当前选用的文件名并保留原件。另存副本后再编辑;如果现有文件里已经有对应段名,将新行加进该段,不要为了粘贴片段再写一遍段标题。
- 在 Config 中确认选用的是改过的副本,再回到 Home,把 Global Routing 设为
Config。测试[Rule]时,不要停在Proxy或Direct,否则不能用当前请求来验证逐条分流的结果。 - 保持连接开启,用同一个测试目标分别比较修改前后的结果。每次只改一个段落中的一个条件;同时改 DNS、规则和重写时,即使页面恢复正常,也无法确认是哪项修改起了作用。
02. [General]:全局参数与 DNS 基线
[General] 大多用 键 = 值 的格式。它描述的是配置的通用行为,不是特定网站的出站选择。排查解析问题时,先记录原来的 dns-server 值,再决定是否调整;不要为了修复一个域名而顺手替换整段。
[General]
dns-server = system
system 表示采用系统 DNS,而不是在这一行指定某个固定的解析器。切换 Wi-Fi 与蜂窝网络后,系统使用的解析环境可能不同;比较两次结果时,应先固定网络,再检查同一个域名。域名已解析出地址也不代表目标端口可达,或者服务端一定会接受连接。
- 若多个域名在修改
dns-server后同时出现解析异常,先恢复原值,在同一网络下复查。 - 若只有一个自管域名解析到了旧地址,先检查
[Host]是否还保留该名称的映射,不要仅凭这一个域名判断全局 DNS 失效。 - 若域名能解析,但访问走错出站,转查
[Rule]和 Global Routing;更换解析器不是修正规则顺序的办法。
03. [Rule]:首条命中、IP 条件与 FINAL
普通规则把匹配类型、条件和策略用半角逗号分隔。Shadowrocket 从上到下检查,命中一条后采用该条的策略,不会继续寻找写得更具体的规则。FINAL 没有单独的匹配条件,用于处理此前都未命中的请求,应放在规则段末尾。
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY
逐行判断预期出站
域名匹配
DOMAINapi.example.com精确命中首行,采用PROXY。DOMAIN-SUFFIXwww.example.com命中后缀规则,采用DIRECT。- 顺序变化
- 把后缀规则移到顶部,
api.example.com也会先命中该行,改走DIRECT。
同一后缀下有例外域名时,把精确匹配放在宽泛匹配前。
地址匹配与兜底
IP-CIDR- 对能够取得的目标 IP 按网段匹配;以
192.0.2.10为目标 IP 的请求符合示例网段。 no-resolve- 不为匹配这一条规则而主动解析域名;并不是全局关闭 DNS。
FINAL- 仅在前面的规则都未命中时采用
PROXY;实际验证代理出站需要已有可用服务。
示例网段保留用于文档,只用来推演匹配,不用来测试公网连通性。
单个域名走错出站,先找第一条命中
先从规则段顶部查找能覆盖该域名的精确或后缀规则。若宽泛规则挡在例外前,只把例外上移,再用原域名验证;不要改动 FINAL,否则还会改变其他未命中请求的出站。
GEOIP 也是按目标 IP 判断,例如 GEOIP,CN,DIRECT 表示匹配被地理 IP 数据归为 CN 的目标。它不读取网页语言,也不根据域名后缀判断。若希望精确域名例外优先生效,将例外放在可能覆盖它的 IP 类规则之前。
04. [Host]:固定域名解析地址,不改 URL
[Host] 可为指定名称配置本地映射。下面这行用文档保留地址演示语法:左侧只有主机名,不带协议、端口或路径;右侧是目标 IP。它不等于在 [Rule] 中给这个域名指定 DIRECT。
[Host]
lab.example.com = 192.0.2.10
- 需要验证时,把示例域名和 IP 换成自己管理的测试名称及可达服务器地址。对照服务端访问记录确认请求是否到达预期服务器,而不是只看浏览器地址栏;映射成功时,地址栏仍可以显示原域名。
- 如果使用已有代理服务,还要区分目标名称由本地解析,还是交给远端解析。排查本地映射时,先使用自己可控的直连测试目标,避免把远端解析结果当作本地映射失效。
- 若服务器已收到请求但返回证书错误,检查证书是否覆盖 URL 中原来的主机名。改变解析地址不会改变 HTTPS 校验的名称,也不会把服务端的其他端口改成 URL 所指定的端口。
05. [URL Rewrite]:按 URL 匹配并返回重定向
[URL Rewrite] 针对客户端能看到完整 URL 的请求。示例从左到右是正则表达式、目标 URL 和重定向类型:将明文 HTTP 的 /old 请求临时重定向至同一主机的 /new。它不承担 DNS 映射,也不会用 DIRECT 或 PROXY 作为重写目标。
[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
\.匹配字面上的点,^和$限定整个 URL。/old/和/old?from=test均不匹配,目标/new也不会再次命中这一行。- 验证时使用自己管理且能接收明文 HTTP 的测试站点。对比
/old与/old/的首个响应;前者预期收到302与指向/new的Location,后者不应由这条规则重定向。只看浏览器最终地址容易把自动跟随跳转后的结果误认为首个响应。 - 若浏览器先把
http://升级为https://,请求就不符合示例表达式。HTTPS 的路径在加密请求中,仅凭域名这一信息无法判断路径是否为/old;不要用此 HTTP 示例判断 HTTPS 路径重写是否可用。
06. 修改不生效时的检查顺序
保存副本了,怎么还是按旧规则走?
先在 Config 核对当前选中的文件名,再到 Home 检查 Global Routing 是否为 Config。对同一个目标发起新请求;如果连接仍在复用,结束原请求后再测。仍不符合预期时,从规则段顶部查第一条能覆盖该目标的规则。
Host 已改,为什么地址栏没变?
[Host] 改的是解析地址,不是 URL。到目标服务器上核对新请求是否到达;如果想把地址栏中的 /old 改为 /new,应验证重定向,不要把路径拼进 [Host] 的键名。
原来能访问的网站改完也打不开了,先恢复哪一项?
在 Config 中重新选用编辑前的原件,保持同一网络和测试地址做一次对照。如果原件可用,从副本里撤回最后一项改动,再逐项验证。若原件也失败,先检查 Home 的连接状态和当前网络,不要继续改 FINAL 或叠加 DNS 设置。