官方手册 · 配置参考

Shadowrocket 配置大全

配置文件结构、分流规则与匹配优先级

第一次连接时,先按快速上手导入已有的订阅或服务器信息,确认连接能用。需要解释某次请求为什么走直连、为什么命中默认策略,或准备修改配置文件时,再回到本页查对应章节。尚未获取客户端,可先查看全平台下载。

iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片版及 Intel 版)、Windows、安卓、Linux 版免费,安装包从本站 /dl/ 获取。客户端一次性买断 ≠ 线路套餐。本站不提供、不销售、不推荐节点或订阅。

配置文件结构与 [General]

读一份配置时,先确认正在使用哪份文件,再看规则内容。导入成功只说明文件已经进入客户端,并不等于它正在处理当前连接。从 Config 确认生效的文件,再回到 Home 核对 Global Routing。如果后者没有选择 Config,就不能用实际连通结果来判断文件中的普通分流规则是否命中。开始编辑前保留一份可切回的原配置,并记下当前使用的文件名和模式。

先按段落定位,再看每行参数

方括号标出段名。接下来的内容归属于该段,直到下一个段头。[General] 放通用设置,[Rule] 放匹配条件与策略,[Host] 用于主机名解析映射,[URL Rewrite] 放对符合条件的 URL 采取的改写动作。它们不是四级优先级,也不代表文件从头到尾把一次请求依次执行四遍。排查时根据问题找段落:去向不符看分流,解析不符看主机映射,路径发生变化才去检查重写。

四个常用配置段的职责
配置段主要作用修改前记录
[General]设置连接处理的通用选项。原有排除项以及需要继续处理的请求。
[Rule]按条件选取连接策略。请求的实际目标、预期策略及默认策略。
[Host]指定个别主机名的解析映射。目标主机名、原地址及测试地址。
[URL Rewrite]匹配 URL 并执行指定的改写动作。原始 URL、预期目标及跳转结果。

这四段的行格式不可互换。等号连接设置名与值,也用于下文的静态映射示例;规则段用逗号分隔字段;重写示例则用空格分隔匹配式、目标地址和动作。复制代码块时不要把解释文字写进文件。若应用提示无法读取,先检查刚改过的段头和字段分隔符,尤其是输入法生成的全角逗号、全角等号,以及编辑器自动插入的换行。网页上的视觉换行和文件里的真实换行是两回事,一条规则应保留在同一行。

通用设置:只保留已知用途的排除项

[General]
skip-proxy = localhost, 127.0.0.1

skip-proxy 是通用设置中的排除列表,示例列出两个本机目标。它不是一行 DIRECT 规则:前者涉及请求进入代理处理的范围,后者是请求进入规则匹配后得到的策略结果。不要把分流日志中缺少某项简单理解为该项命中了直连规则。尤其在不同网络、不同应用的请求采集方式不同时,应核对请求是否进入了当前客户端的处理范围,再讨论具体命中行。

保留原文件里的其他通用设置,不要为了添加一条域名规则而复制整段来源不明的设置。若排除列表已经包含其他目标,先逐项确认用途;重复写同一个设置名并不能代替合并列表,也不应假定它会自动追加。若目的是解决某个服务走错路径,优先在 [Rule] 加精确规则并测试,只有确认问题出在通用设置覆盖的范围时,再单独改该设置。这样做能保留可比较的修改前后状态。

同时修改文件、模式和服务器,往往会让测试失去对照。做一次只变一个因素的复测;先确认配置能读,再确认请求确实走到新规则。

区分订阅内容与本地规则副本也很重要。已有的订阅可能用于更新服务器条目,也可能由外部来源提供整份配置,两个行为不能混为一谈。编辑前弄清应用正在使用的是导入后的本地副本,还是仍会随远程来源更新的配置。如果本地改动在刷新后消失,先检查文件来源和当前选中的文件,不要立刻换一种规则语法。把自定义行另存为不含凭据的记录,下一次更新后就能核对是否仍需合并。

域名规则:精确、后缀与关键字

知道要处理的主机名时,先使用域名规则。域名字段只写主机名,不写协议、端口、路径或查询参数。若从网页地址抄写条件,应先从完整地址中取出主机名。页面地址栏只能告诉你顶层页面在哪里;图片、会话接口和静态资源可能访问别的主机。看到主页能打开但部分内容失败,先区分具体失败请求,不能据此推断同一个主机名同时走了两种策略。

用最窄的条件表达需求

域名规则对照
关键字条件示例命中范围
DOMAINapi.example.com只匹配这个完整主机名。
DOMAIN-SUFFIXexample.com匹配该域及其子域,不把相似拼写当作子域。
DOMAIN-KEYWORDexample匹配主机名中包含该字符串的请求。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT

这段示例先把接口主机列为例外,再把同一域下的其他请求交给 PROXY。请求 api.example.com 会在第一行停止,不再执行第二行。访问 www.example.com 会命中后缀行;访问 api.example.org 不属于该后缀,却会命中关键字行。关键字行的价值是展示覆盖范围,不是建议把它留在所有配置里。只想处理一个可明确列出的域时,应删掉这条宽条件;如果确实有多个后缀,通常逐条写出会更便于今后复查。

后缀不是文件扩展名,也不是 URL 结尾。比如 example.com.other.test 并不是 example.com 的子域,而 assets.example.com 是。关键字不要求按域名标签对齐,同一个片段出现在不相干的主机名里也可能命中。不要把品牌简称、环境名或常见业务词直接用作关键字,除非已经检查过相似域名。需要同时照顾一个站点和它的测试域时,两个精确或后缀条件通常比一个模糊条件容易维护。

对照请求目标,而不是网站显示名

对网页故障,最好记下可复现的页面动作,例如打开页面、读取某张图片或提交一次表单,并核对该动作产生的主机名。对其他应用,不要把桌面图标显示的名称填进域名字段。客户端如果只能看到目的 IP,就不能用域名规则去匹配主机名;检查记录里显示的是请求域名还是地址,再选择对应类型。域名解析到了某个地址,也不意味着该地址所属的其他域应共用同一策略。

路径差异也不属于域名规则的匹配范围。同一主机上的两个路径即使功能不同,也会命中相同的域名条件。把斜杠和路径加到 DOMAIN 的第二列不会得到更精确的分流。如果目的是调整自己管理的 HTTP 地址的路径,参见 URL Rewrite;如果只是想只测一个接口,仍可使用该接口的完整 URL 发起测试,但匹配条件写的应是它的主机名。

验证域名规则至少用两种样本:一个本来就应命中的目标,一个拼写相似但不应命中的目标。还定义了例外时,再测例外,确认前面的宽规则没有把它接走。

服务端新增资源域时,先确认该资源是否确实属于同一用途,再决定补一条精确条件还是扩大原来的后缀。扩大后缀会影响之后才出现的子域,虽然省去重复维护,也可能把测试或管理入口一并改道。若不确定共用范围,先把新主机单独列出来。需要速查各关键字的字段与边界,可读规则类型详解。

地址规则:GEOIP、IP-CIDR 与 IP-CIDR6

地址规则匹配的是连接目的地址,不是设备自己的地址,也不是访问者所在地区。它适合处理直接用地址访问的服务、确认过用途的地址段,或在域名例外之后执行较宽的地区条件。用地址来表达稳定的内部网段通常很直接;用地址来代替公网域名则应谨慎。公网服务可能换地址,也可能与无关站点共用地址,因此一次解析结果不宜直接变成长期规则。

先分清地址族和前缀范围

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,2001:db8:1::/48,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

IP-CIDR 写 IPv4 网段。示例中的 /16 表示前十六位固定,会覆盖从 192.168.0.0 到 192.168.255.255 的整个范围。如果实际需求只是访问一台地址固定的设备,用该地址加 /32 会更窄;确实需要一个由前三段共同标识的子网时再用 /24。前缀越短,覆盖越广,不能把斜杠后的数字理解为设备数量。写进文件前,最好用一个网段内地址和一个相邻网段地址分别检验边界。

IP-CIDR6 写 IPv6 网段。示例使用的是文档示例地址,不是可用的线上服务。固定单个 IPv6 地址可用 /128;不要用一条 IPv4 条件推断 IPv6 请求会得到相同策略。一个主机可能同时解析出两类地址,客户端实际连接的目标会受网络和服务状态影响。相同域名在不同网络下结果变化时,可以对比两次实际使用的地址族,再回查是否只有一类地址配置了对应条件。

理解地区数据与解析的边界

GEOIP,CN,DIRECT 是指目的地址被地区数据归类为 CN 时执行 DIRECT。它不是按域名后缀判断,也不会识别内容语言、账号地区或服务商名称。使用共享基础设施的站点可能在不同网络上解析到不同地址,数据库中的地区归类也可能与预期不同。对于要求始终走同一路径的个别站点,优先写域名例外,再把地区规则当成一般条件,而不是把标记当作站点身份的证明。

目标最初以域名出现时,单凭域名不能判断地址条件:匹配必须获得可用的目的地址,有时还会涉及解析。写在前面的地址规则可能使一次本可由域名决定的请求先进入地址判断。已知某主机必须走特定策略时,把它的域名规则放在需要判断地址的通用规则之前;只有确实想让地址范围优先时,才将地址规则前移,并用带已知域名的请求复测。不要把浏览器中另外一次查询的结果当成客户端本次一定使用的结果。

地址匹配和地址可达是两件事。一个目标可能正确命中 DIRECT,但当前网络没有到该网段的路由;此时继续改前缀并不会建立这条路由。

排查内部服务时,先核对网络归属。两个不同位置可能使用相同的私有网段;离开原网络后,原地址可能不可达,也可能指向另一台设备。广泛的私有地址直连规则不能区分这些位置。如果只有一处服务需要放行,记录限定条件,不要为了求省事扩大到全部私有地址。还要检查已有通用排除项:目标若不进入规则处理,看不到地址规则命中并不说明前缀写错。

为地址规则保留两份测试观察:一份记录实际命中的行,另一份记录连接在哪一步结束。地址范围内的测试失败时,先看它是走错了策略,还是按期走了直连却无法到达;走代理失败则检查已选服务器能否访问该测试目标。不应根据一次不可达就将整个网段从直连改为代理。需要回滚时,撤掉刚加入的地址条件并用同一个目的地址重试,才能判断新规则是否是造成变化的变量。

请求标识与 PROXY、DIRECT、REJECT

规则前面的字段说明测试什么,行末的字段说明命中后做什么。USER-AGENT 是按可用的请求标识做判断的一类条件;PROXY、DIRECT、REJECT 则是策略。不要把标识当作策略,也不要把界面里的 Proxy 模式写到规则行首。下面的示例把三种策略放在不同的行,以便分别验证命中与执行结果。

按请求标识匹配的前提

[Rule]
DOMAIN,unused.example.com,REJECT
USER-AGENT,ExampleReader*,PROXY
DOMAIN,docs.example.com,DIRECT
FINAL,DIRECT

示例中的 ExampleReader* 用于说明前缀匹配:目标是请求实际带来的 User-Agent 值,不是应用图标名称、安装包名称或登录账号。不同请求库可能使用不同的标识,一款应用的网页视图、资源加载与后台任务也可能给出不同值。标识能改写或省略,不能用它代替身份校验,更不能据此断定某次连接一定来自特定应用。测试时,应使用可控制的示例请求,并记录发出的标识和实际命中行。

此外,规则是否可用取决于客户端在该请求上看到了哪些字段。连接记录有主机名,并不代表同时有可读的请求头。尤其不能把“连接到了一个加密站点”理解为“标识字段必然可供匹配”。若记录不能支持这个判断,不要通过不断缩短关键字来试图让它命中。需求本来就是处理某个服务时,优先使用能核对的精确域名;只有确实需要按标识区分请求,而且验证样本能看到该字段时,才保留这类规则。

选定策略后,要验证执行而不是只看网页

内置策略的作用与验证方法
策略作用优先核对
PROXY按当前代理选择处理请求。代理选择是否正确,服务器是否能访问该目标。
DIRECT从当前网络直接访问目的服务。当前网络的解析、路由与目的服务是否可用。
REJECT拒绝匹配的请求。被拒绝的是否确为预期的主机或请求。

PROXY 不是服务器地址,也不会自动补齐订阅。命中后,客户端仍需要已有且已选中的可用服务器。如果命中记录与预期一致,但页面请求失败,先用相同选择测试一个已知可达的非敏感目标,再检查该代理能否处理出错的目标。订阅刷新遇到问题,可回到快速上手核对导入与连接步骤。测试服务器可用性和改写分流条件是两个不同的操作,不应同时进行。

DIRECT 也不等于退出客户端或关闭连接。它说明这条请求选择了直接访问,客户端仍可对其他请求应用别的规则。REJECT 则是主动拒绝;应用端可能提示失败、反复重试,或者只表现为局部资源缺失。不能仅凭失败页面断定是拒绝规则,也不要因为部分资源没加载就改掉所有拒绝项。先缩小到确切命中的请求和规则,尤其注意一条宽后缀可能同时覆盖正文、登录和资源服务。

同一个请求可能同时具备多个条件:例如示例中的文档主机也可能使用指定标识。在标识可匹配的前提下,它会先执行标识行的 PROXY,而不是后面的精确域名直连。若要求文档主机始终直接访问,就把它的域名规则移到标识行前。调整后要复测该主机,也要复测一个应继续走代理的对照请求,避免一条修正改变不相干的行为。

匹配顺序、FINAL 与 Global Routing

验证分流先核对 Global Routing,再核对文件内行序。同一份文件在不同模式下有不同作用。要检查某条 [Rule] 是否生效,先选 Config。如果正在使用 Proxy 或 Direct 对照连接,只能用结果区分整体代理路径或直接访问路径是否可用,不能用它证明某条规则写对了。对照测试结束后,记得切回原来需要的模式。

模式与规则策略的关系
界面词选择依据适合验证
Config按当前配置处理分流。规则命中顺序、例外与默认策略。
Proxy对进入处理范围的流量采用代理路径。使用当前服务器时请求能否完成。
Direct对进入处理范围的流量采用直连路径。当前网络直接访问目标是否可用。

先命中先执行,不自动挑最精确的一条

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

以一条已进入规则匹配的新请求为例:访问 health.example.com 时,第一条满足条件,当即选择直连;访问 www.example.com 则在第二条停止。其余请求才有机会进入地区判断,仍未匹配才执行 FINAL。如果交换最前两行,检查地址也会被后缀接走。这不是精确规则失效,而是精确规则还没轮到执行。编排时应从已知例外、常规条件写到较宽条件,只有业务明确要求覆盖例外时才改变这套顺序。

两个同范围的条件写了不同策略时,也不会等到文件末尾再以最后一条为准。发现重复行时,先追溯前面的行是否来自原配置,再确定是替换原策略,还是新增范围更窄的例外。如果不易找出遮挡,把目标主机与它可能命中的所有条件按文件顺序列出来。第一条有足够信息且满足条件的行就是优先检查对象,不要跳过它去不断重写下面的精确条件。

默认策略是行为选择,不是故障修复

FINAL 只有规则名和策略,不写域名或地址字段。把它保留在 [Rule] 最后一行;写在它后面的普通条件不会成为有效例外。FINAL,DIRECT 让未列出的请求直接访问,适合明确列出需代理目标的配置;FINAL,PROXY 让未列出的请求采用代理,适合以代理为默认并维护直连例外的配置。选择前想清楚未知目标应该怎么处理,而不是因为某次测试失败就临时反转所有未列出请求的处理方式。

看到请求命中 FINAL,说明当前没有更早的条件接住它。先核对目标是否真的需要新增规则,再查目标字段、前缀和行序。不要先改掉全局兜底。

验证一份规则至少做三个对照动作:访问一个精确例外、访问一个只属于宽条件的目标、再访问一个两者都不属于的目标。若同时有地址或标识条件,还要确认第三个样本没有被其他规则提前接住。每次等待修改保存并生效后再发起新连接;仅刷新画面不一定能避免复用。浏览器缓存、应用长连接和原有页面请求都会使观察结果滞后。如果看到的还是上一轮记录,不能据此判定行序没有起作用。

当请求表现和记录不一致,不妨先用模式做一次短对照:直连可用而代理不可用,排查应优先转向已选服务器;两边都可用而配置模式出错,再聚焦命中行和该行的策略;两边都失败,则优先确认目标和当前网络。在涉及直连或代理的对照时,仅使用允许走两种路径的测试目标。对照表不替代规则记录,但能避免在错误的段落里反复调整。

[Host]:解析映射与分流的区别

[Host] 用于为指定主机名设置解析映射,不会把浏览器里的 URL 改成另一个域名,也不直接选择 PROXY 或 DIRECT。适合在受控环境中保留原主机名、改用已知测试地址,例如验证一台由自己管理的服务。若需求仅仅是让现有站点走另一条网络路径,改 [Rule] 即可,不应先改解析来迁就策略。

分别记录名称、地址与策略

[Host]
lab.example.com = 192.0.2.20

[Rule]
DOMAIN,lab.example.com,DIRECT
FINAL,DIRECT

映射行左边是主机名,右边是地址;这里使用文档保留地址,不会提供实际可访问的服务。规则行写的是访问该主机名时预期采用的策略,它不会创建映射。即使示例中两处写了同一个主机名,测试时仍要把结果拆成两个问题:是否由预期的地址接收,以及请求是否走了预期路径。对自己管理的测试服务,可用服务端收到请求的情况与客户端记录互相核对,仅看到页面打开还不能证明映射有效。

不要把原站点的完整地址放在等号左边,也不要在右边附带端口和路径。主机名解析与连接目标端口是两个不同的参数;实际端口仍由请求指定或由协议默认选定。如果原服务使用一个测试端口,应由发起请求的一方显式指定。主机名也不应随意扩大为整个域下的模式:只想验证一台服务时,写明确的主机名,避免改变同域下其他入口的解析预期。

缓存、解析路径和服务身份

静态映射能影响采用该映射的解析过程,但不是对所有应用、所有解析路径的强制修改。如果应用已有缓存、用的是地址直连或自行解析,或者解析实际由远端处理,就不应假定本地写了一行映射后所有请求都会使用新地址。测试先用明确需要验证的应用发起新请求,并确认记录的目的地址;不要只比较另一个应用或系统查询工具给出的答案,它们未必用了同一条解析路径。

给主机名指定新地址,也不会把该站点的身份校验转移给新地址。请求仍使用原主机名,受控测试服务器需要能够为该名称提供相应服务。如果出现证书不匹配、业务页面不对或服务端返回意外站点,先核对服务器对这个主机名和端口的配置。不要忽略证书警告来判断映射成功,也不要给不受自己管理的站点随意替换解析结果。验证期间用不含账号信息的测试请求,避免把真实会话送到错误目标。

当锁定的问题是解析错误时,不要同时加入 GEOIP 例外或修改默认策略。由于地址条件取决于实际目的地址,映射变化有可能间接改变它们的匹配结果。若需要把这一因素固定下来,可以在测试副本中保留明确的域名规则,再单独观察地址。确认映射正确以后,再决定是否恢复依赖地址的常规条件。这样既能验证新地址,也不会把代理与直连的差异混入解析检查。

映射行适合有明确维护期限的测试。测试完成后从活动配置中移除它,并用新连接核对解析已恢复。保留演练副本时,也要注明它仅对应测试环境。

移除后若仍然访问旧地址,先验证当前文件里没有第二条同名映射,以及是否仍使用上一次的连接。再重新在同一网络中发起请求并比较记录,而不是直接修改系统的所有解析设置。若活动文件来自会刷新的来源,核对该映射是本地加的还是原文件带来的;后者可能随配置更新重新出现。持久的更改应从正确来源修订,临时检查则应留在单独副本。

[URL Rewrite]:匹配地址与验证跳转

重写用于处理可以识别到的请求 URL。它适用于在自己管理的测试服务上验证旧路径到新路径的迁移,和分流规则解决的问题不同。DOMAIN 决定一个主机的请求走什么策略,不会把旧路径变成新路径;[Host] 能改变采用该映射时的解析地址,也不更改路径。遇到请求目标异常,应先分清改变的是去向、解析结果,还是客户端实际请求的 URL。

从精确的单条 HTTP 示例开始

[URL Rewrite]
^http://example\.com/old$ http://example.com/new 302

这一行依次写匹配表达式、目标 URL 和动作。开头的 ^ 和末尾的 $ 把条件限定为整个地址,\. 表示域名里实际出现的点,而不是任意字符。只有完整地址等于该旧路径的样本才符合这个表达式;带查询参数、尾部斜杠或不同协议的地址不在这个例子里。末尾的 302 描述临时重定向。跟随跳转的请求方会对目标地址发起后续请求;后续请求到达哪里,仍要分别检查地址与适用的规则。

示例地址只用来说明写法,不代表该网站提供这两个路径。验证时使用自己控制的测试主机和不带个人资料的只读请求。把 example.com 改为测试主机时,左边表达式的点仍应转义,右边作为字面目标 URL 则使用普通的点。若测试服务依赖显式端口,匹配式也要按真实输入考虑端口。不要先写能覆盖所有页面的表达式,再尝试用更多规则排除副作用;先证明一个路径按预期跳转,再扩大范围。

检查可见范围、查询参数和循环

这个例子刻意使用 HTTP。客户端看见一条 HTTPS 连接的主机信息,并不意味着它可以直接读到连接内部的路径或请求内容。不能因为能看见主机名,就假定把前缀改成 HTTPS 后完全等价。使用浏览器测试 HTTP 时,还要注意浏览器是否首先把输入升级为了 HTTPS;这会使实际请求不再符合示例。先从测试端记录的实际协议和 URL 查起,不要为了让测试命中而降低正常浏览时的安全设置。

查询参数是匹配边界的一部分。这个例子不会把带参数的旧地址一起接走,更不会为目标自动拼接参数。若业务确实需要处理参数,应分别明确哪些参数应该保留、哪些不应转发,并用没有凭据的测试值检查结果。登录和提交类请求不宜用本例推断行为:请求方跟随跳转时可能改变方法,业务端也可能依赖请求体。迁移验证从普通读取开始,有提交语义的路径要另作测试。

目标地址不应再符合本条条件,也不应被另一条重写送回原地址。核对时至少发起三次请求:旧地址应跳转,目标地址应正常完成,相似但不在条件内的路径应保持原样。如果浏览器提示多次跳转,逐次观察实际目标,区分来自配置的跳转和来自服务端的跳转。不要只看最终地址栏;有时错误的中间跳转被后续页面掩盖,却会影响资源请求或其他访问方式。

测试先关心第一次响应:是否发生了预期的临时跳转,目标地址是否正确。再看跟随后请求是否能到达;命中重写和目标可达是两个结论。

停用测试重写后,应主动发起新的请求并再次比较。缓存了结果的页面、服务端原有跳转和应用自己的地址升级行为都可能继续出现,看起来就像配置还在工作。若已确认当前文件没有该行,检查请求方是否复用了上一轮结果,或目标服务是否本来就提供相同跳转。记录时只保留测试域、路径和动作,不复制含身份信息的完整真实地址。

配置实例、验收顺序与回滚

下面以现有配置的一次小改动为例:一个检查主机应直连,同域其余服务使用已选的代理,已经确认的内部网段直接访问,未列出目标保持直连。模板的域名用于说明语法,请只换成允许测试的自有主机。需要代理能力时,前提是已经导入自己的订阅或服务器信息,并用现有连接做过一次可用性测试。

[Rule]
DOMAIN,health.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.40.0/24,DIRECT
FINAL,DIRECT

先写预期,再逐项验收

这段不能原样叠在旧文件的 FINAL 之后,也不必为了使用它重新创建一整个配置文件。如果已有 [Rule],就把需要的条件合并到该段,先查看更早的行是否已覆盖相关目标,再决定插入点。已有的默认策略只有在需求确实是改变未列出请求时才替换。若原配置默认直连,则内部网段行与目前的默认结果相同,写出它是为了表达意图;将来改默认策略时也要重新验证这条显式例外。

在测试笔记里为每项记录目标、预期命中行、预期策略和实际结果。检查主机验证第一行,同域另一主机验证后缀,选定的内部地址验证网段,再用不落在其他范围的目标验证默认。还要增加一个冲突样本:当同域请求最终指向该内部网段时,前面的域名后缀优先。如果实际要求内部地址无论域名如何都必须直连,原行序不满足该要求,应先明确地址条件的可用性,再调顺序并重做前两项。

结果应区分命中正确与连接成功。命中错误但页面能加载,不代表验收通过:同一目标可能在代理和直连下都能打开。反过来,命中正确却连不上,也不应立即更改规则。查看失败集中在哪类目标:若只影响代理目标,核对已有服务器的选择与连通性;若只影响内部目标,核对测试时所在网络与实际地址;若只影响页面的部分请求,比较资源使用的主机名和它自己的匹配记录。

从未生效、未命中到连接失败逐层排查

第一层是文件和模式:保存后重新核对活动配置与 Global Routing,确认测试请求是新发起的。若任何新规则都没有反映在记录里,先查是否选错文件或仍在对照模式。第二层是匹配字段:只有地址就按地址检查,有域名就核对真实主机名和行序,不要用网页标题推断。第三层才是执行:策略已正确命中时,检查直接访问或代理访问具体在哪里失败。需要核对界面位置时,可参照界面英文词对照。

如果在切换网络后才出现问题,先在同一配置、相同模式、相同服务器下只替换网络做对照。记录变化的是解析地址、命中规则还是访问结果。地址变化可能触发不同的地区或网段条件;相同规则和相同策略下的失败则更可能需要查网络路径。若启动客户端本身就遇到安装或获取问题,不要编辑配置来解决,先查看下载页的安装说明或商店与账号地区说明。

回滚时先切回保留的原配置,保持服务器和测试网络不变,再用同一请求重测。只有在原配置下不再复现,才有依据逐项比较这次配置修改。

回滚并不要求抹去观察结果。保留一份已脱敏的配置差异和几条最小复现记录,说明预期与实际的差别。如果原文件也表现相同,先暂停扩展规则,回到快速上手重查已有订阅、服务器选择与基础连接。若确认只有新文件才复现,下次只重新加入一组条件,并在通过验收后再加入第二组。这样能定位是哪条改动产生了行为变化,也便于配置来源更新后复查。