指南排障症状
mihomo dns resolve failed / no such host 排查
mihomo 或 Clash Verge Rev 日志里报 dns resolve failed、no such host、couldn't find ip 时怎么查:先分清是订阅域名、节点域名还是要访问的网站解析不了。
- 发布
- 更新
- 核对
- 门槛
- 进阶
- 类别
- 排障
最后更新于:2026-11-16
DNS RESOLVE FAILED
先从日志里找出紧挨着报错的那个域名和当时的操作,再只动对应的那一层。`no such host` 只说明这一次没解析出来,并不能证明域名已经失效。
- 节点域名先看 `proxy-server-nameserver`,别急着去改目标网站用的 `nameserver`。
- 目标域名分清是 mihomo 自带 DNS、系统 DNS,还是浏览器的 Secure DNS。
- 先退回原样换回原始配置,只留一个节点、一种接管方式、一个用来测试的域名。
先找出是谁解析失败
| 出错时在做什么 | 日志里出现的对象 | 属于哪一层 | 修好的信号 |
|---|---|---|---|
| 刷新订阅 | 订阅地址的域名 | 客户端 / provider 拉取配置 | 配置的更新时间变成了新的 |
| 测延迟或连节点 | 节点 server 域名 | 节点域名的引导解析 | 同一域名的节点能真正连上 |
| 打开网页或 App | 要访问的网站域名 | mihomo nameserver、规则或应用自带的 DNS | 同一个目标能反复打开 |
| 建立 DoH / DoT 连接 | DNS 服务器的域名 | default-nameserver 和上游能否连通 | DNS 上游开始正常回应 |
| 访问 NAS / 路由器 | 局域网里的名称 | 本地 DNS、hosts 和 fake-ip 的例外规则 | 本地名称和 IP 都能打开 |
发日志求助前,把完整订阅 URL、token、UUID、节点域名、用户名和本机路径遮掉。也别把订阅 URL 贴到公开的 DNS 检测网站上。
一次只动一个变量
1
记下对象和操作
保存报错原文、时间和上下几行,判断当时是在刷新订阅、连节点还是打开网站;记录前先做脱敏。
2
退回能复现的起点
用服务商给的原始配置、Rule 和一个固定节点;电脑上先走系统代理,TUN 先关。
3
只挑一条线查
订阅域名、节点域名、目标域名、DNS 上游、局域网名称,眼下哪个失败就只查哪个。
4
每次只换一个条件
轮流对比网络、节点类型、浏览器 Secure DNS 或 TUN;每改一处都重启内核,再测同一个目标。
5
留下修好后的最简配置
稳定成功之后,先别急着加回覆写、一堆公共 DNS、复杂的 fake-ip-filter 或第二个代理客户端。
| 只换这一项 | 结果 | 更像哪一层出错 |
|---|---|---|
| 配置、节点、目标都不动,只换成手机热点 | 热点能用,原来的网络不行 | 原网络、路由器或单位的 DNS |
| 订阅里既有 IP 节点也有域名节点时,只换节点 | IP 节点能用,同域名节点不行 | 节点域名的引导解析 |
| 同一个网站,只开关浏览器 Secure DNS | 结果跟着设置变 | 浏览器的 DoH 上游或策略 |
| 同一个网站,只在系统代理和 TUN 间切换 | 系统代理能用,TUN 不行 | TUN 路由或 DNS hijack |
刷新订阅时出错
不同客户端刷新订阅时走的 DNS 不一样,别以为它一定用当前配置里的 mihomo DNS:
- 到服务商后台确认订阅还有效,重新复制一遍完整 URL。
- 把客户端覆写恢复默认,关掉 TUN 再刷新一次。
- 订阅不动,换手机热点对比一下。
- 看看服务商公告,是否换了订阅地址或给了备用域名。
旧节点还能连,也说明不了订阅域名没问题。接着照 订阅更新失败排查 去查 HTTP 状态码、认证和格式。
节点域名解析失败
节点的 server 填的是域名时,mihomo 得先拿到入口 IP:
proxy-server-nameserver专门用来解析代理节点的域名;不填时才退回使用nameserver-policy、nameserver和fallback。default-nameserver负责解析 DNS 服务器本身的域名,并不是通用的“节点 bootstrap DNS”。respect-rules让 DNS 请求也按路由规则走,但前提是配置了proxy-server-nameserver。如果解析代理节点要先连上代理,就会陷入死循环。
新手请换回服务商的原始配置,别自己拼网络配置。同一个域名节点换了两种网络都不行,就把脱敏后的日志、时间和节点显示名发给服务商。
要访问的网站解析失败
节点能正常访问,只有某一个域名不行时,再去查目标解析:
- 不改
Rule、节点、网络和目标都不变,刷新规则后再试。 - 撤掉自定义的
nameserver-policy、hosts 以及fake-ip-filter,恢复原始配置。 - 只有浏览器打不开时,临时对比 Secure DNS 设成自动和关闭两种情况;关掉加密 DNS 只能当测试,不能当长期办法。
- 所有应用都打不开时,再清掉系统和应用的缓存,并重启 mihomo 内核。
Chrome 自定义的 Secure DNS provider 出错时,不会自己退回明文查询;Firefox 也有一套单独的 DoH 模式。浏览器报错、mihomo 日志里却什么都没有,就先查这一层。
目标域名已经解析出来,却返回 `403`、地区受限、登录或订阅资格的错误,说明 DNS 这步已经过了。这时去看对应服务的专题,别再一层层加 DoH 和公共 DNS。
只有 TUN 或局域网出问题
dns-hijack 能把匹配到的连接交给内置 DNS,但 Android 的私人 DNS 它没法自动劫持;Windows / macOS 上发往局域网 DNS 的请求也劫持不了。
- 系统代理正常、TUN 不行:把客户端的 TUN / DNS 恢复默认,只临时停掉别的 VPN 或 Android 私人 DNS 对比一次。然后去看 开 TUN 后断网。
- NAS、打印机或路由器的名字解析不了:保留本地 DNS / hosts 这条路,检查对应的
fake-ip-filter;局域网名称别用公共 DoH 去代替解析。 - TUN 开关本身打不开:先解决 服务模式 / TUN 权限失败,改 DNS 补不上系统权限。
报错文字怎么看
| 报错原文 | 含义 | 不能说明什么 |
|---|---|---|
no such host / name_error | 当前用的解析器说这个域名不存在 | 不能就此认定服务商已下线 |
couldn't find ip | 没拿到能连的 A / AAAA 记录 | 不代表节点端口坏了 |
i/o timeout | 查询或连接超时没回应 | 得先确认超时的是不是 DNS |
| TLS / HTTP 错误 | 已经连上 DoH 上游,但握手或请求出错 | 并非单纯的域名不存在 |
connection refused | 地址已经有了,但目标端口拒绝连接 | 多半不是单纯的解析问题 |
别用 skip-cert-verify 去盖住 DoH 的证书错误,也别把 DNS、TUN、IPv6、规则一起改。每条线只要它自己的恢复信号成立就够了,不用强求每个 DNS 检测网站都显示一样的结果。
可对照的官方资料
- mihomo DNS 配置项说明
- mihomo DNS 的解析流程
- mihomo TUN 和 dns-hijack
- Google Chrome Secure DNS 帮助页
- Mozilla Firefox DNS over HTTPS 帮助页