Shadowrocket 规则参考
从配置分段到首条命中,按问题查阅规则的条件、策略与生效边界。
本页是系统查阅手册,适合已经掌握连接操作、准备修改配置的用户。首次使用请先阅读入门指南,完成已有订阅导入与连接验证,再回来查阅规则。下文以你已有自己的订阅或服务器信息为前提;订阅链接从你的服务商处获取。
Shadowrocket 提供 iPhone / iPad、Mac、Windows、安卓与 Linux 版本。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;客户端一次性买断 ≠ 线路套餐。设备获取方式见下载指南,iPhone / iPad 系统要求以 App Store 页面标注为准。下文界面操作以 iPhone / iPad 为例,其他设备的入口位置与可用设置以当前应用实际显示为准。
配置文件结构
Shadowrocket 的规则配置通常以 .conf 文本保存,通过方括号标记不同功能段。理解分段比记住一整份配置更重要:连接参数解决如何到达服务器,规则解决某个请求采用什么策略,DNS 解决域名如何获得地址。它们会互相影响,却不是同一个设置。把订阅链接粘贴进规则段,或把一条域名规则写进 Host 段,都不能得到预期结果。
先区分三个对象
Home 中的服务器记录用于连接,订阅用于成组维护这些记录,Config 中的配置文件用于保存路由和相关行为。更新已有订阅并不等于更换当前配置;选择另一份配置也不一定改变当前服务器。排查时应分别记下订阅名称、当前服务器和启用的配置名称,避免把三个对象的变化误认为同一次操作。
在 Config 中打开目标配置,确认编辑的是本地副本还是远程配置。远程内容再次获取后,可能覆盖直接写入其中的修改。需要长期保留的实验,宜先复制为本地文件并另起可辨认的名称。保存后还要确认该文件处于选中状态;列表里存在一份配置,不代表它正在被使用。
| 配置段 | 主要职责 | 不能替代的内容 |
|---|---|---|
[General] | DNS 等整体行为参数 | 服务器认证信息与逐条分流 |
[Rule] | 匹配请求并指定策略 | 创建可用的代理服务器 |
[Host] | 指定域名的静态地址映射 | 决定连接使用 PROXY 还是 DIRECT |
[URL Rewrite] | 在可识别的请求上处理 URL | 通用网络路由与任意加密内容读取 |
从最小结构阅读
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY
这个片段只演示整体参数与规则段的关系。dns-server = system 表示使用系统 DNS;后面的规则依次处理示例域名、一个私有地址范围以及剩余请求。它没有 Host 或重写段,因为空段不是必需家具。配置越短,越容易把每个实际设置与它造成的现象对应起来,适合建立排查基线。
规则中的逗号是字段分隔符,应使用英文半角标点。类型名、匹配内容、策略按顺序排列,额外参数放在末尾;不要把中文解释直接接在策略后面。示例说明尽量另写一行注释,避免复制时混入不可见空格或全角逗号。域名字段不带协议头,不把完整网页地址当作域名填写。
保存不等于完成验证
编辑后先检查分段标题是否完整、规则是否仍位于正确段内,再保存并重新选中目标配置。若应用提示解析问题,优先回到刚改动的行检查字段数量,而不是继续添加其他规则。配置能够保存,只能说明编辑流程结束;实际路由是否符合预期,还需要新建请求并查看连接记录。
有些变化只影响新连接,已建立的长连接可能继续使用旧路径。验证前关闭测试页面并重新打开,必要时在合适时机重新连接 Shadowrocket。不要在正在进行的重要传输中连续切换配置。若回滚后现象没有立即改变,也先排除连接复用与应用缓存,再判断回滚失效。
完整配置可能包含比本文更多的段与设置。遇到不认识的项目,先保留原值并确认用途,不把从不同来源找到的整份文本直接拼接。重复分段、冲突参数与远程更新覆盖,往往比单条规则拼写更难定位。后文每一段示例都以局部替换或查阅为目的,不要求一次启用全部内容。
匹配顺序与姿态
规则排在什么位置,和规则写了什么同样重要。在配置姿态 Config 下,Rule 段通常按从上到下的次序检查,请求命中一条规则后便采用对应策略,不再继续寻找所谓更精确的下一条。Shadowrocket 不会自动把 DOMAIN 排在 DOMAIN-SUFFIX 前面,也不会因为某条规则看起来更具体而替你调整顺序。
先确认 Global Routing
Global Routing 的配置、代理、直连三种常用姿态,对应界面词 Config、Proxy、Direct。学习自定义规则时,应先确认当前选的是 Config。如果处于 Proxy 或 Direct,看到请求没有按 Rule 段分流,不能直接认定规则语法错误。姿态决定如何使用配置,具体流量还受系统路由范围与实际接管能力约束。
| 界面词 | 使用方式 | 适合的核查目的 |
|---|---|---|
| Config | 按当前配置处理路由 | 检查 Rule 顺序与策略命中 |
| Proxy | 以代理姿态处理被接管流量 | 短时对照代理路径是否可用 |
| Direct | 以直连姿态处理被接管流量 | 对照本地网络是否可达 |
三种姿态是诊断变量,不是性能等级。切到 Proxy 后页面能打开,只能说明改变路径后现象发生变化,还不能证明每个 DNS 设置都正确。切到 Direct 后打不开,也可能是本地网络本身无法到达目标。每轮对照结束后回到 Config,再验证要保留的规则,否则容易把临时姿态误当最终修复。
具体例外必须提前
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
访问 login.example.com 时,第一条已经命中,因此不会再进入第二条;访问 www.example.com 时,第一条不匹配,第二条生效。若交换前两行,后缀规则会先接住登录域名,原本的直连例外便没有机会执行。这是顺序问题,不需要通过重复添加同一域名来解决。
常见组织方式是把明确例外放前面,其后放范围较窄的业务规则,再放较宽的地址或地区条件,最后放 FINAL。这个排列是便于审查的习惯,不是固定法则。实际存在交叉时,应按目标结果决定优先级,例如同一域名既属于关键词范围,又有单独例外,就必须让例外先于关键词出现。
命中与连接成功分开看
规则命中只表示选出了策略。命中 PROXY 以后,仍可能因服务器不可达、认证失败或传输受限而失败;命中 DIRECT 后,也可能因目标端拒绝连接而失败。把“命中正确”与“访问成功”拆成两个结论,能避免用不断调整规则的方式处理本来属于服务器或目标网站的问题。
规则也不会因为前一个策略连接失败,就自动继续尝试下一条 Rule。后面的规则不是前面的容灾列表。需要连接切换时,应检查你实际配置的服务器选择或策略组行为,而不是在同一域名下面连续写多条不同策略并期待依次重试。本文的 PROXY 指向当前代理选择,不能解释成自动挑选最快线路。
On Demand 决定是否按条件建立连接,不替代 Rule 的逐请求匹配;Scene 的具体设置也不应与上述三姿态混为一谈。若网络变化后连接状态和预期不同,先核查自动连接条件,再检查流量分流。对首条命中的更多交叉例子,可阅读自定义规则与优先级说明。
域名与请求条件
域名规则适合表达“哪个服务使用哪种策略”,通常比直接追随网站的地址变化更容易维护。先确认手里的是主机名、完整 URL 还是应用显示的名称,再选择规则类型。网页标题、应用名称与真正建立连接的主机名并不相同;把屏幕上看到的中文名称填进 DOMAIN,不会自动找到对应网络服务。
DOMAIN 与后缀边界
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT
DOMAIN 用于精确域名匹配。第一条针对 api.example.com,不同时覆盖 www.example.com 或更深层级的主机名。填写时只写主机名,不加 https://、端口或路径。若需求只针对某一个明确接口,精确规则的影响范围更容易预测,也便于发现后续域名变化。
DOMAIN-SUFFIX 匹配指定域名及其子域名。第二条可以覆盖 example.org 与 img.example.org,但不是随意的字符串结尾搜索,不应把 notexample.org 当作它的正常匹配目标。也不需要在前面添加星号;*.example.org 不是本文这种后缀写法。
使用后缀前要想清楚归属边界。把公共托管平台的宽泛后缀整体指定为一种策略,可能同时影响大量互不相关的站点。能以具体业务域名表达时,就不要把范围扩大到公共后缀。反过来,若服务明确使用多个子域名,只写一个主页 DOMAIN 也可能覆盖不足,表现为主页正常而图片或登录失败。
关键词不是服务识别
DOMAIN-KEYWORD 按域名中出现的关键词匹配,覆盖面往往比后缀更宽。示例中的 example 可能命中多个不同域名,不能据此判断它们属于同一服务商。关键词适合已知、可审查的命名规律,不适合把常见短词当成可靠分类器。出现误伤时,先改成精确条件,而不是堆叠大量补救例外。
例如把 ads 指向 REJECT,只能演示关键词拒绝语法,不能保证只匹配广告请求;正常域名也可能恰好包含这几个字母。应先查看真实连接中的域名,再决定是否拒绝。一个页面能打开,并不表示它的登录、媒体和提交接口都没有被误伤,验证时需要覆盖实际使用动作。
USER-AGENT 的可见性
[Rule]
USER-AGENT,ExampleClient*,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
USER-AGENT 根据可识别请求中的 User-Agent 内容匹配,示例里的星号表示通配范围。它不是进程名识别,也不等同于“某个应用的全部流量”。同一应用可以使用不同请求库和不同标识,多个应用也可能共享相似标识,因此不能只凭一条 USER-AGENT 就断言实现了完整的应用级分流。
HTTPS 会加密请求头,普通隧道转发无法随意读取其中的 User-Agent。此类规则能否匹配,取决于应用实际取得的信息及相关处理条件。不要为了让一条规则生效,就把额外的证书信任或解密设置当成必需步骤;本页不要求开启这些能力,常见分流优先使用可验证的域名条件。
当域名规则看似漏匹配时,先核对连接实际使用的目标。页面跳转、内容分发、独立认证域名和直接访问 IP,都可能让原先的假设失效。若客户端没有可用域名信息,DOMAIN 类规则也不能凭空推导。应根据记录补足确有需要的条件,而不是把任何失败都归因于后缀规则“不够强”。
维护时建议为每个业务保留一小组有依据的规则,并把特殊例外写在组前。服务变更后,删除已经无用途的旧域名,避免配置长期积累难以解释的条件。域名数量越多并不代表覆盖越准确;每条规则都能说明为什么存在、应该命中什么,才是稳定配置的基础。
IP 与地区匹配
当目标以 IP 建立连接,或需要明确处理局域网地址时,IP 规则更直接。它关注最终目标地址,而不是域名的拼写。使用前应分清单个地址、子网范围与地区数据库:一个网站可能解析到多个地址,一个地址也可能承载多个域名;按 IP 分流带来的影响范围,未必与某个网站的业务边界相同。
IP-CIDR 的范围
[Rule]
IP-CIDR,192.168.50.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
FINAL,PROXY
IP-CIDR 处理 IPv4 网段。斜杠后的数字是前缀长度,不是端口,也不是地址数量。/32 指向单个 IPv4 地址,/16 表示前十六位固定的范围。写规则时要使用你实际需要的网络边界,不要为了某台设备直连就随意扩大到远超实际局域网的地址空间。
示例前三类大范围属于常见私有地址范围,可作为理解局域网直连的材料,但不能保证当前网络一定可达。公司内网、访客网络与家庭路由器可能存在隔离,路由表也可能不同。命中 DIRECT 只能决定由本地网络尝试连接,不会创建访问权限,更不会自动打通被网络设备隔开的两个子网。
no-resolve 的含义
no-resolve 的重点是不为匹配该条 IP 规则而主动触发域名解析,不是关闭所有 DNS,也不是保证这条规则永远看不到解析后的地址。目标本来就是 IP,或处理流程已经拥有目标地址时,仍可按相应地址判断。它适合减少仅为检查某些网段而引入的额外解析,但效果要结合实际请求路径理解。
假设请求最初只有域名,前面的域名规则已经命中,就没有必要依靠后面的 IP 规则再决定策略。若域名规则未命中,而后面的地址规则都带 no-resolve,不能简单假设客户端必然会先解析并匹配某个网段。写作与排查时应区分“已有地址可供判断”和“需要为匹配而解析”这两种情况。
IPv6 与 GEOIP
[Rule]
IP-CIDR6,fd00::/8,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
IP-CIDR6 对 IPv6 地址使用同样的前缀思路。示例只选取唯一局部地址空间中的一部分来说明语法,不是所有 IPv6 本地地址的完整列表。若目标同时有 A 与 AAAA 记录,仅写 IPv4 范围不足以表达完整意图;验证时要确认实际连接使用哪个地址族,而不是只看域名相同。
GEOIP 根据目标 IP 的地区数据库判断,示例中的 CN 是地区代码,不代表中文网页、中文域名或某个账号地区。内容分发和跨地区部署会使同一域名在不同网络解析到不同地区的地址,数据库本身也存在更新与归类边界。因此 GEOIP 更适合作为较宽的归类条件,不适合代替明确的业务例外。
对必须固定策略的服务,先写域名或精确地址例外,再让 GEOIP 处理其余范围。反过来把宽泛地区规则放在前面,可能使后面的业务规则没有机会执行。若希望 GEOIP 不主动触发解析,也应理解相应 no-resolve 行为可能改变哪些请求有地址可供判断,不能只复制参数却不检查结果。
地址排查应同时记录目标域名、实际目标 IP、地址族和命中规则。不要把终端里随手查到的一个 IP 当作应用连接的唯一目标,因为缓存、网络 DNS 和内容分发调度都可能产生差异。遇到“同域名偶尔走另一策略”,先看这四项是否一致,再调整网段,通常比不断扩展地区规则更有效。
策略与 FINAL
规则左侧说明“匹配什么”,右侧策略说明“匹配以后怎么处理”。PROXY、DIRECT 与 REJECT 是三种不同动作,不是服务器协议名,也不是连接质量评级。只有同时写对条件和策略,规则才表达了完整意图。审查配置时可以把每一行读成一句话:当目标满足这个条件,就按指定方式处理。
PROXY 与 DIRECT
PROXY 表示使用代理策略,具体出口与当前代理选择或配置中的实际关联有关。它不会从订阅里凭空挑选一条可用服务器,也不保证目标服务接受该出口。规则命中 PROXY 后还要确认当前服务器、协议参数和可达性;若服务器信息已失效,增加更多 PROXY 规则不会修复认证问题。
DIRECT 表示由本地网络直接访问目标,不经过所选代理服务器。它不等于停用 Shadowrocket,也不保证请求完全绕过所有系统网络机制;在客户端接管范围内,DNS 与其他配置仍可能影响访问。直连适合明确需要本地可达性的目标,但不能把“直连”理解为任何地点、任何网络都可达。
| 策略 | 动作 | 应核查的下一层 |
|---|---|---|
PROXY | 交给代理路径 | 当前服务器、认证与目标端响应 |
DIRECT | 交给本地网络路径 | 本地路由、网络权限与目标可达性 |
REJECT | 拒绝匹配请求 | 是否误伤必要接口或关联域名 |
REJECT 要限定范围
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
这里先拒绝一个精确域名,再保留登录域名的直连例外,然后让其他示例子域名走代理。REJECT 一旦命中,该请求不会自动退回 DIRECT。若应用出现重复重试、某块内容空白或提交按钮无响应,应检查是否拒绝了它依赖的接口,而不是只检查主页能否加载。
拒绝规则尤其需要可解释性。对于用途不明确的域名,先观察实际请求和功能关联,不应因为名称陌生就立即拒绝。某些统计、认证与配置请求共用基础域名,过宽的后缀或关键词可能影响必要功能。排查误伤时,临时停用单条规则并重复同一操作,比同时删除整组规则更容易确认因果。
FINAL 表达默认意图
FINAL 不需要域名或网段字段,常见写法是 FINAL,PROXY 或 FINAL,DIRECT。它决定前面条件均未命中时如何处理,因此是整份配置的默认策略。选择哪一个取决于你的使用目的与网络条件,不存在对所有设备都正确的固定答案。修改前应考虑未知域名、后台请求和新服务会落到哪里。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
这个片段是“明确列出的域名使用代理,其余直连”的模式。若改为 FINAL,PROXY,则变成其余请求默认代理,必须单独提前列出需要直连的例外。两种模式都能工作,但维护重点不同:前者关注遗漏的代理范围,后者关注遗漏的直连范围,不能混用两套直觉来解释同一份配置。
不建议把 FINAL 写成 REJECT 后直接投入日常使用,除非你明确准备维护允许范围并逐项验证。兜底拒绝会让没有显式覆盖的新域名失败,页面新增一个接口就可能产生新问题。学习阶段先用容易观察的默认策略,建立稳定基线,再按明确目的收紧条件。
如果配置引用了自定义策略名称,应确认名称确实存在且拼写一致;本文只用内置策略来避免这一层歧义。不要把服务商的服务器显示名称直接当作通用内置关键字。最终验收要回答三个问题:匹配条件是否正确、动作是否符合意图、动作执行后链路是否可用,三者缺一都不能算验证完成。
General 与 DNS
General 用于描述整体网络行为,其中 DNS 往往是“规则看起来正确但网页打不开”的关键变量。DNS 先把域名转换为地址,路由规则再按可用信息选择策略;实际实现中两者可能相互影响,但概念上应分开排查。代理服务器延迟正常,只说明测试所覆盖的连接环节可用,不代表目标域名解析和页面资源请求都已成功。
建立可对照的解析基线
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
dns-server = system 是使用系统 DNS 的示例,不是适用于所有网络的性能建议。若你已有明确的 DNS 配置,应先备份原值再做对照。不要把网上找到的一长串解析服务器直接加入配置并期待数量越多越可靠;不同解析结果、网络可达性与故障等待,都可能使问题更难解释。
使用自定义 DNS 时,先确认地址格式与当前应用支持的写法一致,再确认本地网络或相应请求路径能够到达它。DNS 服务可达、返回结果可用、后续目标可达是三个检查点。即使查询成功,返回的地址也可能不适合当前访问路径;即使代理可用,DNS 请求本身也未必按你想象的方式经过代理。
识别三个不同失败点
第一类是没有获得地址,常表现为解析超时或域名相关错误;第二类是已经获得地址,但连接该地址超时;第三类是连接已建立,目标返回证书或应用层错误。三者的修复方向不同。仅凭浏览器的一句“无法打开页面”不能区分,应结合 Shadowrocket 可用的连接记录和同一时间的测试结果判断。
若同一域名在两个网络得到不同 IP,不必立即判定某一结果错误。内容分发会根据网络位置和解析路径调度地址。正确的问题是:当前结果是否能在所选策略下访问,是否属于预期服务。切换网络后应重新建立测试请求,并考虑缓存仍在保留旧地址的可能,不要把所有差异归因于规则顺序。
IPv6 也是必要的对照维度。域名同时返回 IPv4 与 IPv6 时,系统可能优先尝试其中一种,实际选择还受网络状态影响。如果你只检查了 IPv4 规则,却由 IPv6 地址建立连接,观察到的策略就可能不同。先查实际地址族,再决定补充规则;不要把关闭某种地址族当作所有 DNS 问题的默认答案。
整体参数不宜混改
General 中还可能出现绕过范围、地址族与其他整体行为设置。它们与 Rule 的作用层次不完全相同:如果某类流量没有进入预期的接管路径,后面再精细的域名规则也无法解释它。看到配置中有 skip-proxy 等参数时,应先确认其用途和当前值,不把它当作普通 DOMAIN 例外随意替换。
修改整体参数应比添加精确规则更谨慎。一次同时改 DNS、地址族、绕过范围和 FINAL,即使问题暂时消失,也无法知道哪一项起效,更难发现副作用。可先固定服务器和 Rule,只更换一个 DNS 设置;恢复后再固定 DNS,调整目标规则。每次记录改变项、测试对象和结果,形成可重复的对照。
遇到“部分网页打不开”时,先挑一个固定目标,记录错误阶段,而不是连续切换多个网站。若只在某个应用失败,再对比浏览器是否使用同一个域名与地址族。更具体的检查顺序见DNS 解析失败排查;本章提供概念边界,文章用于按现象逐步定位。
Host 与 URL Rewrite
Host 与 URL Rewrite 都会影响访问过程,但它们不属于普通 Rule 的替代写法。Host 回答指定域名使用什么地址,URL Rewrite 回答在请求信息可用时如何处理 URL,而 Rule 回答流量采用什么策略。把三层职责分开,能避免“改了域名映射就应该自动代理”或“写了重定向就能够修复所有连接”的误解。
Host 是地址映射
[Host]
test.example.com = 192.0.2.10
[Rule]
DOMAIN,test.example.com,DIRECT
FINAL,PROXY
这里将 test.example.com 映射到 192.0.2.10,并另外用 Rule 明确该域名的策略。这个地址属于文档示例范围,不提供实际服务,不能拿它验证页面可达性。真实使用时应填入你有权使用、且已经确认适用于该域名的目标地址,并为临时映射记录添加原因与撤销条件。
静态映射绕开了正常 DNS 更新带来的地址变化,也因此失去自动跟随调度的能力。服务迁移或内容分发切换以后,旧地址可能不再有效。若某个域名在其他设备正常、仅当前配置异常,应检查是否留有旧 Host 记录,而不是立刻增加新的 DNS 服务器。临时映射验证完就应决定保留还是移除。
HTTPS 的证书校验仍然以访问的域名为重要依据。把域名映射到任意可达 IP,不会让对方服务器自动具备正确证书或对应站点。出现证书错误时,不应通过忽略校验来掩盖地址不匹配;应检查映射地址是否真正承载目标服务,必要时撤销映射,回到正常解析路径进行对照。
URL Rewrite 的字段
[URL Rewrite]
^http://old\.example\.com/(.*)$ http://new.example.com/$1 302
这是一条 HTTP 重定向示例:开头是正则匹配式,中间是目标 URL,末尾是重定向状态码。^ 限定从字符串开头匹配,域名中的点用反斜杠转义,(.*) 捕获后面的内容,目标中的 $1 引用这一组。示例只用于展示语法,不代表这两个示例主机存在可用网页。
正则表达式应尽量限定协议、主机与必要路径。域名里的点若不转义,会被当作匹配任意字符的元字符;缺少开头约束,也可能扩大匹配范围。修改前先列出一条应该命中的 URL 和一条不应该命中的 URL,再检查表达式是否能区分它们。仅测试一个正例,容易漏掉范围过宽的问题。
重定向会让客户端继续请求新地址,因此还需要考虑循环。目标若再次匹配原表达式,或另一条规则把它转回旧地址,访问可能反复跳转。新域名也仍需正常解析,并受到对应 Rule 的策略处理。重写成功不等于新目标可达,应分别检查原请求是否被处理、新请求是否发出以及后续路由结果。
加密边界与敏感参数
普通 HTTPS 转发看不到完整的加密请求路径与请求头,不能因为写了一个正则就假设可以任意重写。本文示例选择 HTTP,避免把证书信任、解密条件与基础规则混在一起。若没有明确需求和完整理解,不应为了尝试一个重写片段而额外改变设备的信任设置,基础域名分流也不依赖此操作。
URL 可能包含登录状态或其他敏感查询参数。示例中的 (.*) 会把匹配范围内的内容带到新目标,实际使用前应审查是否会转发不该跨域传递的参数。不要把真实业务 URL、认证链接或私密配置粘贴到公开讨论中;排查可用示例域名说明结构,保留字段形式而移除敏感值。
若同时配置 Host 与重写,建议按层验证:先停用重写,确认原域名的地址与路由;再启用重写,观察目标是否改变;最后核查新目标的解析和策略。每次只恢复一层,能区分静态地址过期、正则不匹配、目标路由错误这几类问题,也避免用更复杂的重写掩盖一个简单的 DNS 故障。
验证、排错与维护
规则维护的目标不是让配置越来越长,而是让每个重要请求都能解释为什么采用当前策略。可靠流程应包含备份、单项修改、正反例测试与回滚。先保留一份已经能够正常连接的配置,再建立测试副本;如果基础连接本身不稳定,应先处理服务器或网络问题,不要在同一轮同时重建所有规则。
按固定顺序验证
- 确认 Home 中当前服务器可用,Global Routing 处于 Config,Config 中选中了要测试的文件。
- 只添加或修改一条规则,保存后重新建立目标请求,避免旧连接继续沿用原路径。
- 检查目标域名、实际 IP、地址族、命中规则与最终策略,再记录访问结果。
- 测试一个不应受影响的目标,确认新增条件没有扩大到预期范围之外。
- 结果符合预期后保留修改;否则回滚这一项,恢复基线后再换下一个假设。
正例应能明确命中新增规则,反例应与正例尽量相近但不满足条件。例如测试后缀规则时,可以分别选同一后缀下的主机和一个不同域名;测试精确域名时,再检查另一个子域名。这样的对照能发现“因为更早的宽泛规则已经命中,所以新增规则其实没起作用”的假成功。
用最小片段隔离冲突
[Rule]
DOMAIN,api.example.com,PROXY
FINAL,DIRECT
如果长配置难以判断,可在副本中暂时保留一个精确条件和兜底策略。先确认最小片段符合意图,再按组恢复其他规则。恢复到某一组后结果改变,就检查这一组是否提前覆盖目标。不要在原文件里大范围删除又凭记忆重建;测试副本与明确备份能够让每次恢复都有可靠起点。
| 观察到的现象 | 优先检查 | 不宜直接得出的结论 |
|---|---|---|
| 所有请求似乎同一策略 | Global Routing、当前配置、提前命中的规则 | 所有域名规则都不受支持 |
| 命中正确但访问失败 | DNS、当前服务器、目标端响应 | 继续添加相同规则即可修复 |
| 仅部分页面功能异常 | 关联域名、REJECT、重写与缓存 | 主页可开就说明整站正常 |
| 更新后修改消失 | 远程配置覆盖、本地副本与选中状态 | 订阅更新一定修改了全部配置 |
区分两种更新
订阅更新主要用于维护服务商提供的服务器记录,远程配置更新则可能替换规则文本,两者不能混为一谈。更新前记下正在使用的对象与名称,更新后分别检查服务器列表和配置内容。若只需学习服务器记录的刷新方式,参阅订阅更新教程,不要通过反复导入整份配置来代替正常刷新。
长期维护时,为每组规则写一句用途说明,比记录一个含糊的“修复”更有价值。说明应包括影响对象、预期策略与保留原因,不写真实凭据。网络环境或服务域名变化后,先验证规则是否仍有必要;删除失效条件能减少交叉关系,也让后来排查的人更容易找到真正相关的行。
分享排错材料时,保留规则类型、相对顺序和错误阶段即可;服务器认证、私密订阅地址与个人网络信息应先移除。订阅链接从你的服务商处获取,遇到认证或服务端参数问题也应回到已有服务商信息核对。本手册解释客户端配置,不把未知来源的服务器信息作为修复前提。
最后做一次完整验收:检查网页加载、登录、媒体或文件传输等实际动作,再确认切换网络后是否仍符合意图。若仅做过一次延迟测试,应把结论限定为该测试可用,不应写成全部配置正常。回到快速操作主线可阅读入门指南;获取方式与常见获取问题见全平台下载说明。稳定的配置应当可以复现、可以解释,也能够明确回滚。