本文适合已经拥有服务信息、准备阅读或修改 Shadowrocket 配置文件的用户。先辨认四个配置段的边界,再用可检查的规则与映射示例理解匹配过程,最后按备份、编辑、启用、验证的顺序操作。示例用于说明语法,不是可直接覆盖现有设置的完整配置。
先确认平台,再区分服务信息与配置文件
Shadowrocket(小火箭)的获取入口见全平台下载页:iPhone / iPad 在 App Store $2.99 一次性付费,开发者为 Shadow Launch Technology Limited,系统要求以 App Store 页面标注为准;Mac(Apple 芯片 / Intel)、Windows、安卓、Linux 版免费。下文以 Home、Config、Settings 这些界面词定位操作,具体控件位置按当前平台界面显示。
服务信息回答“连接哪台服务器、使用哪种协议和认证参数”,配置文件回答“流量怎样处理”。已有订阅中的服务器条目,与 Config 中启用的 .conf 不是同一个对象。更新订阅不等于已经切换配置,选择配置也不等于已经添加了可用服务器。本文以用户已有自己的服务商与订阅为前提,不提供、不销售、不推荐节点或订阅。
.conf 的基本结构:段名、键值与规则行
.conf 是文本配置。方括号中的名称声明配置段,后面的行归入该段,直到遇到下一个段名。不同段使用不同语法:[General] 与 [Host] 常见的是键值形式,[Rule] 使用逗号分隔字段,[URL Rewrite] 则按匹配表达式、目标和动作组织内容。不能把某一段的语句直接搬到另一段。
[General]
dns-server = system
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
[Host]
example.com = 192.0.2.10
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
阅读文件时先找段名,再确认每行参数的分隔符。规则中的逗号应使用英文半角字符;正则表达式里的反斜杠也不能被编辑器替换。排查期间优先使用单独的注释行记录修改原因,不要假定任何行尾都能随意追加注释。文件扩展名相同,也不代表其他格式的配置可以原样导入。
[General]:全局选项不等于逐站分流
[General] 组织影响整体运行的选项,例如 DNS 解析相关配置。示例中的 dns-server = system 表示指定使用系统 DNS;这是一个明确的配置选择,不是在声明应用当前的默认行为,也不保证所有网络环境都适用。若系统网络本身无法完成解析,单纯选择系统 DNS 不会修复上游故障。
- 先判断问题层级:域名无法得到地址时检查 DNS;已经得到地址但连接超时时,继续检查路由、服务端口和传输条件。
- 只改相关选项:不要为解决单个域名走错策略,同时更改 DNS、IPv6 与多条规则,否则难以确认是哪项修改产生影响。
- 核对生效配置:Config 中保存的文本必须是当前启用的配置。编辑了另一份同名文件,并不会自动改变正在使用的那一份。
- 不猜取值:遇到不认识的键,先在设置详解中核对用途与适用条件;不要凭键名推测布尔值或照搬其他配置格式。
Settings 中的运行选项还需要单独检查。例如 Settings → On Demand 涉及按条件触发连接,而不是定义 example.com 应匹配哪条 Rule。排查时如果连接在手动断开后重新建立,应检查 On Demand 的启用状态与条件,不要先删除规则段。
[Rule]:按顺序匹配,再执行目标策略
[Rule] 的核心是“匹配条件 + 处理目标”。常规规则自上而下检查,命中后采用对应目标,因此更具体的例外通常写在宽泛规则前面。DIRECT 表示直连,REJECT 表示拒绝;PROXY 用于代理策略。若写自定义策略名称,必须确保当前配置中确实存在对应定义,不能任意写一个标签。
| 关键字 | 示例 | 匹配含义 |
|---|---|---|
DOMAIN | DOMAIN,example.com,DIRECT | 匹配完整域名 example.com,不包含其子域名。 |
DOMAIN-SUFFIX | DOMAIN-SUFFIX,example.com,PROXY | 匹配 example.com 及其子域名,不是任意字符串结尾匹配。 |
DOMAIN-KEYWORD | DOMAIN-KEYWORD,example,REJECT | 匹配域名中含有 example 的请求,范围可能比预想更宽。 |
IP-CIDR | IP-CIDR,192.0.2.0/24,DIRECT | 按目标 IPv4 地址网段匹配;此处使用文档示例网段。 |
GEOIP | GEOIP,CN,DIRECT | 依据 IP 地理数据库识别的区域匹配,与网页内容无关。 |
FINAL | FINAL,PROXY | 接住前面未命中的流量,通常放在规则末尾。 |
例如要让 example.com 直连,但它的其他子域名使用代理,可以先写 DOMAIN,example.com,DIRECT,再写 DOMAIN-SUFFIX,example.com,PROXY。如果顺序相反,根域名会先被后缀规则命中,后面的精确规则就无法处理这次请求。
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,PROXY
域名规则与 IP 规则的匹配依据不同。IP 类规则可能涉及解析,具体行为还受相关选项影响。不要将“IP 地址被归入某区域”理解为“域名注册在该区域”,也不要把 FINAL 提前放在待验证规则之前。判断效果时应查看实际命中信息,而不只根据网页是否打开推断。
Global Routing:确认当前是否按 Config 分流
文件语法正确但规则没有表现出预期效果时,先到 Home → Global Routing 检查当前姿态。选择 Config 才是验证该配置中 Rule 分流的直接起点;Proxy 与 Direct 用于整体流量处理方向的切换,不能代替逐条规则测试。
Config
推荐按当前启用配置的规则进行分流。命中规则的目标可能是 PROXY、DIRECT、REJECT 或已定义的策略。
适合:验证本文的 Rule 示例与规则顺序。
Proxy
以代理方式处理流量,而不是按同一套域名规则选择代理或直连;仍需有可用的代理连接。
适合:对照检查问题是否与 Config 中的分流有关。
Direct
以直连方式处理流量。直连能打开某网站,不代表代理参数已经正确,也不代表 Rule 已命中。
适合:检查本地网络直接访问目标的表现。
Scene
依场景条件应用相应设置,判断结果前还需确认当前命中的场景及其配置,不能只看编辑过的文件。
适合:已经建立场景条件、需要随环境切换的使用方式。
[Host]:指定解析地址,不负责端口与认证
[Host] 用于本地域名映射。example.com = 192.0.2.10 表达的是将该名称映射到指定地址,不是把网站改为代理,也不是把服务端口改成某个值。此处的示例地址不能作为真实服务使用;正式映射必须来自你有权使用的服务或受管理网络。
区分 Host 映射与 Rule 分流
Host 处理名称与地址
- 回答域名应对应哪个地址。
- 映射中不写 URL 路径或登录凭据。
- 地址变化后需要检查旧映射是否仍有效。
Rule 处理流量策略
- 回答请求应直连、代理还是拒绝。
- DOMAIN-SUFFIX 可以覆盖子域名范围。
- 规则顺序决定哪个条件先得到处理。
需要同时改变地址与策略时,分别检查 Host 和 Rule;仅添加 Host 不能替代分流规则。
HTTPS 还会验证证书对应的域名。把域名映射到任意地址,并不会使那个地址上的证书自动有效。若添加映射后出现证书名称不匹配、连接到错误站点或持续超时,应先撤回映射核对服务地址,而不是通过忽略证书错误来掩盖问题。对于使用自有解析机制的应用,也不能假定它一定遵循这里的映射。
[URL Rewrite]:匹配请求地址并执行改写动作
[URL Rewrite] 关注 URL,而不是选择服务器协议。下面一行以正则表达式匹配 http://example.com/ 开头的地址,将路径保留到 HTTPS 目标,并使用 302 重定向动作。表达式中的 \. 表示字面量句点,(.*) 捕获剩余路径,$1 引用第一个捕获组。
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
- 检查匹配范围:开头的
^约束匹配起点;该示例不匹配其他子域名,也不匹配已经使用 HTTPS 的原始 URL。 - 理解重定向:
302表示临时重定向。客户端会按重定向地址发起后续请求,它不是在后台悄悄更换目标 IP。 - 不要混同 DNS:Host 改名称对应的地址,URL Rewrite 改请求地址的处理行为,两者不是同一个阶段的设置。
- 注意可见性:读取和改写加密 HTTPS 请求的完整路径通常涉及额外的 HTTPS 解密条件;仅写一条规则,不会自动获得加密内容。
修改与验证:每次只处理一个变量
首次修改时先保留可恢复副本。完整配置可能还包含其他段或远程引用,不能因为本文只讲四段就把其余内容全部删除。以下流程以当前已能连接的配置为基础,目的在于减少改动范围,而不是重新建立一整套服务。
-
备份配置
进入 Config,定位当前启用的配置,使用该条目的导出或分享操作保存副本;记录文件名和当前 Global Routing 姿态。
-
编辑单项
在 Config 打开对应配置的编辑入口,只修改一个段中的一项。测试 Rule 时先增加一条精确 DOMAIN 规则,不同时改 DNS 与 Host。
-
确认启用
保存后回到 Config,确认选中的是修改后的文件,再到 Home → Global Routing 选择 Config,避免在 Proxy 或 Direct 姿态下判断规则效果。
-
发起新请求
结束目标应用已有连接,再发起一次新请求,结合可用的连接记录检查目标域名与实际策略。已建立的长连接可能仍保留原来的处理结果。
-
记录与恢复
记录修改行、命中结果与错误现象。若结果异常,恢复备份并重复同一个测试,不要继续叠加未经验证的设置。
若还需更新已有订阅,应将它作为另一项独立操作:确认订阅更新成功、Home 中所选服务器仍有效,再测试配置。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的连接参数属于各自协议与服务端配置范围;添加 FINAL,PROXY 不会修正错误的密码、端口或认证信息。
常见现象与对应检查项
配置已保存,为什么 example.com 仍没有按新规则处理?
依次确认 Config 中启用的文件、Home → Global Routing 是否为 Config、目标前面是否已有更宽泛规则,以及请求是否沿用了旧连接。若实际请求是某个子域名,只有 DOMAIN,example.com,DIRECT 不会匹配它;应根据预期选择精确域名或 DOMAIN-SUFFIX。
添加 Host 后,延迟正常但网页打不开怎么办?
先移除新增映射,再对同一目标发起新请求。服务器延迟测试与目标网站解析不是同一个测试:延迟正常不能证明 Host 地址正确、目标服务正在监听或证书匹配。本文的 192.0.2.10 仅供说明,保留它会使对应访问指向示例地址。
更新远程配置后,本地修改为什么不见了?
远程内容更新可能替换本地文件,具体取决于导入和维护方式。对需要保留的修改,应先保存独立副本并记录差异,更新后逐项核对。不要假定本地新增 Rule 会自动与远程内容合并,也不要把含认证信息的完整配置或订阅链接公开。
四个段都必须写吗?
不必为了形式完整而添加空段或无关设置。没有固定映射需求时,不需要照抄 Host;没有改写需求时,不需要添加 URL Rewrite。应围绕具体目标保留必要内容,并结合当前有效配置判断缺省行为,不能把本文的片段当作通用默认配置。