官方手册 · 配置字段

Shadowrocket
配置字段与规则参考

先确认生效的配置,再核对规则条件、排列顺序与最终策略。本页按文件结构组织,适合带着已有配置逐项查阅。

第一次使用请先读快速上手教程,完成已有订阅导入与首次连接;本页解释配置为什么这样工作,不重复首次操作主线。需要获取客户端时,请前往全平台下载页。

[General] [Rule] [Host] [URL Rewrite]

01 · 配置文件结构与生效范围

Shadowrocket 的配置文件用方括号标记段落,每个段落负责一类设置。阅读文件时,先看段名,再看段内语法,不要把所有带逗号的文字都当作规则。常见结构包括处理基础行为的 [General]、决定请求去向的 [Rule]、指定域名地址映射的 [Host],以及改写匹配网址的 [URL Rewrite]。段名之间存在明确边界,一行内容放错段落,即使单词拼写正确,也不能据此期待相同效果。

从最小文件开始读

下面的片段用于观察结构,不是适合所有网络的完整配置。示例先保留系统相关的基础行为,再列出一个域名条件和一条兜底规则。example.com 是文档示例域名,应替换为需要测试且有权使用的目标。规则中的 PROXY 仍需要客户端已有可用的代理选择;只复制这份文本,不能替代服务器参数、认证信息或订阅导入。

[General]
bypass-system = true
dns-server = system

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

配置文件、服务器列表和当前连接状态是三个不同层次。服务器列表保存连接所需的信息,配置文件描述流量如何处理,连接开关决定系统流量是否进入当前的处理流程。文件出现在列表里,不等于已被选中;选中文件,也不等于当前流量一定按其中规则分流。检查时还必须确认 Global Routing(全局路由)的当前姿态,尤其要排除临时切到 Proxy 或 Direct 后忘记恢复的情况。

打开、编辑与切换不是同一步

在 Config(配置文件入口)中先确认正在使用的文件,再打开其编辑或详情入口。不同平台的入口位置可能不同,应以当前应用内的实际文案为准。修改前保留原文件副本,保存后确认没有解析错误,再重新核对当前选中项。如果正在排查问题,建议只保留一个明确的测试副本作为本轮对象,避免同名文件、远程文件和本地副本混在一起,导致实际编辑的不是正在使用的那一份。

段落主要用途查阅重点
[General]基础行为与解析设置字段名称、取值和适用条件
[Rule]按请求条件选择策略条件范围、排列位置、兜底策略
[Host]固定域名地址映射地址有效性与解析覆盖范围
[URL Rewrite]匹配并改写网址表达式、目标地址、可见请求范围

文件中的空行主要用于阅读分组,不会把前后两条规则变成两个独立流程。相反,段落标题会改变后续内容的解释方式。手工合并文件时,最容易出错的是只复制规则正文,却漏掉所属段落,或者把第二份文件的基础字段直接接到规则末尾。稳妥做法是按段落归并,逐段比较,而不是将两份完整文件首尾拼接。重复字段的处理也不应靠猜测,应去除歧义并通过保存结果检查。

从网页或聊天内容复制配置时,要留意全角逗号、弯引号、不可见空格和被自动换行的长行。规则字段之间使用英文逗号,键值字段通常使用等号;界面里的视觉折行不一定是文件换行,但粘贴过程可能真正插入换行。发现一条规则突然被拆成两条不完整文本时,应回到纯文本编辑视图核对,而不是通过增加更多规则补救语法问题。

查阅本页的顺序可以按故障范围调整:文件无法保存,先看结构和语法;请求走错策略,先看模式与顺序;域名无法解析,转到基础字段和地址映射;只有特定网址跳转异常,再看改写。这样能把“文件是否能读”“规则是否能命中”“命中后能否连接”分开判断,避免把服务器不可用误认为规则格式错误。

02 · General、DNS 与基础行为

[General] 的作用是设置基础行为,不是按域名逐条选择代理。阅读这一段时应先问:这个字段影响哪些请求,是否改变解析方式,是否与系统服务有关。不要因为另一份配置列出了很多字段,就认为字段越多越完整。未理解的取值会扩大排查范围;一份只保留必要设置、能够解释每个取值的文件,通常更容易验证和维护。

理解示例中的两个字段

bypass-system = true 用于启用系统相关流量的绕过行为,但不能据此推断“所有直连规则都不用写了”,也不能把它理解为关闭系统代理。实际涉及的系统流量范围应结合当前应用设置和运行环境核对。dns-server = system 表示使用系统 DNS 解析来源,它并不承诺解析结果固定,也不意味着每个网络环境会得到相同答案。

[General]
bypass-system = true
dns-server = system

域名解析和路由选择相关,却不是同一件事。域名条件可以根据请求携带或客户端识别到的域名判断;地址条件则需要可供比较的目标地址。某些请求最初只有域名,某些请求直接访问地址,还有些连接会因缓存而复用先前结果。因此,“浏览器里输入的是域名”并不足以说明每一步都会重新解析,更不足以证明这次请求必然经过某个特定解析服务器。

先分清解析失败与连接失败

遇到无法打开的目标,先看失败发生在哪一层。如果域名没有得到可用地址,应检查当前网络的解析能力、系统 DNS 和固定映射;如果已有地址但建立连接失败,应转而检查策略、代理服务器和目标服务。单纯把最终策略从直连改为代理,不能保证修复错误的固定地址。同样,域名能解析出结果,也只说明解析这一步有结果,不代表返回地址可以从当前出口访问。

切换无线网络与移动网络后,系统解析来源、局域网地址和可访问范围都可能改变。公司内网的名称可能只在特定网络可解析,家用设备的地址可能来自路由器分配,公共站点也可能因网络位置而返回不同的服务地址。排查时先固定网络,再测试一个明确目标;如果同时切换网络、替换 DNS、更新订阅并修改规则,即使恢复访问,也难以知道究竟是哪项变化起了作用。

不要把多个配置来源的 DNS 设置机械合并。不同字段可能分别控制解析来源、回退条件或特定情形的处理,表面看起来都是“加一个地址”,实际却可能改变请求顺序和失败路径。本页只给出便于复现的基础片段;需要调整更细的行为时,先查看当前客户端提供的字段说明,再为单个目标做对照测试。没有明确问题时,不必为了增加字段数量而改动解析方式。

缓存与重复测试的边界

修改解析相关设置后,旧连接和缓存可能继续影响短时间内的观察。应结束相关请求,必要时重建客户端连接,并重新发起新的访问;如果应用提供相关记录或缓存操作,以其实际入口为准。不要把一次刷新后仍显示旧页面当成规则没有保存的证据,因为浏览器内容缓存、应用长连接和域名解析缓存属于不同层次,清除其中一个不一定影响另外两个。

记录基础设置时,应写清当前网络、系统是否使用额外的网络配置,以及测试目标是域名还是直接地址。涉及单位网络或受管理设备时,不要为了验证规则擅自移除组织要求的设置。先建立可以恢复的对照条件,再逐项定位。如果同一份文件在两个网络里表现不同,这往往提示环境条件发生变化,而不是文件文本自行改变。

最终保留字段的标准是能够说明用途、能在当前环境验证,并且有恢复路径。修复完成后删除临时加入的未知取值,保留原始副本与简短修改说明。如果问题仍集中在单个目标,可继续检查下文的域名条件和地址条件;如果所有目标都失败,则应同时检查连接入口与已有服务器状态,避免继续在规则段里重复增加相同条件。

03 · Global Routing 与三种策略

Global Routing(全局路由)决定总体处理姿态,规则末尾的策略决定某条规则命中后的去向。两者名称相近,但处在不同层次。界面的 Config(配置)、Proxy(代理)、Direct(直连)用于选择总体姿态;配置文本中的 PROXY、DIRECT、REJECT 则是规则策略。判断配置是否生效,必须同时查看这两个层次,不能只确认其中一个。

先看模式,再分析规则

日常希望按规则分流时,使用 Config 并确认选中的配置文件。在 Proxy 姿态下,流量按代理姿态处理,不能拿此时的表现验证规则段是否把某个域名分到直连;在 Direct 姿态下,也不能因为访问成功,就断言代理服务器正常。这里描述的是总体分流意图,系统保留行为、连接可见范围等条件仍可能影响具体请求,不宜把模式名称理解为覆盖一切系统通信的保证。

界面姿态主要用途验证时注意
Config(配置)按当前文件规则分流检查文件、规则顺序和最终命中项
Proxy(代理)临时观察代理路径不能用来证明规则中的直连条件有效
Direct(直连)临时观察直连路径成功不代表代理服务器可用

规则中的三个策略分别负责什么

PROXY 表示交给当前代理选择处理,不代表配置文件自动指定了一台永远可用的服务器。服务器失效、认证不符或协议参数错误时,即使命中该策略也会失败。DIRECT 表示从当前网络直接连接,仍依赖本地解析、路由和目标服务。REJECT 表示拒绝匹配流量,其目的不是“选择速度较快的线路”,也不应作为无法解释错误时的通用修复方式。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,local.example.com,DIRECT
DOMAIN,service.example.com,PROXY
FINAL,DIRECT

上面的拒绝规则只匹配示例主机,直连与代理规则也各自指向明确主机。文件没有测量速度,也不会因为代理连接失败就自行把这条请求改成直连。若希望获得某种回退行为,需要确认当前客户端是否提供相应机制并明确配置,不能把“写了多个策略名称”误当成自动容错。一个规则行的末尾通常只表达该条件命中时采用的处理结果。

应区分连接测试与业务请求。某项 Connectivity Test(连接测试)有结果,只能说明对应测试条件下获得了结果,不能替代目标站点的实际请求。目标可能需要不同端口、不同传输能力,或依赖多个附属域名。排查时先验证已有服务器基本可用,再验证具体目标命中了预期策略,最后观察业务流程是否完整,三步之间不要互相代替。

把临时排查姿态恢复到配置姿态

临时切到代理姿态后目标恢复访问,说明代理路径值得继续检查,但还没有定位是哪条规则出了问题。回到配置姿态,查看失败请求原本命中了什么;如果它落到直连,再分析是缺少精确规则、被较宽条件提前匹配,还是域名信息没有被识别。不要为了一个目标长期保留临时姿态,却继续以为其他应用仍按配置中的例外条件运行。

直连姿态下成功而代理姿态下失败,也不能直接证明规则应当全部改成直连。可能是当前代理服务器不可用,可能是目标不接受该出口,还可能是服务器参数与用户已有信息不一致。应保持目标和网络不变,只改变一个变量,留下每次测试的姿态和结果。有关三种姿态的操作说明,可接着阅读Global Routing 三种姿态的区别。

配置维护时,建议把每一条策略选择写成可以解释的目的:这个主机为什么需要代理,这个网段为什么需要直连,这个目标为什么需要拒绝。没有用途说明的宽范围拒绝规则尤其需要谨慎,因为它可能影响登录、更新或资源加载。不要只看主页面是否显示,还应验证日常必需的操作,再决定保留或撤回策略变化。

04 · DOMAIN 系列域名规则

域名规则适合表达“哪个主机应走哪条路径”,通常比随手收集几个目标地址更容易理解。三种常见条件是 DOMAIN、DOMAIN-SUFFIX 和 DOMAIN-KEYWORD。它们分别强调精确主机、域名边界内的后缀范围,以及域名中包含的字符串。选择时先确定业务范围,再选最窄且足够的条件,不要因为写法简短就默认使用关键字。

精确匹配与后缀匹配

DOMAIN 只针对所写主机名。给 api.example.com 写精确规则,不等于覆盖 example.com,也不等于覆盖该服务的图片主机。DOMAIN-SUFFIX 用于域名本身及其子域范围,例如 example.com 与 api.example.com。后缀规则按域名边界理解,不是任意字符串结尾匹配,因此不能把看起来相似但不属于该域的主机视为同一范围。

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

这一组规则先为接口主机设置代理例外,再让同一域范围内的其他目标直连。它展示的是“精确例外在前,宽范围条件在后”,不是自动按精确程度排序。如果两行交换位置,接口主机会先被后缀条件匹配,前面所需的例外就失去机会。读取文件时应按真实行序模拟,而不是在心中把更具体的规则自动提升到顶部。

关键字匹配要控制范围

DOMAIN-KEYWORD 检查域名中是否出现给定字符串,不表达归属关系。关键字 example 的范围比后缀 example.com 更宽,可能命中多个不同域名。它适合已经确认需要这种宽范围匹配的情形,不适合作为“暂时不知道完整域名”的长期替代。关键字过短时,误命中的概率和排查成本都会增加。

规则匹配示意常见边界
DOMAIN,api.example.com,PROXY指定接口主机不自动包含同域其他主机
DOMAIN-SUFFIX,example.com,DIRECT该域与其子域不表示任意相似字符串
DOMAIN-KEYWORD,example,PROXY域名中包含该字符串可能覆盖无关域名

域名条件里填写主机名,不填写完整网址。协议前缀、端口、路径和查询参数不是域名的一部分;如果把整条网址粘贴进后缀字段,通常就偏离了规则的匹配对象。网址路径差异不能通过普通域名条件区分。同一个主机上的登录页面和图片路径,可能都会命中同一条域名规则;需要按网址处理时,应先理解后文的改写边界,而不是给域名追加斜线。

一个页面可能对应多个域名

主页面可打开而登录失败,并不一定是主域规则写错。页面可能还请求认证接口、静态资源或其他服务域名。应从失败的实际请求出发,确认其主机名,再决定是否加入独立规则。不要为了补齐一个业务流程,直接把所有包含品牌词的域名都设成相同策略;名称相似不能证明这些请求具有相同用途,也不能证明它们需要相同出口。

对于登录和支付等连续流程,建议在同一轮验证中检查入口、跳转、回调和必要资源,而不只是刷新首页。如果某个接口需要代理而主页面直连,先保留这一精确差异,再观察实际行为。跨域请求失败也可能来自服务端权限、账户状态或应用缓存;规则只决定连接路径,不能修复不正确的认证信息,也不能改变目标服务自身的业务限制。

重复域名规则需要按首个命中位置判断。两个完全相同的条件若指向不同策略,后者不会成为“备用”;两个后缀规则若一个范围包含另一个,也要考虑覆盖关系。整理文件时先找相同主机,再找父域与子域,最后查关键字与其他条件之间的交叉。删除重复内容前保存副本,确保被保留的那一行位于正确位置,而不是只按文本去重。

当域名规则似乎没有作用时,先确认目标确实以该主机发起了新连接,再看请求记录中是否有可识别的域名。直接访问地址、复用旧连接或经过不同跳转,都可能让观察对象与预想不同。只有确认请求对象和匹配条件一致,才继续检查规则顺序。这样可以避免针对错误主机反复增加同义规则,却始终没有触及真正失败的请求。

05 · IP-CIDR、GEOIP 与 USER-AGENT

地址规则处理的是目标地址,而不是网页名称。IP-CIDR 用网段表达一组 IPv4 地址,IP-CIDR6 对应 IPv6 地址范围,GEOIP 根据地址归属数据进行分类。它们与域名规则可以同时存在,但判断依据不同。先确定请求有哪些可用信息,再选择条件;不能仅凭域名后缀或页面语言,推断它会命中某个地址归属条件。

网段表达的是地址集合

192.168.0.0/16 表示对应私有地址范围,不是“本机当前连接的所有局域网”。家庭网络可能使用其他私有网段,单位网络也可能有不同规划。给局域网服务写规则前,先查看实际目标地址及网络范围,不要将网上看到的网段直接当作当前环境。规则允许访问的路径也不会自动创造网络路由,设备不在可达网络内时,写成直连仍可能无法连接。

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR6,fc00::/7,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

示例同时展示私有地址范围、IPv6 本地地址范围和地址归属条件,但并不是要求所有用户原样启用。前缀长度越大,集合通常越小;单个 IPv4 地址可以用 /32 表达,单个 IPv6 地址可以用 /128 表达。编辑时应核对地址与掩码是否属于同一种地址族,避免把 IPv6 地址写在 IPv4 规则类型后,或误将普通端口号当作前缀长度。

解析选项不是性能开关的同义词

地址规则可能需要解析域名才能进行地址比较。支持相应选项的规则可以带 no-resolve,表示不要仅为匹配这一条件主动触发解析;它不是“禁止整台设备使用 DNS”。如果请求已经带有地址,仍可能满足地址条件。如果请求只有域名且没有可用地址,带此选项的规则可能无法据此命中,随后继续检查其他规则。是否添加,应由预期行为决定。

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

GEOIP,CN,DIRECT 表达的是地址归属分类,不是按域名中的文字判断,也不表示所有相关网站都只使用这一类地址。内容分发、服务迁移和数据更新都可能让实际结果与直觉不一致。若某个业务必须稳定使用指定策略,通常应先确认其具体域名并写明确规则,不要只依赖粗粒度分类。分类数据是判断依据之一,不是业务归属证明。

USER-AGENT 的可见性边界

USER-AGENT 根据请求中的对应字段匹配客户端标识,不等同于操作系统按应用进程分流。多个应用可以使用相同标识,同一应用也可能因请求类型不同而使用不同内容。更重要的是,普通加密连接并不会自动暴露其中的请求字段,因此不能假设写下应用名称就能识别该应用的全部通信。要使用这类条件,必须先确认当前请求确实提供了可匹配信息。

[Rule]
USER-AGENT,ExampleClient*,PROXY
FINAL,DIRECT

这里的标识是示例模式,用于说明通配匹配形式,不对应某个真实应用的固定标识。测试时需要从有权查看的请求中确认实际内容,并核对大小写、空格和通配范围。不要把浏览器显示名称当作完整请求字段,也不要通过猜测多个应用名称来堆积规则。若无法确认字段可见,应优先使用已验证的域名条件,而不是把未命中解释为代理服务器故障。

地址、域名和请求字段条件之间没有天然的全局优先级,它们仍按规则段里的排列顺序工作。一个宽范围地址条件放在前面,可能先于后面的域名例外命中;一个过宽的请求标识条件,也可能改变原本按域名区分的结果。维护时应将条件类别和顺序一起阅读,并为需要保留的例外设计测试目标,不能只分门别类检查单条语法。

如果同一域名在不同测试中得到不同策略,检查是否分别连接了 IPv4 与 IPv6 地址,是否命中了不同网段,以及解析结果是否改变。不要立即删除某种地址族作为修复。先确认目标实际使用的地址,再比较现有规则对两种地址族是否表达了一致意图;确有环境限制时,记录条件与恢复方法,并在网络变化后重新验证。

06 · 匹配顺序、例外与 FINAL

[Rule] 的核心阅读方法是自上而下查找首个匹配条件,并采用它指定的策略。它不是投票系统,也不是把所有命中结果综合后再挑一个。精确规则不会天然压过后缀规则,域名规则也不会天然压过地址规则。所谓优先级首先来自行序;只有理解这一点,才能解释为什么两份使用相同规则的文件,只因排列不同就产生不同结果。

把具体例外放在宽范围之前

常见布局是明确例外在前、常规分组居中、兜底在最后。例如某个接口需要代理,同域其他主机直连,就把接口的精确条件放在父域后缀前面。这里的“例外在前”是整理原则,不是要求机械采用某种固定分类顺序。若业务上需要某个地址范围优先,也应先明确这个决定会覆盖哪些域名请求,再据此排列,而不是先抄顺序再解释用途。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

以接口主机为例,第一行满足条件后就选择代理,后面的父域条件不再改变结果。以同域其他主机为例,第一行不匹配,再由后缀条件决定直连。以既不属于这些域名、也不属于所列地址范围的目标为例,会继续向下判断。逐条推演时,应写出每条条件是“匹配”“不匹配”还是“当前信息不足以据此匹配”,不要凭印象跳到最终结论。

FINAL 是兜底,不是自动修复

FINAL 为前面的条件均未命中时提供最终策略。它不需要域名参数,写法是 FINAL,PROXY 或 FINAL,DIRECT 等。通常将它放在规则段末尾,使前面的具体条件有机会判断。若把兜底放在前面,后续规则对普通逐条匹配流程就失去意义。也不应依赖多个兜底表达备用关系;保留一个明确的最终选择,更容易确认意图。

宽范围关键字、地址归属和父域后缀都可能遮挡后面的例外。遇到某条规则看似永远不生效,向上检查所有可能覆盖它的条件,不要只找相同文本。完全相同的重复行容易发现,范围相互包含的行更隐蔽。可以先把问题目标单独列出来,按当前文件从第一行开始模拟,找到第一个能命中的位置,再决定移动哪条,而不是把目标规则随意复制到多个段落。

用对照表验证修改意图

修改顺序前,为每类目标选一个明确样本:精确例外主机、父域其他主机、局域网地址和兜底目标。给每个样本写下预期策略,修改后再看实际记录。如果只测试出问题的一个主机,很容易修好了例外却破坏父域其他请求。对照样本不必很多,但要覆盖规则边界;每增加一种宽范围条件,就应至少补一个可能被误覆盖的样本。

测试对象预期首个命中项预期策略
api.example.com精确域名例外PROXY
www.example.com父域后缀条件DIRECT
192.168.1.20私有地址网段DIRECT
未命中前序条件的目标FINALPROXY

合并不同来源的配置时,尤其要检查原文件各自的兜底和例外。两份单独运行正常的文件,合并后并不一定继续正常,因为它们可能采用相反的默认策略。先选定统一的最终策略,再将必要例外放入同一条规则链,最后检查相互覆盖。不要保留两套完整顺序并期待客户端自动理解两位作者的不同意图。

测试结束后清理临时置顶规则。排查时临时把目标放到最前面有助于确认路径,但若长期保留,可能遮住后续维护中新增的业务例外。最终规则应回到可解释的位置,并保留变更原因。需要进一步判断命中正确但仍无法连接的情况,可继续阅读末章的验证流程,或查看规则与故障排查 FAQ,不要继续通过调整顺序处理与顺序无关的问题。

07 · Host 与 URL Rewrite 的边界

[Host] 和 [URL Rewrite] 都可能改变最终访问行为,但不属于同一种操作。前者建立域名与地址的固定映射,后者对满足条件的网址执行改写。它们也不等同于 [Rule] 中的策略选择。排查时必须分别问清:请求要访问哪个名称,名称对应哪个地址,网址是否改变,以及连接使用哪种策略。将这几个问题混在一起,容易把解析、跳转与分流互相误判。

Host 固定映射适合已知且可维护的地址

下例将文档示例主机映射到文档用途地址,用于说明格式,不应作为真实服务地址使用。等号左边是域名,右边是地址,不是代理策略。设置映射后,相关解析可以采用指定地址,但连接是否经代理仍要由实际规则和当前姿态决定。因此,同一域名既有固定映射又有代理规则并不构成语法矛盾,它们描述的是不同层次的行为。

[Host]
lab.example.com = 192.0.2.10

固定映射适合有明确管理责任的测试服务或内部服务,不宜随意用于依赖动态调度的公共站点。目标服务迁移、地址变更或内容分发调整后,旧地址可能失效,甚至指向不再适用的服务。配置仍能保存并不说明地址仍正确。维护时应记录映射用途和验证条件;目标恢复正常解析后,及时判断是否还需要保留这一覆盖,避免临时措施成为长期隐患。

访问加密网站时,固定地址不会自动改写证书中的域名,也不能消除证书校验失败。如果目标地址并不提供对应主机的服务,可能出现连接成功但页面错误、证书不匹配或服务拒绝。此时不应通过忽略安全提示来“证明映射有效”,而应核对地址归属和服务配置。使用域名访问与直接输入地址访问也不是完全等价的测试,后者可能改变目标接收到的主机信息。

URL Rewrite 处理可匹配的网址

改写规则一般包含匹配表达式、替换目标和动作。下面将示例主机上的明文网址重定向到同主机的加密网址,保留后面的路径。表达式里的点号使用反斜线转义,表示域名中的字面点,而不是任意字符;开头锚点用于限制从网址起始处匹配。这个片段只说明语法与边界,不表示任何目标都应采用这样的跳转。

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

这里的 302 是重定向动作,$1 引用前面括号捕获的内容。修改表达式时要同时检查匹配范围和替换结果,尤其注意斜线是否重复、路径是否丢失,以及查询参数是否按预期保留。先用不含个人信息的简单测试路径验证,再验证真实业务中必须保留的参数。不要把包含认证信息的完整请求复制到公开问题描述里。

加密请求与循环跳转需要单独检查

普通加密连接中,完整网址路径并不会自动对客户端可见,不能因为配置里存在改写段,就期待所有加密请求都被检查和改写。本页不要求为规则分流额外启用解密处理;多数按域名选择策略的需求,也不需要通过网址改写实现。若只是希望某个站点走代理,应直接考虑域名规则,而不是尝试给该站点的全部网址加一层跳转。

重定向循环常见于目标网址再次满足原表达式,或两条规则互相把网址改回去。测试时观察最终地址是否反复变化,并逐条停用最近添加的改写进行对照。目标服务本身也可能执行跳转,因此不能把所有循环都归因于本地规则。先保留最小改写条件,再比较关闭该段后的行为,才能确定循环发生在本地处理还是目标服务返回阶段。

合并包含改写的配置前,应逐条确认规则目的、目标域名和作用范围,不要只检查是否能保存。范围过宽的表达式可能影响不相关路径,固定映射也可能让多个子功能落到错误地址。若没有明确用途,保留原始文件并先不启用对应段落。修复分流问题时,优先使用分流规则解决;需要固定解析或网址改写时,再分别引入,并为每项设置独立测试和撤回方法。

08 · 验证、排错与配置维护

一份配置是否正确,最终要用“预期处理方式”和“实际观察结果”对照,而不是只看文件能否保存。保存成功主要说明文本通过了当前解析检查;请求命中预期规则,说明分流判断符合设计;业务操作成功,才说明当前网络、服务器、目标服务和业务条件在本轮测试中共同满足要求。这三个结论范围不同,记录时应分开,避免把局部成功写成全部正常。

建立可恢复的最小验证流程

开始前保留正在使用的文件副本,记录当前选中项、全局路由姿态、网络环境和已有服务器选择。随后只修改一类条件,例如只调整目标域名的规则位置,不同时更换解析来源。保存并确认生效后,重新发起目标请求,查看应用当前提供的连接或请求记录,核对主机、目标地址、命中项和处理策略。不同平台的记录入口可能不同,以实际界面为准。

如果实际策略与预期不同,先查模式和文件是否正确,再按规则从上往下查覆盖关系。如果实际策略正确但连接失败,转查服务器参数、目标服务和当前网络。如果只有部分页面功能失败,则找失败请求对应的主机,而不是重写整份规则。这样的分支能减少无关改动,也能让恢复操作保持简单:撤回本轮变化后,应能够回到测试前的已知状态。

观察到的现象优先检查不宜直接推断
文件不能保存段名、逗号、字段数量与换行服务器已经失效
请求策略不符合预期当前文件、姿态与首个命中条件目标网站必然故障
策略正确但连接失败服务器参数、解析与目标可达性再加一条同样规则就能恢复
首页正常但登录失败认证接口、跳转与关联域名父域规则已经覆盖所有业务

服务器与订阅问题不要在规则中修复

已有服务器显示超时,应按地址、端口、认证信息、协议相关字段和系统时间逐项检查,确保与用户自己的信息一致。不要把所有失败都改成直连,也不要认为不断更新订阅就会改变本地规则顺序。订阅更新主要影响其提供的数据,配置文件可能来自另一来源;两者是否联动,应以当前使用方式为准。具体排查顺序见节点超时与连接失败逐项排查。

管理多个已有订阅时,先区分订阅分组、手工条目和配置文件,删除前确认自己正在删除哪类内容。更新后出现重复条目,不代表需要复制更多规则;也不要为了识别条目,把含有访问凭据的完整地址写进配置备注。可参照多个订阅的分组与重复条目管理,先整理来源,再判断连接与规则的关系。

远程更新与本地修改分开保存

远程配置更新可能替换本地修改,具体取决于文件来源和更新方式。需要长期保留自定义规则时,先确认当前文件是独立本地副本,还是仍由远程内容维护。更新前保留副本,更新后比较基础字段、例外规则与最终策略,而不只是看文件名称是否相同。不要同时维护多个含义不明的同名文件;名称可说明用途,但不能代替生效状态检查。

分享排查信息时,只提供必要的规则片段和经过处理的现象描述。服务器地址、订阅链接、密码、认证字段和私人访问目标可能涉及隐私,应在分享前移除。示例统一改用文档域名,同时保留规则类型和先后顺序,这样仍能讨论覆盖关系。截图同样需要检查通知、列表和日志中的敏感内容,不能因为只截取了一部分界面就默认没有凭据。

跨设备使用时,应分别验证系统网络环境和当前客户端可用的设置入口,不要将某台设备的结果直接当作所有平台结论。Shadowrocket 提供 iPhone、iPad、Mac、Windows、安卓和 Linux 版本;iPhone / iPad 在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。获取与首次安装处理请查看下载页安装说明;iPhone / iPad 系统要求以 App Store 页面标注为准。

收尾时恢复日常使用的路由姿态,删除临时测试规则,保留最终文件和简短变更记录,再运行前面设计的边界样本。后续出现问题,先比较网络、服务器与配置哪些发生了变化,不急于推翻全部设置。首次导入和连接步骤返回快速上手教程,字段含义不清可查术语表,常见操作疑问则查FAQ;让操作主线、字段查阅与故障定位各自承担清楚的任务。