官方手册 / 配置与规则

Shadowrocket 规则与配置参考大全

从配置文件结构到首条命中:查阅语法、策略、解析行为与验证方法。

本页用于系统查阅,不代替首次连接流程。尚未导入服务器信息时,先按快速上手教程完成 Subscribe 导入、服务器选择与连接验证,再回到本页调整分流。教程负责把连接建立起来,本页解释配置为什么这样写、如何判断修改是否生效。

以下内容以你已有自己的订阅或服务器信息为前提。订阅链接从你的服务商处获取;本站不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐,应用获取费用与线路使用费用是两件事。

获取方式分两档:iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。各平台获取入口见下载页,电脑与安卓等平台的安装包通过本站 /dl/ 提供。

01 配置文件结构与修改边界

Shadowrocket 的配置文件描述连接进入客户端后应怎样处理,不等于服务器凭据清单。Subscribe 导入的内容通常负责维护服务器条目,Config 选中的文件负责规则与相关设置;两者可以分别更新。出现“订阅更新成功,但访问去向没有变化”时,应先检查当前配置,而不是反复导入同一订阅。服务器信息决定能连接到哪里,规则决定哪些请求采用哪种策略。

以区段标题组织配置

配置使用方括号标记区段,例如 [General] 与 [Rule]。General 中常见设置采用键值形式,Rule 中则通常是一行一条、用英文逗号分隔的规则。区段标题不是普通注释,遗漏标题可能让后续内容被归到错误位置。中文逗号、全角等号和从富文本复制来的特殊空格,都可能使看似正确的一行无法按预期解析。

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

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

这是一段结构示例,不是适合所有网络的完整配置。bypass-system 涉及系统流量绕过行为,dns-server = system 表示使用系统提供的解析器。它们不会替你补充服务器信息,也不保证所有连接一定进入 Rule。阅读配置时,应先识别入口与绕过条件,再看规则列表,不能只盯着最后几行策略。

四个常见区段分别负责什么

区段主要职责检查重点
[General]通用网络与解析设置DNS 来源、绕过条件是否符合当前网络
[Rule]匹配请求并选择策略规则顺序、目标字段与 FINAL
[Host]提供指定主机名的本地解析映射地址是否仍然有效、是否覆盖正常解析
[URL Rewrite]按 URL 表达式执行重写或重定向表达式范围、目标地址与可见条件

没有使用某项功能时,不必为了让配置看起来完整而添加对应区段。尤其不要复制来源不明的 Host 与重写集合:一条过期映射就可能绕过正常解析,一条范围过大的重写也可能改变登录或跳转行为。配置越短并不必然越好,但每一条都应能说明用途、影响范围和撤销方式。

编辑、保存与启用是三个动作

在 Config 中找到实际使用的配置,先保存副本并给副本起一个能区分用途的名称,再进入编辑。保存文本后检查错误提示,然后返回配置列表确认选中状态。编辑一个未启用的副本不会改变当前分流;启用另一个远程配置也不会自动合并之前的本地修改。涉及重新建立连接的设置,应断开后再连接,并用新请求验证。

远程配置还存在更新覆盖的问题。若直接改动会被刷新替换的文件,下一次更新可能丢失自定义规则。应先确认该文件的更新方式,再决定使用独立本地副本还是应用支持的保留机制。不要同时维护多份名称相近、内容不同的活动候选文件;排错时记录“文件名称、选中状态、修改内容”比记住最近编辑过哪一份更可靠。

不同平台与构建中的设置入口可能有所差别,本文给出的是配置语义,而不是逐像素界面说明。某项字段若在当前客户端中不能识别,应撤回该项并核对应用内提示,不要靠连续增加参数消除错误。首次操作可返回教程的配置与验证步骤,具体疑问也可在问答页按现象查找。

02 匹配顺序、覆盖关系与 FINAL

理解分流最重要的原则是:在请求进入配置规则处理的前提下,Rule 通常按从上到下的顺序检查,首条匹配成功的规则决定对应策略。客户端不会把全部匹配结果汇总后再挑选“看起来最精确”的一条。因此,规则的文字内容与所在位置同样重要;把精确例外放在宽泛规则下方,往往等于没有写这个例外。

先写例外,再写集合

[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
FINAL,PROXY

在这组示例中,login.example.com 先命中第一行并采用 DIRECT,其他属于 example.com 的域名才有机会命中第二行。如果把前两行交换,登录域名也会先命中后缀规则,后面的 DOMAIN 就不会再改变该请求的决定。不要误以为 DOMAIN 天然高于 DOMAIN-SUFFIX;这里的优先级由排列位置建立。

第三行还体现了另一种覆盖关系:若某个 example.com 子域名同时含有 ads,第二行已经命中,后面的关键字拒绝就不会执行。要先明确业务意图:整个域名族都走 PROXY,还是广告关键字必须优先拒绝。顺序没有脱离目标的标准答案,但必须能解释每个交集中的请求应走哪一行。

FINAL 是兜底,不是强制覆盖

FINAL,PROXY 表示前面的规则都没有决定去向时采用 PROXY。它不带域名条件,也不负责纠正前面写错的条目。把 FINAL 放在规则中段,会让后续本可匹配的规则失去处理普通请求的机会。常规配置应把它放在 Rule 的末尾,并只保留一条清晰的兜底,避免重复 FINAL 造成阅读歧义。

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

这里先检查域名,再检查目的地址所属的地理数据库分类,剩余请求才采用兜底。一个域名即使解析到被 GEOIP 分类为 CN 的地址,只要前面的后缀规则先命中,仍然会走 PROXY。反过来,域名信息不可用时,这条域名规则可能无法匹配,就需要继续检查地址规则。验证结果前,应先确认当时可供匹配的是主机名还是地址。

顺序与绕过条件不是一回事

“从上到下”描述的是进入这份规则列表之后的行为,不意味着列表能覆盖所有系统路由、通用绕过设置和既有连接。流量如果已经被更早的处理路径绕过,移动 Rule 中的行数并不能把它重新纳入。排查局域网访问时尤其要区分 General 的绕过设置、系统自身路由与 Rule 中的 DIRECT,三者表象可能相近,发生阶段却不同。

同样,切换规则后,已经存在的长连接可能继续沿用原来的连接路径。浏览器复用连接、应用后台保活和域名解析缓存,都可能让“刷新了一次”不足以证明新规则失效。应先生成一次新的目标连接,必要时退出目标应用后重试,再对照记录中的目的域名、命中规则和策略。只根据页面是否打开来判断优先级,会把服务器状态与规则问题混在一起。

用反例检验优先级

每增加一条例外,至少准备两个测试目标:一个应该命中新规则,另一个与它相近但不应命中。例如修改 login.example.com 后,还应测试 api.example.com;添加地址网段后,再测试一个网段之外的地址。这样可以同时发现“规则没生效”和“规则范围太大”两类错误,比只访问成功一次更有判断力。

03 域名、地址与请求特征规则

规则类型决定拿请求的哪一部分进行比较。域名类规则看主机名,地址类规则看目的 IP,USER-AGENT 看可获得的请求标识。它们不是同一信息的不同写法,也不能任意互换。选择类型时,先问“希望约束一个完整域名、一个域名族、一个网段,还是某类可识别请求”,再确定语法。

DOMAIN 与 DOMAIN-SUFFIX

DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.net,DIRECT

DOMAIN 适合精确例外,匹配 api.example.com 这个主机名,不会自动包含 img.api.example.com。DOMAIN-SUFFIX 用于域名后缀,example.net 本身和其下的子域名属于预期范围,而 notexample.net 并不是 example.net 的子域名。域名字段不要带协议头、路径、端口或末尾斜杠;这些内容不属于域名匹配字段。

如果需要区分同一网站的登录、图片与接口服务,应优先从实际请求中确认对应主机名,而不是假设它们都在主站域名下。现代应用可能使用独立资源域名,同一个页面也可能建立多条连接。主页面命中规则只说明这一条连接的结果,不代表全部资源都采用相同策略。

DOMAIN-KEYWORD 的范围更宽

DOMAIN-KEYWORD,ads,REJECT

这条规则用于说明域名包含关键字时的匹配方式,不是通用拦截建议。ads 只是字符片段,可能出现在并不需要拒绝的域名中。关键字规则通常比后缀规则更难限定边界,部署前应检查误伤样本。若已知道要处理的完整域名或稳定后缀,优先采用更明确的类型,能降低维护成本。

IP-CIDR、IP-CIDR6 与 GEOIP

IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
GEOIP,CN,DIRECT

IP-CIDR 使用 IPv4 地址与前缀长度描述网段,IP-CIDR6 处理 IPv6。前缀不是端口号,也不是可随意省略的备注;网段写大可能把不相关目的地址一并纳入。示例中的私有地址与 IPv6 本地地址范围只是用途说明,是否直连还应结合系统路由和所在网络,不要据此认定所有内部地址都可达。

no-resolve 的含义是避免仅为这条地址规则主动解析域名;如果请求本身已有目的 IP,仍然可以比较。它不是关闭整个客户端 DNS,也不等于任何域名请求都能自动匹配私有网段。GEOIP 则依赖地址数据库分类,不代表网页内容类别、企业注册地或用户所在地区,数据库差异和地址分配变化都可能影响结果。

USER-AGENT 与可见信息边界

USER-AGENT,ExampleApp*,DIRECT

USER-AGENT 用于匹配可获得的 User-Agent 标识,示例中的 ExampleApp 是虚构测试名称,星号表示通配匹配意图。它不是系统应用包名规则,也不能保证识别所有加密请求。若连接阶段无法取得对应请求头,这条规则就没有可靠的比较对象;不能因为某应用名称接近示例,就认为其全部连接都会被匹配。

类型比较对象常见误写
DOMAIN完整主机名写入完整 URL
DOMAIN-SUFFIX域名及子域名误当作任意字符结尾
DOMAIN-KEYWORD域名中的字符片段低估误匹配范围
IP-CIDR / IP-CIDR6目的地址网段把地址范围当成域名范围
GEOIP目的地址数据库分类按网页内容类别推断结果
USER-AGENT可获得的请求标识误当作通用按应用分流
FINAL前面未命中的请求放在列表中段

当两种类型都能表达需求时,优先选含义最清晰、依赖条件最少的一种。域名例外通常用 DOMAIN,整个域名族用 DOMAIN-SUFFIX,明确的内部地址范围用 CIDR。只有确实需要宽泛覆盖时再考虑关键字;每条宽规则都应配一个不应命中的反例,避免错误随列表增长而被隐藏。

04 PROXY、DIRECT、REJECT 与 Global Routing

规则回答“匹配哪类请求”,策略回答“匹配后怎样处理”。本页使用的 PROXY、DIRECT、REJECT 是三种基础策略关键字,配置中保持英文大写。它们与界面里的 Config、Proxy、Direct 不是同一层级:前者出现在规则动作位置,后者属于 Global Routing 的工作姿态。把两层混淆,是“规则写好了却没有按规则运行”的常见原因。

三种基础策略的含义

PROXY 让命中的连接采用代理路径,实际使用哪一个服务器或相关策略选择,应结合 Home 中的选择与当前配置确认。写了 PROXY 并不等于已经拥有可用服务器,也不保证认证、传输与目标访问成功。服务器选择错误、凭据过期或目标不可达时,规则仍可能正确命中,而后续连接失败。

DIRECT 表示直接连接目标,不经所选代理服务器。它仍然依赖本机网络、DNS、系统路由与目标服务状态,并不是“绕过一切网络问题”。例如访问内部管理页时,即使策略已是 DIRECT,设备没有接入对应局域网,仍然无法建立连接。排错时应把“选择了直连”和“直连能够到达”分开验证。

REJECT 用于拒绝命中的连接。它的预期结果就是请求失败或资源不加载,而不是自动切换另一条可用路径。应用可能对被拒绝的请求不断重试,产生额外记录;也可能因某个基础接口被拒绝而整体工作异常。出现这类现象时,先定位拒绝的目标,不要因为主页面打不开就直接认定服务器失效。

Global Routing 的三种姿态

界面词中文说明适用检查
Config配置:按当前配置处理分流检查 Rule、优先级与兜底
Proxy代理:以代理姿态处理所接管流量暂时隔离规则差异
Direct直连:以直连姿态处理所接管流量比较本机网络访问结果

日常验证自定义规则时应选择 Config。Proxy 可用于对照“代理路径本身是否工作”,Direct 可用于对照“本机网络是否可达”,但两者都不是证明某条 Rule 生效的依据。这里的姿态说明也不意味着能够接管所有系统流量;系统绕过、应用行为与既有连接仍需分别考虑。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN,printer.example.net,DIRECT
DOMAIN,metrics.example.org,REJECT
FINAL,PROXY

用同一目标做受控对照

如果某目标在 Proxy 下能够访问,在 Config 下失败,应检查 Config 中是否被 DIRECT、REJECT 或更早的规则命中,而不是马上替换服务器。若 Proxy 与 Config 都失败,再检查代理路径、解析与目标状态。若 Direct 成功而 Proxy 失败,则需要进一步检查所选服务器及其到目标的连接,不应据此推断所有规则都有问题。

对照测试应保持目标、网络和服务器选择尽量一致,每次只改变一个条件。频繁同时切换网络、模式和节点,会让结果无法归因。还应区分页面首次加载与后续资源请求:一个网页可能同时出现 PROXY、DIRECT 与 REJECT 记录,不能拿其中任意一条代表整个网页的行为。

协议参数与分流策略各管一层

Shadowsocks、VMess、VLESS、Trojan 等协议决定代理连接如何建立,Rule 决定哪些请求交给代理路径。把 DOMAIN-SUFFIX 改成 DOMAIN 不会修复服务器密码错误;修改传输参数也不会自动纠正一条过宽的拒绝规则。需要核对协议字段时,可阅读协议与常见参数说明,再回到这里检查请求去向。

On Demand 负责按条件触发连接,与 Global Routing 选择的分流姿态同样应分开理解。自动连上不代表一定采用 Config,手动连接也不代表规则被忽略。完成一次模式切换后,返回当前连接状态与配置选择处复核,避免把自动连接行为当成规则选择结果。

05 DNS、Host 与地址规则的相互影响

域名规则与地址规则依赖的信息不同,因此 DNS 经常成为分流排错的分界点。域名解析把主机名转换为地址,Rule 再根据当时可获得的信息判断策略;实际处理还会受到缓存、连接方式和客户端设置影响。不要把“解析到了某个地址”直接等同于“使用了某个出口”,解析路径与业务连接路径需要分别核对。

先记录现状,再调整解析来源

[General]
dns-server = system

这行表示使用系统解析器,适合作为理解字段的起点,而不是通用最优配置。系统解析器由当前网络与系统设置提供,切换无线网络或移动网络后,实际环境可能改变。若目标只有在特定网络中才能解析,例如内部主机名,随意改用另一套解析来源反而可能让它失效。修改前应记录目标域名、原解析结果与网络条件。

排查解析问题时,先确认失败发生在解析之前还是连接之后。没有得到地址、得到地址但连接超时、连接建立后证书报错,是不同层面的问题。只有第一类可以优先怀疑解析路径;其余情况还涉及地址可达性、目标服务、时间设置和握手条件。连续更换 DNS 而不看失败阶段,容易掩盖真正原因。

Host 映射只改变解析结果

[Host]
portal.example.com = 192.0.2.10
test.example.net = 198.51.100.20

Host 区段给指定主机名设置本地映射。上面的地址属于文档示例保留范围,不能用于实际访问。Host 不会替服务器生成证书,也不会把原本不可达的地址变成可达;即使域名解析到了指定 IP,服务端仍需正确处理该主机名。不要把 Host 当作解决任意网页错误的快捷开关。

配置真实映射时,应先确认目标地址是稳定且由你有权管理的服务提供。许多站点采用动态地址、区域调度或多地址容灾,把它们固定为一次查询得到的 IP,可能暂时成功但随后失效。后续网络变化时,这条映射还会继续覆盖正常解析,因此每条 Host 都应有明确用途,并在不需要时删除。

地址规则为何有时不命中

[Rule]
DOMAIN,portal.example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
FINAL,PROXY

第一行直接按主机名确定策略,不需要依赖后面的地址范围表达相同意图。后两行只覆盖特定网段,并且不为匹配而主动解析域名。若希望某个明确的内部域名始终直连,通常应显式写域名规则,而不是假设它总能解析到某个私有网段,再依赖地址规则间接命中。

同一域名可能同时返回 IPv4 与 IPv6 地址。只配置 IPv4 网段,不能据此推断 IPv6 连接也会进入该规则;只检查一次解析结果,也不能代表所有请求都使用同一个地址。出现“有时正确、有时不同”时,应记录本次实际目的地址及地址族,再比较规则范围,而不是不断添加重复域名条目。

缓存、GEOIP 与观测误差

DNS 缓存可能来自客户端、系统或目标应用,已有连接又可能继续复用旧地址。修改 Host 或解析设置后,先建立新连接,再观察是否使用新结果;必要时按应用提供的方式清理相关缓存。不要为了验证一个域名而一次重置全部网络设置,那会引入过多变量,也不利于确认是哪项修改起作用。

GEOIP 使用目的地址的数据库分类,不是对域名归属的权威判断。内容分发服务和地址重新分配都可能让直觉与分类不同。若一项业务必须采用固定策略,应使用明确域名例外放在 GEOIP 前方;不要为了单个目标改动整段地理分流。对地址归类的争议,最终应回到本次目的 IP 和首条命中记录核实。

06 URL Rewrite 的作用与安全边界

URL Rewrite 处理的是可识别的 URL 表达式与替换关系,Rule 处理的是连接应采用哪种策略。两者可以出现在同一份配置中,但不能相互代替。想让一个域名走代理,应写分流规则;想把一个明确的旧地址重定向到新地址,才考虑重写。把访问失败都交给 URL Rewrite 处理,会让原本简单的连接问题变成更难追踪的跳转问题。

先读懂一条最小重定向

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

这条示例描述从指定 HTTP 地址到 HTTPS 地址的重定向关系。左侧是正则表达式,中间是替换目标,末尾的 302 表示临时重定向。开头的脱字符约束从字符串起始位置匹配,结尾的美元符约束结束位置,反斜杠让域名中的点按普通点号处理;捕获组中的内容通过替换目标里的 $1 引用。

它只是语法说明,不要求实际访问示例域名,也不说明任何网站都适合由客户端强制改写。真实部署前,应确认目标服务支持新地址、路径语义一致,并检查查询参数、登录回调与资源引用是否仍然正确。重写可以改变请求目的,并不能保证新目的具有相同内容或权限行为。

表达式范围必须可解释

域名中的点如果没有转义,在正则中通常表示任意单字符,可能扩大匹配范围。省略起始或结束约束也可能让表达式匹配到预期之外的位置。不要把普通域名后缀匹配的直觉带进正则表达式:DOMAIN-SUFFIX 和正则的语义不同,前者的域名边界不会自动出现在后者之中。

逐步缩小匹配范围比写一条包揽所有地址的表达式更容易验证。先针对一个完整主机名与明确路径测试,再决定是否引入捕获组。每增加一个通配范围,都应准备一条不应被改写的地址作为反例。若无法说明某个括号或转义符的用途,就应暂停部署,避免靠试错修改正在使用的配置。

区分重定向与透明改变

带 302 的重定向会让支持该行为的客户端继续请求目标地址,后续请求还要经历解析、连接和规则处理。它不是把原连接悄悄变成另一条线路。目标地址若再次匹配另一条重定向,就可能形成多次跳转;两条相反方向的规则更可能构成循环,表现为页面无法完成加载。

排查循环时,应先停用新加的重写,确认原访问是否恢复,再检查从源地址到目标地址的完整链路。浏览器缓存和站点自身重定向也可能参与其中,因此要用新请求核对,而不是只看地址栏最后停在哪里。涉及永久重定向的行为更应谨慎,测试阶段应避免让缓存结果干扰判断。

HTTPS 不会自动暴露完整路径

普通加密连接不会因为配置里出现 URL Rewrite 就自动向客户端提供全部请求路径与请求头。域名级连接信息和完整 URL 不是同一回事。某些 HTTPS 重写能力依赖额外的解密条件与证书信任设置,本页不要求为分流启用这些功能,也不建议为修复一条域名规则而扩大解密范围。

若当前目标是“指定域名直连或代理”,应回到 Rule,而不是添加与证书有关的设置。若确有授权测试需要,也应限定主机范围,理解应用证书固定与敏感会话的影响,并保留撤销方式。不能把“重写没有触发”直接归结为表达式错误,还要先判断客户端是否能看到足够的请求信息。

维护远程配置时,应特别留意新增的重写区段。规则更新不只是改变代理去向,也可能改变访问地址。更新后若出现登录返回异常、链接跳转不同或资源地址被替换,应对比 URL Rewrite 与 Host 的差异,而不是只检查 Rule。最小化保留确实需要的功能,能让后续排错更有边界。

07 常见规则写法与组合方法

组合规则时,先用一句话描述目标,再把它拆成精确例外、宽泛集合与兜底。下面的片段相互独立,用于解释排列方法,不提供任何线路信息。实际使用前,把示例主机名替换成你已确认的业务目标,并保留原配置以便比较。不要因为某段代码较短,就省略验证或把它覆盖到现有文件上。

指定域名走代理,其余直连

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

这组规则表达的是明确允许列表:只有精确接口域名与指定域名族采用 PROXY,其余请求走 DIRECT。它适合目标范围已知且能够持续维护的场景。如果应用还依赖其他资源域名,这些连接会落到 FINAL,DIRECT;因此接口可用但图片或登录失败时,应先观察遗漏的域名,而不是把现有条目重复写几遍。

维护这类配置应记录业务依赖,不要只按网页地址栏判断。登录授权、静态资源、文件上传可能使用不同主机名。新增域名时仍应选择最小必要范围,确认确实属于同一业务链路,再决定使用 DOMAIN 还是 DOMAIN-SUFFIX。未经观察就加入过宽关键字,可能改变其他应用的去向。

局部直连,其余采用代理

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

这里先保留一个明确主机名的直连例外,再处理私有地址与 GEOIP 分类,最后使用代理兜底。它与上一组片段的主要差别不是行数,而是“未列出的目标”采用不同策略。评估配置前,必须先读 FINAL,因为兜底决定新增业务、未知域名和未命中地址的默认行为。

这组规则也不是对所有局域网的完整覆盖。不同网络可能使用其他私有地址范围,IPv6 也需要单独考虑;系统与 General 的绕过行为还可能先发生。需要访问内部服务时,应根据实际地址与主机名补充规则,而不是照抄一串未经核对的网段,并认定局域网问题已经解决。

后缀规则中的精确例外

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

先列登录与统计接口的例外,再给其余域名族统一策略。这里的 REJECT 只是展示例外位置,并不代表该接口可以在真实业务中安全拒绝。实际服务可能把统计、初始化与必要功能合并在同一主机名上;拒绝整个主机名可能产生连带影响,应先验证其职责,再决定是否保留。

如果同一域名下不同路径需要不同处理,DOMAIN 无法区分路径,增加多条相同域名也不会改变这一点。此时应先重新评估需求是否必须按路径处理,而不是给域名字段添加斜杠。分流规则与 URL Rewrite 的能力边界不同,不能用语法拼接把一种规则变成另一种。

合并配置时保留一个决策顺序

合并两份规则列表,不是把两个文件首尾相接。先去掉重复区段标题与中途的 FINAL,再按业务例外、域名集合、地址范围、兜底重新审查。完全相同的重复行通常只是增加阅读成本,而同一条件对应不同策略则是实际冲突:靠前的一条生效,靠后的条目可能让维护者产生错误预期。

订阅分组与规则分流也应分开管理。订阅名称改变不应成为你无法解释去向的原因,删除某个订阅前则要确认当前代理选择仍然有效。多来源条目如何整理,可参阅多个订阅的分组、更新与重复条目清理;整理服务器列表之后,再独立验证规则是否仍然引用了预期路径。

建议每次只引入一个组合目标,例如先完成内部地址直连,再处理特定域名代理,最后才加入拒绝例外。每一步都记录一个成功样本和一个反例。这样的配置即使不长,也能明确解释每一条存在的理由;发生异常时,可以快速撤销最近一组修改,而不必重建全部规则。

08 规则验证、故障定位与维护流程

验证分流不是检查网页能否打开,而是把请求目标、命中规则、采用策略与最终连接结果连起来。网页成功可能来自缓存,失败可能来自服务器或目标服务;两者都不能单独证明规则正确。排错应从最容易核对的当前状态开始,沿着连接处理过程逐层缩小范围,避免把多个独立问题同时修改。

第一步:固定当前测试条件

记录当前网络、选中的服务器、Global Routing 姿态与 Config 文件名称。确认开关已连接,并且当前使用 Config,随后挑选一个你能明确说明预期去向的目标。暂时不要切换多个服务器或重新导入订阅;如果测试条件一直变化,就无法判断下一次成功究竟来自规则调整还是网络恢复。

检查配置是否保存、是否启用,以及远程刷新有没有覆盖本地修改。若目标是测试新规则,应发起新连接,尽量避免复用旧会话。对浏览器可关闭相关页面后重新打开,对独立应用可退出后重试;不必一开始就重置系统网络。每个动作都应服务于消除某个具体变量。

第二步:核对目标与首条命中

在应用可提供的连接记录或诊断信息中,查找本次请求的域名、目的 IP、规则与策略。记录里显示的接口域名可能与页面地址不同,应以实际请求为准。先确认请求是否进入当前配置,再检查它是否被更早的后缀、关键字、地址规则或拒绝例外截获;不要只搜索自己刚添加的那一行。

如果看不到预期域名,应考虑请求只带地址、加密连接可见信息有限、应用使用了其他主机名或记录范围不同。不要凭猜测添加几十条域名。先用同一规则类型构造一个更容易观察的测试目标,确认基础匹配逻辑,再回到原应用分析。USER-AGENT 尤其需要先证明对应标识能够被获得。

第三步:把策略正确与连接成功分开

观察结果优先检查下一步
命中意外的 REJECT关键字范围、精确例外顺序缩小规则并重建连接
命中 PROXY 但失败服务器选择、认证、目标可达性用 Proxy 姿态做同目标对照
命中 DIRECT 但失败本机网络、DNS、内部路由对照实际目的地址与网络条件
总是落到 FINAL目标字段、规则类型、可见信息核对域名与地址是否符合条件
修改后表现不变选中文件、缓存、已有连接检查保存与启用,再发起新请求

Connectivity Test 可以辅助检查服务器连接情况,但不能替代某个业务目标的完整访问测试。测试地址与实际目标不同,使用的协议能力与请求类型也可能不同。同样,Data 中出现上传下载读数,只能说明相应统计范围内有流量,不能单凭流量大小断定某条规则命中。统计视图的含义见Data 页流量统计说明。

第四步:保留证据并做最小回退

遇到新增配置后的异常,先停用最近加入的一组规则或重写,恢复之前保存的配置对照。若恢复后正常,再逐项重新引入,而不是把所有设置重置。记录中应包含目标、预期策略、实际首条命中和报错阶段;这些信息比“有时打不开”更能帮助判断是否属于顺序、解析或代理连接问题。

需要分享排错材料时,删除订阅链接、认证字段、访问令牌及包含个人信息的查询参数。教学与交流可以使用 example.com 和保留地址重现结构,不必公开真实凭据。规则示例中的域名通常不敏感,但连接记录可能带有完整路径和会话信息,整理前应逐项检查,而不是直接转发全部配置。

建立可重复的维护检查

每次更新规则后,至少复测一条代理目标、一条直连目标和一个应该被排除的反例;若使用 REJECT,还应确认拒绝范围没有扩大。更换网络后重点检查内部地址与 DNS,更换服务器后重点检查代理路径,更新配置后重点检查顺序和新增区段。测试集合可以很小,但应固定且能覆盖你的实际用途。

当问题属于首次连接步骤,可回到快速上手教程重新核对;属于获取或系统放行,查看下载页的安装放行说明;属于常见使用疑问,进入问答页。规则参考的最终目标是让每个结果都有可追溯的条件,而不是不断增加规则直到某次访问碰巧成功。