Shadowrocket 配置文件 .conf 结构详解:[General]、[Rule]、[Host]、[URL Rewrite] 各段作用

逐段拆解 .conf 文件:[General] 放全局参数,[Rule] 规则自上而下匹配并以 FINAL 兜底,[Host] 做本地域名映射,[URL Rewrite] 改写请求地址,并配有示例片段。

本文速览

改出站策略用 [Rule],改域名对应的地址用 [Host],改 URL 路径用 [URL Rewrite],调整整个配置的解析等通用行为用 [General]。本文用 iPhone / iPad 的 Home 和 Config 演示核对步骤;在 Mac、Windows、安卓或 Linux 上阅读配置时,可对照段名和规则语法,不必套用相同的点按路径。

01. 确认当前 Config 与 Global Routing

.conf 是分段的纯文本配置。方括号标题标明后续各行属于哪一段:例如,同样写了一个域名,放在 [Rule] 中是匹配条件,放在 [Host] 中则是地址映射的键。下面各段是用于对照的独立片段,不要用它们整份覆盖现用配置。

原配置备份副本编辑配置选用请求验证异常回退
  1. 打开 Config,记下当前选用的文件名并保留原件。另存副本后再编辑;如果现有文件里已经有对应段名,将新行加进该段,不要为了粘贴片段再写一遍段标题。
  2. 在 Config 中确认选用的是改过的副本,再回到 Home,把 Global Routing 设为 Config。测试 [Rule] 时,不要停在 Proxy 或 Direct,否则不能用当前请求来验证逐条分流的结果。
  3. 保持连接开启,用同一个测试目标分别比较修改前后的结果。每次只改一个段落中的一个条件;同时改 DNS、规则和重写时,即使页面恢复正常,也无法确认是哪项修改起了作用。
4 段
本文拆解的配置段
1 条
分流取从上到下首条命中规则
302
本文重写示例使用的临时重定向状态码

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

逐行判断预期出站

域名匹配

DOMAIN
api.example.com 精确命中首行,采用 PROXY。
DOMAIN-SUFFIX
www.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
  1. 需要验证时,把示例域名和 IP 换成自己管理的测试名称及可达服务器地址。对照服务端访问记录确认请求是否到达预期服务器,而不是只看浏览器地址栏;映射成功时,地址栏仍可以显示原域名。
  2. 如果使用已有代理服务,还要区分目标名称由本地解析,还是交给远端解析。排查本地映射时,先使用自己可控的直连测试目标,避免把远端解析结果当作本地映射失效。
  3. 若服务器已收到请求但返回证书错误,检查证书是否覆盖 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 设置。

下载 Shadowrocket