01 / FILE STRUCTURE
配置文件结构与生效范围
配置文件决定客户端怎样处理请求,服务器资料决定某条代理连接连往哪里。两者可以分别变更:在 Home 换用已有服务器,不等于换了 Config 中使用的规则文件;保存另一份规则文件,也不会替换服务器的认证信息。开始编辑前先确认两件事:当前连接实际使用哪个服务器,以及 Global Routing 处于 Config 时实际使用哪份文件。不要仅凭文件列表里有一个熟悉的名称,就认定该文件正在生效。
用段名区分四类配置
| 配置段 | 负责什么 | 什么时候查 |
|---|---|---|
[General] | 公共参数,例如解析器设置 | 同一问题影响多个无关域名时 |
[Rule] | 按条件为请求选择策略 | 某个目标走了错误的路径时 |
[Host] | 为特定主机名指定地址或解析方式 | 少数主机名返回了非预期地址时 |
[URL Rewrite] | 按可见的 URL 匹配并执行改写 | 访问旧地址却跳到了其他位置时 |
方括号内的名称是段的边界。写入某一行之前,先向上找到最近的段名,而不是只看附近文字。以 DOMAIN 开头的行应放进 [Rule],用等号把主机名映射到地址的行则应放进 [Host]。例如,把规则粘到文件末尾时,若末尾仍处在 [Host] 段下,该行就不会因为拼写正确而成为规则。已有同名段时,把条目加进原来的段,不要靠在末尾再写一个同名段来覆盖前文。
读懂最小配置骨架
[General]
dns-server = system
[Rule]
DOMAIN,assets.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
这份骨架只展示解析参数与规则的写法,不要求每份文件都有四个段。公共参数写成键和值,规则则用半角逗号分隔类型、匹配值和策略。例子里的资产主机先走 DIRECT,同一域名下其余匹配请求走 PROXY,未命中者回到 DIRECT。这是读法示例,不是适合所有网络的默认配置。尤其不要用它覆盖现有文件,否则原有的本地访问例外、服务分组和兜底行为可能同时改变。
编辑时以正在使用的文件为底稿,先留一份可读、可重新选用的副本,再一次只改一个位置。复制网页里的代码之后,检查方括号、等号和逗号是否仍为半角字符。地址栏里的完整网址不能原样填进域名规则,规则行结尾也不要加解释性文字。若配置由已有的远程来源维护,先确认更新是否会替换本地编辑;用独立副本试验,可以把远程变动与手工变动分开判断。
确定要改的是配置还是连接资料
如果已有订阅的服务器条目为空、认证失败,或者换用其他规则后依然连不上同一服务器,先查服务器资料和基础连接。不要在 [Rule] 写入订阅链接,也不要为了让一条代理规则生效而在 [Host] 填入服务器的地址。反过来,若连接可用、同一服务器能访问其他目标,只是某个域名使用了意外策略,再从所在配置段和规则顺序查起。客户端一次性买断 ≠ 线路套餐;本文以用户已有自己的订阅或服务器信息为前提,不提供、不销售、不推荐节点或订阅。
保存后回到 Config 核对生效文件,再回到 Global Routing 核对所选姿态。若界面显示同名文件,先用区分明确的副本名称,避免把两次测试记在同一个名字下面。交接时应说明改的是哪个段、希望哪些目标改变、哪些目标保持原状。仅说“换了配置后能打开”不足以判断修改有效:恢复也可能来自网络切换或旧连接恰好结束。
先记录旧文件和旧设置,再验证新文件是否生效。配置文件的保存、选择和实际使用是三个需要分别确认的状态。
若只想对照文件写法,可进一步查看配置文件各段说明。核对配置时,优先使用脱敏过的单段摘录。包含服务器凭据、远程配置地址、订阅参数或真实内部主机名的原文件,应留在自己的设备上,不要用公开的文本比对服务处理。
02 / GENERAL
General:公共参数与 DNS 设置
当多个本来无关的域名同时出现解析失败时,先检查 [General] 和当前网络,不要急着添加多条代理规则。域名解析的结果是地址,规则的结果是策略,两者不是同一个判断。得到一个地址并不证明该地址能够建立连接;看到代理策略被选中,也不证明目标主机已被正确解析。只有把解析、策略和实际连接分别核对,才能判断哪一层需要修改。
从 dns-server 核对解析基线
[General]
dns-server = system
示例中的 system 表示沿用系统提供的解析器,便于比较在当前网络中系统原有的解析行为。它不是某个固定的公共解析服务。设备在家庭网络、公司网络和蜂窝网络之间切换后,系统提供的解析器以及能解析的名称都可能不同。若某个内部域名在公司网络能解析,在其他网络不能解析,先确认该名称原本是否只对内部解析器可见,不要把这种差异直接归因于规则。
编辑已有文件时,找到实际存在的 dns-server 行,记录原值,再在副本中替换。不要添加两个同名键来做对照,也不要同时改解析器、地址族设置和兜底策略。先测一个平时稳定的普通域名,再测一个出现问题的域名;使用相同网络和相同服务器做比较。如果参考测试也失败,先查环境或公共设置。只有问题域名失败时,还应检查对应的 [Host] 项、它的解析结果以及是否存在特定的域名规则。
区分没有结果、结果不同和连接失败
没有结果时,先核对输入的名称是否完整、解析服务是否能通过当前网络到达,以及网络登录步骤是否已经完成。返回结果不同不一定是故障:同一网站可能按位置、运营商或访问时段返回不同地址。正常的比较方式是记录测试所用网络、目标名和地址族,并用同一目标重测,而不是拿另一台设备在另一条连接上的结果当作固定答案。如果名称能解析,但随后出现超时或证书错误,就该转到目标连接或服务名称检查,不宜继续轮换解析设置。
IPv4 和 IPv6 的结果也要分开看。网站可能同时发布两种地址,而终端不一定总用同一种建立连接。如果一个 IPv4 地址访问正常,但用域名访问有时失败,先观察失败连接实际使用哪种地址。仅凭看到一个 IPv6 结果,不足以断定 IPv6 是故障来源;还需要比较同一目标是否确实经由该地址失败,以及当前网络对此地址族是否可达。若不得不暂时改地址族相关设置排查,应保存原值,验证后恢复并定位长期原因。
处理解析和分流之间的交叉情况
有些问题看上去像 DNS 设置不当,实际上是地址规则需要一个地址才能判断。域名规则可以在有主机名时直接匹配;写得很靠前的地址规则则可能使客户端先为主机名取得地址,再判断网段。要保护一个按域名定义的明确例外,先检查具体域名规则是否放在这些地址类规则之前,并留意地址规则是否带 no-resolve。不要为了让某条地址规则命中而把共享解析参数改成对所有请求都不合适的值。
同样,修改解析器后看不到立即改变,也不必重复编辑文件。旧 DNS 结果和已建立连接有各自的生命周期。先结束正在测试的会话,再发起新请求;必要时重新建立客户端连接,并重新比较当前结果。若只是旧页面从缓存中加载出来,本次请求甚至没有走到预期的网络步骤。用一次明确发出的新请求作验证,比反复刷新页面更容易判断结果。
解析器的设置是解决特定解析问题的工具,不是加快所有访问或替代线路的通用方法。结束测试时,留下足以解释结果的记录:采用了哪份配置、解析器是系统提供还是手工指定、失败发生在哪种网络、目标是没有地址还是有地址但连不上。这样即使下一次遇到相似现象,也能先复核同一层,而不用重做所有改动。
目标名称解析失败,先查解析;名称有地址但访问失败,再查该地址的策略、连接路径和目标服务。不要把“能解析”当成“能访问”。
03 / DOMAIN MATCH
域名规则:精确、后缀与关键字
当目标可用稳定的主机名描述时,优先选范围最小、最容易说明的规则。一个登录主机的例外用 DOMAIN;同一域名以及它的子域确实要采用同一策略时用 DOMAIN-SUFFIX;只有在能够接受跨域误匹配、且找不到明确名单时,才考虑 DOMAIN-KEYWORD。选择类型之前先找出请求的真实主机名,而不是根据页面标题、服务名称或浏览器里显示的简称猜测。
从完整网址提取规则字段
以 https://assets.example.com:443/manual/index.html 为例,用于域名规则的值是 assets.example.com。开头的协议、后面的端口、路径乃至查询参数都不属于主机名。只希望一个目录生效的需求,无法靠添加一条域名规则实现;主机名相同的其他目录也会受到相同域名策略影响。同样,后缀规则的匹配值直接写 example.com,不需要写成以星号开头的形式,也不需要附加路径。
| 类型 | 匹配值 | 命中示例 | 不命中示例 |
|---|---|---|---|
DOMAIN | assets.example.com | assets.example.com | img.assets.example.com |
DOMAIN-SUFFIX | example.com | example.com、img.example.com | notexample.com |
DOMAIN-KEYWORD | example | assets.example.com | assets.test.invalid |
后缀匹配以域名分级为边界,裸域和它之下的子域可共同命中,但仅仅以相同字母结尾的另一个域名不应因此命中。关键字匹配则看主机名是否包含该片段;例如 notexample.com 虽不属于 example.com,仍包含 example。这就是为什么短关键字在排查时容易让原本无关的服务跟着改变。用关键字之前,应先列出一个需要命中的目标和一个名称相近但必须保持原状的对照目标。
先写例外,再写归类
[Rule]
DOMAIN,assets.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
这个片段先处理精确主机,然后覆盖其余同后缀目标。对 assets.example.com 来说,两条域名条件都可以成立;放在前面的精确规则已经决定策略,后面的后缀规则就不会再次处理。将两行互换之后,即使精确规则本身没有写错,也达不到例外的目的。若文件中存在由维护者提供的宽泛规则,新增例外前要从文件顶部检查,而不只是把新行放在 FINAL 上方。
不能用一条后缀规则代表整个应用。一个页面可能分别请求主站、登录接口、静态资源和媒体服务,后面几项还可能使用完全不同的主机名。当主页能打开但登录或图片异常时,应找出失败的那一个请求,然后判断该目标该不该与主站采用同一策略。必要时为实际目标加精确条目。不要只因为几个主机在同一页面出现,就扩大到它们共同包含的单词或一级后缀。
域名不可见时,避免扩大规则范围
用户直接输入地址、应用复用既有连接,或者当前连接的主机名未被客户端识别时,可能看不到预期的域名。此时把 DOMAIN 改成更宽的关键字也不能补出主机名。先重新发起连接并确认该请求是按名称还是按地址建立;若业务确实以固定网段为访问目标,转去检查地址规则。不要因为一个域名偶然解析到某个共享地址,就把该地址永久视为这个域名。
维护一组域名规则时,应把“什么时候可以删”与“为什么要加”一并记下。临时排障例外在定位后就应撤回;长期例外则需要定期检查主机名是否仍由相同服务使用。验证结果至少应包括目标主机、同后缀的另一主机和后缀以外的常用对照主机。若三者都改变了,先查有没有改动宽规则或兜底,而不是继续补更多例外。
域名规则只负责主机名,不负责路径,也不代表一个应用的全部网络请求。先找准确的请求目标,再决定匹配范围。
04 / ADDRESS & REQUEST
GEOIP、IP-CIDR 与 USER-AGENT
用地址类规则之前,先明确要匹配的是目标地址,而不是设备发出请求时使用的本地地址。IP-CIDR 面向 IPv4 网段,IP-CIDR6 面向 IPv6 网段;GEOIP 则依赖地理地址库,对目标地址作区域归类。三者都不能代替精确的域名识别。相反,USER-AGENT 比较的是可见的请求标识,也不应被当成可靠的应用身份。
用前缀长度限定地址范围
[Rule]
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
IP-CIDR,192.0.2.0/24,PROXY,no-resolve
IP-CIDR6,2001:db8::/32,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
前两行是 IPv4 的范围对照:/32 只指定一个地址,/24 则覆盖同一前三段下的一组地址,因此单个地址的例外要写在网段前。第三行是 IPv6 的前缀示例,不能放进 IPv4 规则;若只限定一个 IPv6 地址,使用 /128。示例网段为文档用途,只用于说明语法与覆盖关系,不能拿来验证实际服务。写自己的网段时,先确认管理范围,再把网络地址和前缀一并写入。
no-resolve 放在地址规则末尾,表示不要仅为了检查这条规则而主动解析域名。目标本身是地址,或者匹配过程已有可用地址时,仍可比较。它不是全局禁用 DNS,也不能让后续的 GEOIP 自动采用同样的处理方式。如果目标仍只有主机名,带此参数的地址条件可能无法判断;接下来仍会按后续规则处理。用域名和用地址访问同一服务得出不同策略,并不必然意味着规则出错。
把地理归类当作宽范围条件
GEOIP,CN,DIRECT 表示把地理地址库归入 CN 的目标地址交给 DIRECT,不是匹配中文网站、账号地区、设备所在地或者某类域名后缀。使用内容分发服务的域名可能返回不同区域的地址;同一目标在不同网络下也可能得到不同结果。需要对某个稳定域名给出固定策略时,把域名规则写在地域归类前,不要为了纠正一个目标而调整整个区域的默认走向。
在排查地域规则时,记录的是失败连接真正使用的地址,而不只是手工查询取得的一项结果。如果返回多个地址,本次连接不一定使用列表里的第一个。目标跨多个地址段时,也不要用所有观察到的地址拼出一个越来越宽的网段,那样可能把共享同段的其他站点一并纳入。只有目标确实由自己管理、地址段相对稳定,才适合用网段作为长期识别条件。
请求标识规则的可见性限制
[Rule]
USER-AGENT,ExampleClient*,DIRECT
FINAL,PROXY
上面的虚构标识用于演示写法:在客户端能够读取相应请求标识时,以 ExampleClient 开头的值可以匹配该条目。对通常的加密连接,客户端在仅能看到连接目标时,未必能读取其中的 HTTP 请求头;有些请求本身也不包含可用的标识。即便标识可见,它也可能随应用更新或请求组件变化,或者与其他应用相同。若需要稳定地识别目标服务,优先用明确的域名,不要为了让这条规则成立而改变加密信任设置。
比较地址类规则和标识规则时,先问当前请求提供什么信息,再问字段写得是否精确。如果一个条件没有可比的值,即使语法正确,也无法指望它命中。把域名例外、地址范围和请求标识按可验证的场景分开测试,记录哪个条件先成立。遇到偶发结果时,抓住一项可重复的差别,比如显式输入地址时稳定命中,而按名称访问时不命中,再决定要不要调整条件或顺序。
网段不是域名的替身,地理归类不是网站身份,请求标识也不是应用身份。规则条件越宽,越需要准备不应命中的对照目标。
05 / POLICY & ORDER
策略、Global Routing 与匹配顺序
判断规则是否生效,第一步不是数规则,而是核对 Global Routing。配置、代理、直连三种姿态在界面上分别显示为 Config、Proxy、Direct。要测试当前规则文件里的域名例外、地址条件和兜底,应使用 Config。在另外两种姿态下看到访问结果变化,可以作为线路诊断线索,但不能据此说某一行 [Rule] 写对了或写错了。
| 姿态 | 界面词 | 排查用途 |
|---|---|---|
| 配置 | Config | 以所选配置的规则判断进入规则处理的请求 |
| 代理 | Proxy | 比较目标改经代理后是否可达,不作为逐条匹配测试 |
| 直连 | Direct | 比较目标经当前网络直接访问的表现 |
将界面姿态与规则动作分开读
PROXY 是规则行的动作:把匹配请求交给代理连接处理。它不能创建服务器信息,也不能保证当前服务器能够到达目标。DIRECT 让请求通过当前网络直接访问目标,不等同于解除系统或目标服务的访问要求。REJECT 停止转发匹配请求,可用来明确阻止指定目标;页面报错、超时或资源缺失的表现会随应用而异,不能只看表象判断是否命中拒绝规则。
界面里的 Proxy 与文件里的 PROXY 容易混淆。前者指定整体路由姿态;后者只是在使用规则进行判断时,由某个匹配条件选出的动作。比如你希望普通访问直连、某个服务使用代理,就不必把整个姿态切成 Proxy,而应选择 Config,并将代理条件放进文件中。反过来,要临时比较代理路径能否连接,也没必要改几十行规则,只需记录原姿态,完成对照后恢复。
按文件顺序推演一次命中
[Rule]
DOMAIN,updates.example.com,DIRECT
DOMAIN,telemetry.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
按这个独立片段读,更新主机在第一行接受直连,另一个指定主机在第二行被拒绝,其他同后缀目标在第三行使用代理。第四行只处理没有被上面规则截住且能做地域归类的请求。FINAL,PROXY 则收住所有未命中前面条件的请求。这里的拒绝主机只是演示精确拒绝,不是现成清单。实际使用时,应确认误拒绝不会影响必要功能,并给条目保留明确的恢复办法。
对于这些规则,先命中的条目决定去向,不会再把所有命中项列出来选择最精确的一条。若把后缀规则挪到两条精确规则之前,例外就会失效;把地域规则上移也可能先接住原本准备按域名处理的请求。检查顺序可以拿一个具体目标从上往下读,每行回答“这一行有可用信息可判断吗”和“是否已经命中”。找到首个匹配项后就停止,不要用文件下半部另一条看起来更适合的规则解释结果。
最后决定未列入规则的请求去哪
FINAL 不需要域名、地区或网段字段,通常保留一条并置于规则末尾。FINAL,DIRECT 使未列入名单的请求直连,适合只对明确目标走代理的做法;FINAL,PROXY 让其余请求进入代理路径,其行为取决于已选代理的可用性。判断是否修改兜底时,要看普通办公、家庭设备和临时新域名应该怎么走,不能只看当前有问题的一个站点。若频繁用改兜底解决单站点问题,应回头建立准确的例外。
测试一份策略至少准备三种目标:应命中精确例外的目标、应被宽规则归入的目标,以及应落到兜底的目标。有拒绝项时再补一个可以安全失败的请求。改完需要重建测试连接,不能用已经建立的会话推断新策略。用这种方法能同时发现两类错误:新目标未按预期变化,以及原本不该受影响的目标跟着变了。两种错误都应在保留配置之前处理。
06 / HOST
Host:指定主机名的解析结果
[Host] 适合处理范围明确的名称解析:已知某个主机名必须在受控环境里指向一个确定地址,而不希望替换所有域名使用的解析器。它作用在名称到地址的关系上。若需求只是让某个名称改走直连或代理,不需要固定地址,应改 [Rule]。把两种变更混在一起,会使原本简单的策略问题变成解析、证书和服务器可达性三方面的排查。
固定地址与选择策略是两件事
[Host]
lab.example.com = 192.0.2.20
[Rule]
DOMAIN,lab.example.com,DIRECT
FINAL,PROXY
在这个教学片段中,[Host] 行把指定名称映射到文档用地址;[Rule] 行使这个确切名称命中直连。上下两部分各做一件事:只保留前者,不会自动得到直连;只保留后者,也不会把解析结果固定下来。如果在实际环境里套用这个结构,应使用自己管理的主机和可达的真实地址,不能把文档用地址当作下载服务或诊断端点。
条目左侧写主机名,不写协议、地址栏路径和端口;右侧使用与场景对应的地址。给主机设定映射不等于给服务设定端口,也不会改掉浏览器请求中的主机名。若新地址上没有相应服务,或者该端口未监听,解析成功后仍会连接失败。若同一个地址承载多个站点,也要确保目标服务器会按请求名称选择正确的服务,而不只是看到它能对某个地址返回任意页面。
检查固定地址带来的边界
手工固定的映射不会随原服务的 DNS 变化自动更新。平时依靠多个地址轮换的服务,固定到其中一个地址后就失去了原有的切换能力;迁移完成后,忘记删除的条目还会让某台设备持续连向旧服务器。因此,长期条目应说明它针对哪一张网络、哪个名称以及谁维护对应地址。临时迁移验证则应明确撤回条件,不宜把观察时取得的某个公共地址写成永久条目。
如果地址只在办公网或实验网络内可达,切换到蜂窝网络后失败可能是预期现象。验证时要保留访问条件:当前设备连入哪张网络,访问是否选择 DIRECT,目标地址与实际监听端口是否对应。若请求经代理路径处理,还要考虑代理端是否能访问同一地址,以及解析是在本地还是远端完成。不要假定本地映射一定会改变远端对该名称的解析结果。
访问 HTTPS 时,名称与证书仍须匹配。即便映射的地址能够接通,只要对端交付的是另一个站点的证书,就不能把测试判为通过。直接打开目标地址看到一个页面,也不足以证明用域名访问会成功;两次访问的主机名可能不同。遇到名称不匹配,先让服务端为测试域名提供正确的站点配置和证书,不要把忽略身份校验作为完成映射的步骤。
按改前、改后和回退三组结果验证
先记下未修改时的解析与访问结果,然后只加一条映射,用原域名建立新的连接。核对目标地址是否改变、策略是否维持、服务能否对原名称作出正确响应。接着用同域下不应受影响的另一主机名做对照,确认没有顺手改变公共解析器或宽规则。若结果没有改变,先确定选用的确是修改后的文件,再查是否仍在使用缓存、旧连接或另外的解析路径。
撤回时,在副本中移除自己的映射或重新选用旧文件,再发起新请求,验证地址是否回到原有解析路径。不要只删除关联合用的直连规则:那会留下固定地址,之后访问仍有可能继续到旧服务器。也不要只看编辑器中已没有那一行;真正的回退结果是新发出的请求重新按预期解析。对照记录应保留到测试完成,但不应对外发布真实内部名称和地址。
用
[Host]管地址,用[Rule]管去向。验证固定地址时始终用原域名发起一次新请求,并保留能撤回的配置副本。
07 / URL REWRITE
URL Rewrite:请求地址改写与重定向
[URL Rewrite] 用于根据可见的 URL 执行改写,适用例子是把自己管理的测试站点上的旧帮助页,引导到同一站点的新页面。它不是规则策略的另一种写法。[Rule] 关心当前目标使用什么连接路径;[URL Rewrite] 关心匹配到的请求地址如何变化。若用户只想让某个域名走代理,应该加规则而不是加重定向,否则访问的页面与请求流程也会被改变。
把匹配范围缩到具体协议、主机和路径
[URL Rewrite]
^http://docs\.example\.com/old-help$ http://docs.example.com/help 302
该行用空格分隔匹配表达式、目标 URL 和重定向状态。开头的 ^ 与结尾的 $ 约束整个地址;主机名里的 \. 表示字面点号,而不是任意字符。这个例子只匹配没有查询参数、没有结尾斜线的旧页面,不匹配路径更深的请求,也不会匹配目标页本身。明确写出这些边界,比写一条匹配所有相似字样的表达式更易验证和撤回。
示例以普通 HTTP 说明客户端能看到完整地址时的行为,宜在自己控制的测试环境验证。不要据此把实际服务从 HTTPS 改成 HTTP,也不要为了套用示例而降低系统的证书校验要求。仅能识别 HTTPS 连接的主机时,不代表能识别其完整路径和查询参数。对于自己维护的加密站点,正式的地址迁移优先由服务器返回正确的重定向,这样不同客户端也能得到一致结果。
确认改写会触发一次新的请求
在这个 302 示例中,应用如果接受重定向,会按返回的新地址发起另一次请求。新请求的目标需要独立可达,适用的策略也应按新目标确认。不能在看见旧地址已经匹配之后,就认定新页面也已加载成功。测试时分开记录两个结果:旧请求有没有得到期待的重定向,以及请求新地址后服务是否返回预期内容。若第二段失败,应查新目标的解析和策略,而不是继续放宽旧地址的表达式。
帮助页的重定向不能原样用于登录、表单提交或需要保持方法与请求内容的接口。应用跟随 302 时可能改用不同的请求方法,也可能不转发原有的请求内容。尤其不要把含登录状态、凭据或私人查询字段的真实请求用作试验。即便目标不变更域名,改变路径也可能让请求落到用途不同的处理程序上。用不带敏感参数、只读取静态内容的页面做对照,能把这些副作用排除在验证之外。
检查重复匹配、循环与缓存
先在没有任何改写时分别访问旧页和新页,确认得到的响应来自哪一处。加入单条规则后,用旧地址验证正例,用新地址和一个相邻路径验证反例。如果新地址也会命中同一表达式,或者站点本身又把新地址送回旧地址,就会形成循环。此时收窄匹配或撤回改写,不能用增加第三条重定向掩盖问题。还要检查其他改写是否同时覆盖这两个地址,逐条禁用测试比同时改写多个表达式更容易定位。
若删除规则后仍看到跳转,先比较一次新的请求,再判断是客户端仍用旧配置、应用复用了先前的响应,还是服务器自己在重定向。地址栏最终停留的位置并不显示中间经过了几次跳转。目标若在第一次测试之前就会自行跳转,新增规则的有效性必须从单次请求收到的响应判断,不能仅凭最终页面相同。没有可用诊断信息时,可先去掉改写,重新建立连接,再用两个地址分别做对照。
只保留能明确说明作用范围的改写条目。每一项都应能回答:旧地址为何需要保留、哪些请求不能改、谁能维护新地址、何时可以撤回。不要依赖改写配置承担正式服务迁移的唯一职责。若多人和多个设备都必须得到同样的结果,服务端的明确响应比各设备分别维护一份本地改写更容易核对。
先用单条规则和两个可控地址完成对照。只要所需信息是不可见的加密路径,扩大表达式就不能解决匹配问题。
08 / VERIFY & RESTORE
配置验证、故障定位与回退
配置排查的目标不是让某次刷新碰巧成功,而是确定哪项改动造成了可重复的变化。先选一个可重复发起的请求,写下预期主机、预期策略和预期结果,再记录正在使用的网络、配置文件与服务器。尽量在同一台设备上做对照,不同时切换无线网络、连接姿态或订阅里的服务器。无法控制的条件也要记下来,例如测试时设备刚从无线网络转到蜂窝网络。
用四步区分故障所在的层次
- 连接:核对 Home 中的连接状态和当前选用的服务器。可以用已有资料做 Connectivity Test,但测试通过只表示对应测试成功,不代表所有业务目标可达。
- 配置:从 Config 核对实际使用的文件,再从 Global Routing 核对是否处于 Config。发送一次新请求后,观察目标是否进入预期的规则处理。
- 解析:需要按地址判断时,比较当前网络下实际使用的地址和地址族;若目标连一个可用地址都没有,不要先增加地址规则。
- 服务:检查代理或直连策略是否符合预期,并区分访问失败发生在连接建立、证书校验还是服务返回响应之后。
同一请求若在 Proxy 下成功、在 Config 下失败,重点检查 Config 中是不是有一条更早的规则给了不同策略,或者兜底走向与设想不符。若两种姿态都失败,先检查共用的服务器、目标和网络条件;若 Direct 能成功,至少可把直连结果用作对照,但仍不能只凭这一点定位某条规则。完成姿态对照后切回原设置,避免把诊断动作留成日常配置。
检查漏匹配与规则遮挡
[Rule]
DOMAIN,editor.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
可按这个片段设计三种验证对象。第一种是指定例外,预期直连;第二种是同后缀的其他主机,预期代理;第三种是不在该后缀下、也不会被其他条件匹配的主机,预期走兜底。示例名称只演示规则关系,真测时换成符合这些关系且已知可达的目标。第一种失败时回到文件顶部寻找更早匹配项;第二种失败时核对目标是否真属同一后缀;第三种改变时检查是否误改了兜底或其他公共参数。
有两类表现容易误判为漏匹配。一是复用了修改前已建立的连接,此时即使文件正确,新规则也没有机会处理那条旧连接;二是主要页面能打开,但一次失败的附属请求用了完全不同的主机名。前一种要重新建立测试连接,后一种要定位实际失败目标。不要为了让界面上不再报错,就给整组服务换策略。需要检查一段请求记录时,只摘录足以辨认规则类型的内容,并先去除订阅查询参数、认证字段和私人地址。
按症状撤回最小改动
若只有一个目标受到影响,先移除最后添加的精确规则并测同一请求。若多个原本正常的目标同时变坏,优先还原最近修改的宽规则、FINAL 或 [General] 参数。若改动跨了多个段、又没有明确记录,则直接选回已知可用的旧文件。恢复旧文件后还要核对姿态和服务器,否则留在对照测试所用的姿态下,即使文件已恢复,也不能复现原状态。
有些变化不是文件触发的。例如,切换网络后客户端可能按 On Demand 的条件重新建立连接;已有远程配置更新也可能替换此前用来测试的内容。如果问题只随切换发生,先保持一张网络完成一次对照,再分别检查 On Demand 条件与远程配置是否发生变化。需要理解连接触发与后台行为时,可查On Demand 与后台耗电说明,不要用新的分流规则补偿尚未定位的连接重建问题。
最终留下的记录不必完整抄写配置,但应能回答四件事:改了哪里、哪个目标变了、哪个对照目标没有变、如何退回。若旧配置也无法恢复访问,应停止继续叠加修改,回到服务器资料、设备连接状态与目标服务本身。可从问答中的无法连接排查继续核对;需要重新跑通添加资料、选择姿态和验证连接的全过程时,按快速上手的顺序操作。
验收以新请求为准:应改变的目标已经改变,不应改变的目标保持原状,旧文件和原有设置仍可恢复。