本文适合正在阅读或修改 Shadowrocket 本地配置的用户。先确认当前启用的文件和 Global Routing,再根据现象找对应分段:连接走错路径看 [Rule],域名解析到错误地址看 [Host] 和 [General],需要按 URL 路径重定向才看 [URL Rewrite]。
.conf 分段与写法
方括号里的段名决定后续行按什么语法读取,一直到下一个段名为止。[General] 和 [Host] 都可以看到等号,但等号左边的含义不同:前者是设置项,后者是主机名。[Rule] 通常用英文逗号分隔类型、匹配值和策略;[URL Rewrite] 的重定向条目则用空白分隔匹配表达式、目标 URL 和动作。
给现有文件增加一条规则时,先找到原来的 [Rule] 段,再决定插入位置。不要把整段示例追加到文件末尾:末尾可能属于另一个分段,即使新行看起来像规则,也没有放在读取规则的位置。
在 Config 中编辑并启用文件
配置列表中能看到某个文件,不表示当前连接就在使用它。下面以 iPhone / iPad 的界面词为例。第一次修改时只动一行,保留修改前的文件副本,以便按同一测试条件恢复验证。
核对文件
打开
Config,确认要编辑的文件名,先保存一份未修改的副本。远程配置如果会更新,测试时使用本地副本,避免刷新后覆盖改动。编辑原文
在
Config点文件名,选择Edit Plain Text。找到目标段,只添加或调整一条配置,保留原来的英文标点和分隔符,然后保存。启用配置
返回
Config,点编辑后的文件名并选择Use Config。核对启用的是编辑后的文件,而不是用于回退的副本。重新发起请求
进入
Home→Global Routing→Config。用同一个目标重新建立连接;如果应用复用了旧连接,先结束原来的连接再测。
Config 既是配置页面的名称,也是 Global Routing 下的一种模式。前者用来选文件,后者决定是否按该文件的规则分流。排查 [Rule] 时,两个位置都要核对。
Config
推荐按所选配置中的规则决定连接策略。例外条目、后缀条目和 FINAL 的顺序会影响结果。
适合:验证已启用配置的规则是否命中。
Direct
使用直连模式。直连成功只能说明当前网络下目标可直连,不能证明配置里某一条 DIRECT 规则已命中。
适合:用同一目标单独检查直连是否可用。
Proxy
对客户端处理的连接使用代理模式。测试前确认 Home 已选中自己的服务,再用同一目标发起新连接。
适合:在不依赖分流规则的情况下检查代理路径。
[General] 与 [Host]:解析设置和单域名映射
[General] 存放配置级设置,例如 dns-server = system 指定使用系统 DNS。[Host] 可以为某个主机名指定地址。前者回答通常使用什么解析设置,后者回答由 Shadowrocket 处理解析时,这个名称是否有单独的映射。两者都不能代替 [Rule] 选择连接策略。
[General]
dns-server = system
[Host]
docs.example.com = 192.0.2.10
192.0.2.10 是文档示例地址,不用于连通性测试。上面的映射只写了 docs.example.com,没有写 api.example.com。验证映射时,仍用原来的主机名发起请求,不要把浏览器地址改成 IP;那会改变请求使用的主机名,HTTPS 的证书校验条件也可能随之改变。
按故障范围选择检查项
多个域名解析异常
- 检查
[General]中的dns-server,记录问题是否只在某个网络出现。 - 用相同配置分别在两个网络发起新请求,确认现象是否随系统 DNS 所处的网络变化。
只有一个主机名异常
- 检查
[Host]是否写了该完整主机名,尤其留意www和其他子域名。 - 在副本中移除该映射后重试同一名称,排除旧连接或缓存造成的干扰。
先分清是名称解析错了,还是地址正确但连接失败;两种现象对应的检查项不同。
[Rule]:从上到下匹配,首条命中生效
规则不会自动把更精确的条目排在前面。要让一个主机名成为后缀规则的例外,先写该主机名的 DOMAIN,再写覆盖范围较大的 DOMAIN-SUFFIX。未命中前序条目的连接交给末尾的 FINAL。
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
docs.example.com:命中首行,走DIRECT,不再检查后缀规则。api.example.com和example.com:不命中首行,命中第二行,走PROXY。实际使用前需在Home选定自己的服务。example.net:前两行均不匹配,按FINAL,DIRECT处理。
把前两条交换后,docs.example.com 会先命中 DOMAIN-SUFFIX,后面的精确条目便没有机会生效。示例中的 FINAL,DIRECT 只是这个配置的兜底选择。修改已有文件时,应先确认原来的兜底策略,不要为插入一条例外顺带改变其余连接的走向。
IP-CIDR 按目标 IP 所在的网段匹配,例如 IP-CIDR,192.0.2.0/24,DIRECT;GEOIP 按 IP 的地理归属信息匹配,不是按域名后缀判断。排查域名请求时,先检查上方是否已有域名规则命中,再检查 IP 类规则是否拿到了可用于匹配的目标地址。
[URL Rewrite]:按 URL 路径重定向
[Rule] 决定连接如何走,[URL Rewrite] 则匹配客户端能够处理的 HTTP 请求 URL。如下例同时限定协议、主机名和路径,并用 302 指向新地址。它只演示语法,不依赖示例域名提供页面。
[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302
^和$限定整个 URL;\.匹配域名里的字面点号。替换成自己的测试域名时,保留点号前的反斜杠。- 这条表达式只匹配
http://docs.example.com/old,不匹配/old/或/old?from=help。验证时分别请求原路径和带参数的路径,确认匹配范围符合预期。 - 目标地址使用同一主机的
/new,不会再次命中这条表达式。检查重定向时先确认首个响应是否为302、目标地址是否正确,再检查新请求能否完成。
HTTPS 请求的路径位于加密内容中,仅知道目标主机名不足以匹配路径。如果测试工具在发送前已把 HTTP 升级成 HTTPS,上面的表达式就不会按原样命中。先确认实际发出的协议和 URL,再决定是否需要修改表达式。
保存后不生效的常见原因
明明写了 DIRECT,为什么还走代理?
先查 Home → Global Routing 是否为 Config,再检查当前启用文件的 [Rule]。如果上方已有覆盖该主机名的 DOMAIN-SUFFIX,把精确的 DOMAIN 例外移到它之前,重新建立连接验证。
能把新规则直接贴在 FINAL 下面吗?
不要把普通规则放在兜底之后。若已有 FINAL,将新规则插入它之前,再检查更上方有无覆盖该目标的条目。保存后用一个应命中的目标和一个应落到兜底的目标各测一次。
Host 改了地址,为什么浏览器地址栏没变?
[Host] 改的是主机名对应的地址,地址栏继续显示原来的 URL 是正常现象。要验证映射,使用自己控制的目标服务检查新连接是否抵达预期地址;若要把 /old 改到 /new,检查的是重定向而不是主机映射。
切回原文件后,怎么判断是哪次改动有问题?
在同一网络上,用原文件和改动后的副本分别发起同一请求,保持 Global Routing 与所选服务不变。若只有副本出现问题,就从最近改过的段开始逐行恢复,每次只改一处、重试一次,直到找到触发现象的条目。