域名配置排查

Mihomo v1.19.30 拒绝域名条目时怎样找出是哪种写法

遇到 invalid domain,先确定错误来自哪个域名列表。按实际主机与子域需求重写匹配表达式,随后检查生成设置、配置加载和真实查询,保留原来的恢复路径。

  • Mihomo
  • YAML
  • 配置校验
  • 配置兼容
内容索引

配置原本可以运行,换内核后却被拒绝,重点应放在首条解析错误。盲目扩大后缀范围可能让检查通过,却改变解析和嗅探行为;先列清要覆盖的名称,才能决定正确的表达式。

从解析错误确认是否属于域名校验

若最早出现的是缩进错误、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对象名称引用核对引用名称及目标是否存在
内核正常,个别名称访问异常解析和连接路径结合请求记录继续定位

先保存运行结果及其生成设置

若现有程序还在转发,先把配置和日志保存好,再安排调整。备份应包含实际内核与应用版本;对外提供的内容需去掉密码、控制凭据及私人名称。

恢复所需文件的整理顺序

  1. 确定正在运行哪个程序

    从启动记录、应用信息或对应程序的版本输出确认内核,别把界面更新状态当作实际版本。

  2. 保存生成后与生成前的配置

    最终 YAML、Profile、Merge、覆写及转换设置都要对应保存。仅复制临时运行文件,可能在下次重新生成时丢失修正。

  3. 留下可用程序作为恢复手段

    原来已经运行验证的 v1.19.29 可以单独保留,并与其发布来源和适用架构对应。

  4. 暂时固定其他网络设置

    处理域名列表时保持出口、解析方式和网络接管设置一致,让每次结果能与当前修改对应。

从最终配置缩小无效模式范围

使用计划运行的内核检查候选文件,命令形式见下方示例。测试成功表示解析及初始化完成,实际转发和访问仍需单独验证。

错误信息没有指出具体字段时,先在最终 YAML 及关联文件中查星号,再逐项核对已知相关列表。修好当前表达式后重新检查,后面的错误才可能显露。

指定候选文件前先确认对应程序
mihomo -v
mihomo -t -f /path/to/config.yaml
仅在适用系统中查找配置里的星号
grep -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

加载成功后还需检查实际命中

选取应被过滤的名称、应跳过嗅探的名称及普通公网名称,逐类核对解析结果与连接。这样才能发现表达式合法但覆盖对象不对的情况。

候选配置启用前后的顺序

  1. 先检查独立候选文件

    让对应内核对候选 YAML 完成 -t 检查,保留最终输出。

  2. 留下原文件后再启用

    不要覆盖唯一可用副本,确保配置切换出现问题时仍可恢复。

  3. 核实新配置确实被加载

    通过日志确认实际进程和配置路径,避免继续观察旧实例的结果。

  4. 检查解析与连接结果

    用预先选定的名称核查过滤、嗅探、规则选择及实际访问。

处理是否完成的依据

  • 根域、直接子域和更深层名称均按预期覆盖。
  • 普通访问没有因规则范围扩大而受到影响。
  • 生成设置、原始配置与恢复文件均可对应找到。

生成设置相关的常见疑问

修改运行文件后暂时成功,重新生成又失败时,应追踪 Profile、转换与覆写的关系。对比两次最终 YAML,找到重新写入旧表达式的位置,比重复编辑临时文件更有效。

能修改生成设置时应从那里修正,再重新产生候选配置。只能调整本地覆写时,需确认替换后的整个列表仍然合法;对外提交内容前先移除凭据。

重新生成后为什么又出现同样错误?

旧表达式可能来自转换或上游配置。修正写入它的设置,再检查最终输出。

切换 Profile 后也要单独检查吗?

需要,各 Profile 的 Merge、Script 和覆写可能不同,应分别查看实际生成内容。

文件已改,为什么错误仍指向旧值?

先对应实际加载路径、运行进程和最终配置,确认修改的是正在使用的文件。

范围过宽时继续收紧

按业务真正使用的主机逐项列举,再核对不该命中的名称。

无法及时修订时如何恢复运行

需要先恢复网络时,可停止相关接管并还原备份。旧程序只能在先前已验证的环境中作临时恢复,待生成设置完成修正后,再用目标内核重新检查。

版本回退不改变表达式本身。旧程序不报错、预发布程序提供更多提示、修订后配置正确,分别代表不同事情,长期使用仍应建立在明确的匹配范围上。

恢复操作的检查顺序

  1. 先停止失败后的重复尝试

    让系统流量退出失效的本地转发路径,再恢复可用网络。

  2. 还原配套的配置文件

    把 Profile、最终文件及必要覆写成套恢复,避免混入来源不明的目录内容。

  3. 按需使用保存的程序版本

    恢复程序要与系统架构及原配置匹配,并留下回退缘由。

  4. 修正生成设置后重新核查

    回到目标内核,依次完成候选检查、实际启动和域名查询。

相关出处