本文速览

本文适合已经拥有服务信息、准备阅读或修改 Shadowrocket 配置文件的用户。先辨认四个配置段的边界,再用可检查的规则与映射示例理解匹配过程,最后按备份、编辑、启用、验证的顺序操作。示例用于说明语法,不是可直接覆盖现有设置的完整配置。

先确认平台,再区分服务信息与配置文件

Shadowrocket(小火箭)的获取入口见全平台下载页:iPhone / iPad 在 App Store $2.99 一次性付费,开发者为 Shadow Launch Technology Limited,系统要求以 App Store 页面标注为准;Mac(Apple 芯片 / Intel)、Windows、安卓、Linux 版免费。下文以 Home、Config、Settings 这些界面词定位操作,具体控件位置按当前平台界面显示。

服务信息回答“连接哪台服务器、使用哪种协议和认证参数”,配置文件回答“流量怎样处理”。已有订阅中的服务器条目,与 Config 中启用的 .conf 不是同一个对象。更新订阅不等于已经切换配置,选择配置也不等于已经添加了可用服务器。本文以用户已有自己的服务商与订阅为前提,不提供、不销售、不推荐节点或订阅。

4 个段
本文讲解 General、Rule、Host、URL Rewrite
6 类规则
下文列出常用匹配关键字与 FINAL
2 档获取
iPhone / iPad 付费;Mac / Windows / 安卓 / Linux 免费

.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 不会修复上游故障。

Settings 中的运行选项还需要单独检查。例如 Settings → On Demand 涉及按条件触发连接,而不是定义 example.com 应匹配哪条 Rule。排查时如果连接在手动断开后重新建立,应检查 On Demand 的启用状态与条件,不要先删除规则段。

[Rule]:按顺序匹配,再执行目标策略

[Rule] 的核心是“匹配条件 + 处理目标”。常规规则自上而下检查,命中后采用对应目标,因此更具体的例外通常写在宽泛规则前面。DIRECT 表示直连,REJECT 表示拒绝;PROXY 用于代理策略。若写自定义策略名称,必须确保当前配置中确实存在对应定义,不能任意写一个标签。

关键字示例匹配含义
DOMAINDOMAIN,example.com,DIRECT匹配完整域名 example.com,不包含其子域名。
DOMAIN-SUFFIXDOMAIN-SUFFIX,example.com,PROXY匹配 example.com 及其子域名,不是任意字符串结尾匹配。
DOMAIN-KEYWORDDOMAIN-KEYWORD,example,REJECT匹配域名中含有 example 的请求,范围可能比预想更宽。
IP-CIDRIP-CIDR,192.0.2.0/24,DIRECT按目标 IPv4 地址网段匹配;此处使用文档示例网段。
GEOIPGEOIP,CN,DIRECT依据 IP 地理数据库识别的区域匹配,与网页内容无关。
FINALFINAL,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

修改与验证:每次只处理一个变量

首次修改时先保留可恢复副本。完整配置可能还包含其他段或远程引用,不能因为本文只讲四段就把其余内容全部删除。以下流程以当前已能连接的配置为基础,目的在于减少改动范围,而不是重新建立一整套服务。

  1. 备份配置

    进入 Config,定位当前启用的配置,使用该条目的导出或分享操作保存副本;记录文件名和当前 Global Routing 姿态。

  2. 编辑单项

    在 Config 打开对应配置的编辑入口,只修改一个段中的一项。测试 Rule 时先增加一条精确 DOMAIN 规则,不同时改 DNS 与 Host。

  3. 确认启用

    保存后回到 Config,确认选中的是修改后的文件,再到 Home → Global Routing 选择 Config,避免在 Proxy 或 Direct 姿态下判断规则效果。

  4. 发起新请求

    结束目标应用已有连接,再发起一次新请求,结合可用的连接记录检查目标域名与实际策略。已建立的长连接可能仍保留原来的处理结果。

  5. 记录与恢复

    记录修改行、命中结果与错误现象。若结果异常,恢复备份并重复同一个测试,不要继续叠加未经验证的设置。

若还需更新已有订阅,应将它作为另一项独立操作:确认订阅更新成功、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。应围绕具体目标保留必要内容,并结合当前有效配置判断缺省行为,不能把本文的片段当作通用默认配置。

获取 Shadowrocket 与基础教程

iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片 / Intel)/ Windows / 安卓 / Linux 版免费。先在下载页选择设备,再按教程导入自己已有的服务信息;配置文件用于组织设置与分流,不包含线路套餐。