内容索引
配置原本可以运行,换内核后却被拒绝,重点应放在首条解析错误。盲目扩大后缀范围可能让检查通过,却改变解析和嗅探行为;先列清要覆盖的名称,才能决定正确的表达式。
从解析错误确认是否属于域名校验
若最早出现的是缩进错误、unsupported field 或 proxy not found,就先解决文本结构、字段兼容或引用关系。程序已正常运行但页面无法访问,也应进入连接层排查。
先比对内核版本和日志。原配置在 v1.19.29 可加载、切到 v1.19.30 后出现 Parse config error: invalid domain 时,才沿着域名模式检查;不能仅凭启动失败就确定原因。
相关讨论将问题定位到 dns.fake-ip-filter 和 sniffer.skip-domain。新版本对域名通配表达式的检查更严格,因此配置可在解析阶段被拒绝,改变代理选择并不会绕过这一步。
按最早错误选择检查入口
| 错误线索 | 所在环节 | 处理起点 |
|---|---|---|
| Parse config error: invalid domain | 域名表达式检查 | 先确认换版本前后的差异 |
| Invalid YAML 或层级缩进异常 | 配置文本解析 | 修正格式后再加载 |
| proxy / group not found | 对象名称引用 | 核对引用名称及目标是否存在 |
| 内核正常,个别名称访问异常 | 解析和连接路径 | 结合请求记录继续定位 |
先保存运行结果及其生成设置
若现有程序还在转发,先把配置和日志保存好,再安排调整。备份应包含实际内核与应用版本;对外提供的内容需去掉密码、控制凭据及私人名称。
恢复所需文件的整理顺序
确定正在运行哪个程序
从启动记录、应用信息或对应程序的版本输出确认内核,别把界面更新状态当作实际版本。
保存生成后与生成前的配置
最终 YAML、Profile、Merge、覆写及转换设置都要对应保存。仅复制临时运行文件,可能在下次重新生成时丢失修正。
留下可用程序作为恢复手段
原来已经运行验证的 v1.19.29 可以单独保留,并与其发布来源和适用架构对应。
暂时固定其他网络设置
处理域名列表时保持出口、解析方式和网络接管设置一致,让每次结果能与当前修改对应。
从最终配置缩小无效模式范围
使用计划运行的内核检查候选文件,命令形式见下方示例。测试成功表示解析及初始化完成,实际转发和访问仍需单独验证。
错误信息没有指出具体字段时,先在最终 YAML 及关联文件中查星号,再逐项核对已知相关列表。修好当前表达式后重新检查,后面的错误才可能显露。
mihomo -v
mihomo -t -f /path/to/config.yamlgrep -R -n '\*' /path/to/config.yaml /path/to/rules 2>/dev/null标签内部夹有星号
rrn-sw-*、a*.example.com 和 *a.example.com 都把通配符与标签内容混用,应改为符合实际名称的表达。
星号作为独立的完整标签
*.example.com 与 time.*.com 的结构符合这一要求;若仍报错,应继续核查列表中的其他内容。
尾点、空标签与多余空白
严格检查还会拒绝带尾点、连续分隔点或两端空白的名称,不应只围绕星号排查。
没有星号时的后续方向
接着检查加号用法、空标签及末尾字符,并确认看到的确实是内核收到的最终文件。
先弄清表达式会覆盖哪些名称
域名列表的通配写法与路由规则 DOMAIN-WILDCARD 语法不同。应用到 fake-ip-filter 或 skip-domain 之前,应先确认该字段接受的表达形式。
判断重点是点分标签:星号单独占据标签才有效。time.*.com 的中间标签只有通配符,而 rrn-sw-* 把普通字符和星号放到同一标签内,两者不能互相替换。
将表达式与覆盖范围对应
| 表达式 | 能够覆盖 | 范围以外 |
|---|---|---|
| *.example.com | 直接下一级子域,例如 a.example.com | 根域及更深层的 b.a.example.com |
| +.example.com | 根域连同各层子域 | 不属于该根域的名称 |
| .example.com | 各个层级的子域 | 根域 example.com 本身 |
| time.*.com | 中间仅有一个标签的位置 | 缺少中间标签或有更多层级的名称 |
| * | 只有单个标签的短名称 | 由点分隔的多段名称 |
rrn-sw-*
a*.example.com
*a.example.com
a*b.example.com根据主机清单选择表达方式
固定根域下的子域可按所需层级选择合法写法。若需要的是 rrn-sw- 开头的短主机名,这类列表没有等价的标签内前缀通配方式,应把确实需要的主机逐项列出。
把前缀表达式改成 *.rrn-sw 或类似后缀,并不会保留原来的含义。先用实际查询名称核对每条配置,确保通过检查后的表达式仍覆盖原本业务。
sniffer:
skip-domain:
- "rrn-sw-01"
- "rrn-sw-02"
dns:
fake-ip-filter:
- "+.example.com"
- "time.*.com"由真实用途决定替换方式
| 希望覆盖的名称 | 需避免的写法 | 可采用的表达 |
|---|---|---|
| 一组具有 rrn-sw- 前缀的短主机 | 依靠标签内星号继续匹配 | 逐项写出实际存在的短主机名 |
| example.com 下直接相邻的子域 | 用标签内部分通配符表达 | 写成 *.example.com |
| 根域及其下所有层级 | 在根域前直接拼接星号 | 写成 +.example.com |
| 仅子域,覆盖深层而排除根域 | 把单层星号当作任意层级 | 采用 .example.com |
加载成功后还需检查实际命中
选取应被过滤的名称、应跳过嗅探的名称及普通公网名称,逐类核对解析结果与连接。这样才能发现表达式合法但覆盖对象不对的情况。
候选配置启用前后的顺序
先检查独立候选文件
让对应内核对候选 YAML 完成 -t 检查,保留最终输出。
留下原文件后再启用
不要覆盖唯一可用副本,确保配置切换出现问题时仍可恢复。
核实新配置确实被加载
通过日志确认实际进程和配置路径,避免继续观察旧实例的结果。
检查解析与连接结果
用预先选定的名称核查过滤、嗅探、规则选择及实际访问。
处理是否完成的依据
- 根域、直接子域和更深层名称均按预期覆盖。
- 普通访问没有因规则范围扩大而受到影响。
- 生成设置、原始配置与恢复文件均可对应找到。
生成设置相关的常见疑问
修改运行文件后暂时成功,重新生成又失败时,应追踪 Profile、转换与覆写的关系。对比两次最终 YAML,找到重新写入旧表达式的位置,比重复编辑临时文件更有效。
能修改生成设置时应从那里修正,再重新产生候选配置。只能调整本地覆写时,需确认替换后的整个列表仍然合法;对外提交内容前先移除凭据。
重新生成后为什么又出现同样错误?
旧表达式可能来自转换或上游配置。修正写入它的设置,再检查最终输出。
切换 Profile 后也要单独检查吗?
需要,各 Profile 的 Merge、Script 和覆写可能不同,应分别查看实际生成内容。
文件已改,为什么错误仍指向旧值?
先对应实际加载路径、运行进程和最终配置,确认修改的是正在使用的文件。
范围过宽时继续收紧
按业务真正使用的主机逐项列举,再核对不该命中的名称。
无法及时修订时如何恢复运行
需要先恢复网络时,可停止相关接管并还原备份。旧程序只能在先前已验证的环境中作临时恢复,待生成设置完成修正后,再用目标内核重新检查。
版本回退不改变表达式本身。旧程序不报错、预发布程序提供更多提示、修订后配置正确,分别代表不同事情,长期使用仍应建立在明确的匹配范围上。
恢复操作的检查顺序
先停止失败后的重复尝试
让系统流量退出失效的本地转发路径,再恢复可用网络。
还原配套的配置文件
把 Profile、最终文件及必要覆写成套恢复,避免混入来源不明的目录内容。
按需使用保存的程序版本
恢复程序要与系统架构及原配置匹配,并留下回退缘由。
修正生成设置后重新核查
回到目标内核,依次完成候选检查、实际启动和域名查询。
