Shadowrocket 配置文件详解:.conf 中 General、Rule、Host、URL Rewrite 各段写法

逐段拆解 Shadowrocket 的 .conf 结构,说明 [General] 常用参数、[Rule] 的匹配顺序与 FINAL,以及 [Host] 和 [URL Rewrite] 的典型写法。

本文速览

修改 .conf 时,先在 Config 备份当前文件,再分别检查通用参数、路由规则、域名映射和 URL 重写;需要按规则分流时,将 Home → Global Routing 设为 Config。本文面向已有自己的服务商与订阅、需要理解配置语法的用户,提供可拆分验证的示例和回退步骤,不把配置文件当作连接凭据。

一、.conf 的分段结构与生效条件

Shadowrocket(小火箭)的 .conf 是文本配置文件。方括号包围的是分段名,分段内再按各自语法填写参数或规则。[General] 通常采用 键 = 值,[Rule] 采用逗号分隔的规则行;不能把这两类语法混写。保存成功也不等于已经启用,仍需在 Config 确认当前选中的文件。

4 段
本文范围:General、Rule、Host、URL Rewrite
32 位
IPv4 的 /32 前缀表示单个地址
302
本文重写示例使用的临时重定向状态码

以下是用于阅读结构的最小示例,不是可直接替代现有设置的完整连接方案。PROXY 使用当前代理选择;可用的服务器及认证信息需要事先配置。示例域名与文档地址仅用于解释语法,不代表可连接的业务服务。

[General]
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

[Host]
lab.example.com = 192.0.2.10

[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302

Home 主要处理服务器选择与连接,Config 管理配置文件,Settings 提供应用设置。Subscribe 导入和更新的是订阅所包含的连接条目;不能据此推断本地 .conf 也同步更新。反过来,修改 .conf 里的规则,也不会修正服务器地址、密码或订阅授权。排错时应把这两部分分开记录。

备份文件 逐段编辑 选中配置 检查路由 发起新请求

二、[General]:先理解 DNS 与 IPv6,再调整通用参数

[General] 影响配置的基础行为。最适合先检查的是 DNS 来源:dns-server = system 表示使用系统提供的 DNS。它不是指定一个固定公共解析器;切换 Wi-Fi 与蜂窝网络后,系统提供的解析环境可能变化。域名解析失败时,应先区分是系统网络本身异常,还是当前配置引入了不同的解析行为。

[General]
dns-server = system
ipv6 = false

ipv6 = false 可用于排查 IPv6 相关问题,但不应被当作所有网络的固定优化项。关闭 IPv6 支持会改变可用地址族;某些网络依赖 IPv6,直接照抄可能减少可达路径。若原配置已能正常工作,先保留原值,只在有明确症状时做单项对照,并在测试后决定是否恢复。

General 参数检查

dns-server
system:使用系统 DNS 来源。
ipv6
false:关闭该配置的 IPv6 支持,用于有针对性的排查。
修改单位
一次只改一项,保存后以新连接验证。

不要把多项参数同时更改后的结果归因于其中一项。

Rule 语法检查

DOMAIN-SUFFIX
example.com,PROXY:按域名后缀匹配。
IP-CIDR
192.0.2.10/32,DIRECT,no-resolve:匹配单个 IPv4 地址。
FINAL
DIRECT:作为未命中前面规则时的最终策略。

规则行使用英文逗号,FINAL 不填写域名或网段。

配置文件中的 DNS 设置与设备当前网络的 DNS 不一定是同一层面的观察结果。若浏览器仍使用已有连接或缓存,修改后立即刷新一次未必能体现变化。测试时先保存文件、确认启用,再重新建立连接;必要时结束目标应用后重开,避免用旧连接判断新参数。

三、[Rule]:按顺序匹配,FINAL 放在末尾

[Rule] 的关键是自上而下匹配,先命中的有效规则决定相应请求的策略。更具体的例外通常放在更宽泛的规则前面。例如,若希望 status.example.com 直连、其他 example.com 域名走代理,精确域名规则应排在后缀规则之前。

[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
规则关键字匹配对象检查重点
DOMAIN一个完整域名不包含协议头、端口与路径。
DOMAIN-SUFFIX域名本身及其子域名example.com 可覆盖 api.example.com,不是任意字符串包含。
IP-CIDR目标 IPv4 地址范围/24 是网段;no-resolve 避免仅为该条匹配而触发域名解析。
GEOIP地址数据库中的地区归属CN 是地址数据库的地区代码,匹配结果以该数据库记录为准。
FINAL未被前面规则匹配的请求放在末尾,并明确选择 DIRECT 或 PROXY。

no-resolve 不会关闭整个应用的 DNS,也不是“禁止解析这个域名”。它限定的是相应 IP 规则的匹配过程。域名请求到达该规则时,如果没有可用于匹配的目标 IP,不能假定这条规则一定命中。需要精确控制某个域名时,优先使用 DOMAIN 或 DOMAIN-SUFFIX,避免仅依赖地址归属。

结论:先验证精确规则,再验证兜底

先用 status.example.com 对应的实际测试目标检查精确例外,再检查后缀规则,最后测试一个不属于前面范围的自有目标。若把 FINAL 提到前面,后面的例外不会按预期参与匹配;应先调整顺序,而不是继续增加重复规则。

规则是否参与路由,还取决于 Home → Global Routing。Config 用于按当前配置分流;Proxy 与 Direct 分别用于全局代理、全局直连方向的选择,不适合用来验证完整的规则分流结果。Scene 按已设置的场景条件选择路由行为,不能把它视为 Config 的同义项。排查本文示例时,先明确选择 Config。

四、[Host]:只写域名映射,不把 URL 填进来

[Host] 用于指定域名到地址的本地映射。左边写域名,右边写目标 IP;不要写 https://、路径或 :443。端口属于连接目标信息,不属于这类域名映射。以下使用保留的文档地址说明格式,不能用它验证真实网站连通性。

[Host]
lab.example.com = 192.0.2.10
status.example.com = 192.0.2.20

Host 映射不等于强制直连。请求最终采用什么策略,还要结合 Global Routing 与规则判断。也不要假定为域名指定一个 IP 后,就会绕过所有域名规则。对自有 HTTPS 服务做测试时,应分别确认地址映射、路由命中、证书域名和服务器响应,四项不能互相替代。

五、[URL Rewrite]:从 HTTP 重定向示例理解写法

[URL Rewrite] 处理的是 URL 匹配与改写,不负责修复服务器认证,也不等同于 DNS 映射。典型重定向行由匹配表达式、目标 URL 和状态码构成,字段之间用空格分隔。下面把示例站点的 HTTP 请求重定向到 HTTPS,并保留路径。

[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
  1. ^ 限定从 URL 开头匹配,避免表达式在其他位置误命中。
  2. example\.com 中的点使用反斜杠转义,使其表示普通点号,而不是正则中的任意字符。
  3. (.*) 捕获后续内容,目标中的 $1 引用第一组捕获结果。
  4. 302 表示临时重定向。它会让客户端按重定向结果发起后续请求,不是直接替换服务器响应正文。

这条规则的源地址明确是 HTTP。不能仅把表达式中的 http 改成 https,就认为可以读取所有加密请求的完整 URL;普通隧道转发不等于获得 TLS 内部的路径与内容。某些浏览器还会因 HSTS 或 HTTPS 优先策略在发出请求前升级地址,此时 HTTP 示例可能没有匹配机会。

重写与 Rule 解决的问题不同:前者改变匹配请求的 URL 行为,后者决定连接采用的路由策略。即使重定向规则生效,后续目标是否可达,仍取决于其 DNS、路由和服务器状态。看到页面最终打不开时,应先确认失败发生在初始请求、重定向过程还是新目标连接。

六、保存、启用与回退:一次验证一个变化

编辑前在 Config 保留当前可用文件的副本,并记下其名称。不同平台的编辑菜单呈现可能不同,应以当前应用提供的编辑、复制或导出操作为准。不要直接覆盖仅存的一份工作配置;远程配置还应保留本地副本,避免后续更新使手工修改难以追踪。

  1. 在 Config 打开准备修改的文件,只改一个分段中的一项,使用英文标点保存。
  2. 确认该文件为当前配置,再到 Home → Global Routing 选择 Config。
  3. 检查当前代理选择是否可用;规则写对不能代替有效的服务器凭据。
  4. 重新建立连接,访问与该规则直接相关的测试目标,核对应用提供的连接记录或日志。
  5. 记录目标域名、预期策略、实际结果和修改项;失败时切回备份,再重复同一个请求进行对照。

Settings → On Demand 负责按条件触发连接,与 Rule 的匹配顺序是不同问题。如果手动断开后连接又恢复,应检查 On Demand 条件,而不是删除 FINAL。为减少排错变量,可以在测试期间暂时关闭 On Demand,完成验证后恢复原设置。

改了 Rule,为什么所有网站还是同一个出口?

先检查 Home → Global Routing 是否为 Config,再核对 Config 中当前选中的文件。随后检查 FINAL 前是否存在覆盖范围过大的规则,并用新连接复测,不要只刷新原来的长连接页面。

订阅更新了,为什么本地规则没有变化?

服务器订阅与本地 .conf 是不同配置对象。回到 Config 查看当前文件内容;如果要更新远程配置,应对相应配置执行更新,并确认更新结果,不能用 Subscribe 的更新时间替代判断。

加了 Host 后,HTTPS 为什么提示证书不匹配?

检查映射地址是否承载该域名,以及服务端证书是否包含该域名。Host 只改变地址映射,不修复证书。先撤销该条映射验证原路径,再由服务器管理方检查证书和站点配置。

保存后出现解析错误,先查哪里?

先按提示行号检查分段名和英文标点:Rule 用英文逗号,General 与 Host 用等号,URL Rewrite 用空格分隔字段。将刚添加的内容撤回,确认原文件可用后再逐行恢复。

下载 Shadowrocket