Mihomo 节点连接失败怎么办?按日志、DNS 和 TUN 逐步排查
简答:Mihomo 节点连接失败,先关闭 TUN,用 HTTP、SOCKS 或 mixed-port 测试一次普通代理;如果普通代理可用,问题通常在 TUN、系统路由或 DNS。如果普通代理也失败,再查看 debug 日志,区分节点参数、订阅配置、DNS 解析和端口占用。不要同时修改多个配置,先确定是单个节点失败、全部节点失败,还是流量根本没有进入 Mihomo。
定义:Mihomo 节点连接失败,是指 Mihomo 内核无法通过某个代理节点建立连接,或节点虽显示可用但实际请求未按预期经过代理。
先做 3 分钟快速判断:别急着换节点
如果 Mihomo 显示节点连接失败,先完成下面三步。第一步只保留一个已知节点,避免自动选择或 URL-test 同时切换;第二步暂时关闭 TUN,只保留普通代理端口;第三步用实际网页或命令测试,而不是只看节点延迟。Mihomo 支持 HTTP、SOCKS 和 mixed-port,mixed-port 同时支持 HTTP(S) 与 SOCKS5,具体端口以当前配置为准,相关字段可参考Mihomo 代理端口文档。
| 现象 | 优先怀疑 | 先做什么 |
|---|---|---|
| 只有一个节点失败 | 节点地址、端口、密码、UUID、TLS 或 SNI | 换同订阅中的另一个节点,并核对该节点字段 |
| 全部节点都失败 | 订阅、内核、DNS、系统时间或网络出口 | 查看启动日志,再测试节点域名是否能解析 |
| 节点测速超时,但网页可以打开 | 测速目标、规则或测速方式 | 访问实际目标站点,不要把测速超时直接当成节点失效 |
| 显示已连接但所有应用打不开 | 系统代理、规则、TUN 路由或 DNS | 关闭 TUN,确认普通代理端口能否承载请求 |
| 开启 TUN 后断网 | 权限、auto-route、DNS 劫持、网卡或防火墙 | 关闭 TUN 恢复网络,再逐项开启 |
本文是本站的第三方使用指南。不同 Mihomo 图形客户端的菜单名称可能不同,但排查顺序仍可按“内核—配置—节点—DNS—流量接入”执行。
第一层:确认内核和配置真的加载成功
- 确认内核正在运行。如果客户端界面打开但内核进程没有启动,所有节点都会失败。查看客户端的内核状态、启动日志或控制页面,重点寻找配置加载失败、进程退出和端口监听失败。
- 把日志级别临时改为 debug。Mihomo 文档说明,
log-level: debug会输出运行时尽可能多的信息;排查完成后可恢复为info,避免日志过多。参考Mihomo 全局配置中的日志级别说明。 - 检查 YAML 格式。重点看缩进、冒号后的空格、列表短横线、重复字段和引号。配置文件能被加载,不代表节点字段一定正确;如果配置为空、节点列表为空或代理组引用了不存在的节点,先重新载入配置。
- 检查端口占用。如果日志出现
address already in use,说明配置的 HTTP、SOCKS、mixed 或控制端口可能已被其他进程占用。换一个未占用端口后重启内核,或关闭占用该端口的程序。
如果客户端提供外部控制器,可以通过控制页面查看实时日志;Mihomo API 的 /logs 接口支持按 info、warning、error 和 debug 获取日志,具体说明见Mihomo API 文档。
第二层:按日志关键词判断是节点还是 DNS
| 日志关键词 | 通常说明 | 处理动作 |
|---|---|---|
dns resolve failed | 节点域名或目标域名无法解析 | 先测试域名解析,再检查 nameserver、default-nameserver 和节点域名解析配置 |
i/o timeout | 连接或读取在规定时间内没有完成 | 先换一个节点和网络出口,区分单节点问题与全部节点问题 |
connection refused | 目标端口拒绝连接,或本地端口没有服务监听 | 核对节点端口;若出现在本地端口,检查端口占用和客户端代理设置 |
address already in use | 监听端口已被占用 | 修改对应端口或关闭冲突程序后重启 |
permission denied | 系统权限不足,常见于 TUN 或路由操作 | 退出 TUN,使用管理员或系统授权重新启用;不要直接放宽所有防火墙权限 |
tls handshake、证书或 SNI 错误 | TLS 参数、服务器名称或证书校验不匹配 | 重新导入节点,核对 TLS、SNI、传输方式和证书相关字段 |
日志关键词只能作为分流线索,不能单独证明节点已经失效。对同一节点重复测试时,应保持目标地址、网络和配置不变,避免把网络波动误判为配置问题。
第三层:核对节点字段和订阅内容
如果日志指向节点连接本身,先不要修改 DNS 或 TUN。Mihomo 的代理节点通常至少需要名称、类型、服务器地址和端口;不同协议还会增加密码、UUID、传输方式、TLS、SNI、证书或服务器指纹等字段。官方配置文档对通用代理字段的说明见Mihomo 出站代理配置。
- 只选一个节点进行测试,记录节点类型和服务器地址是否为空。
- 重新更新订阅,确认返回内容不是登录页、错误页、空文件或无法解析的格式。
- 检查订阅更新是否需要认证,以及客户端是否报告 HTTP 状态码、超时或格式错误。
- 如果导入后节点名称存在但参数缺失,不要手工猜密码、UUID 或 TLS 字段,优先从原始配置重新导入。
- 若只有某一协议失败,先换同协议的另一个节点;若所有协议都失败,再回到订阅、网络出口和 DNS 层排查。
节点的“延迟测试”与真实网页请求不是同一件事。延迟测试可能只检查 TCP 建连或特定 URL,不能替代实际目标站点访问;判断故障时应同时记录测速结果、实际请求结果和日志。
第四层:DNS 解析失败时怎么处理
DNS 问题常见于“节点域名解析失败”“网页打不开但 IP 请求正常”或“开启 TUN 后反复解析同一个地址”。Mihomo 的 DNS 配置包括 default-nameserver、nameserver、fallback、proxy-server-nameserver 和 direct-nameserver,它们用途不同,不能随意互换。官方字段说明见Mihomo DNS 配置文档。
- 先确认是否为节点域名问题。如果节点服务器填写的是域名,重点看日志中是否出现该域名的解析失败。节点服务器填写 IP 时,则应转查端口、TLS 或网络出口。
- 区分普通域名解析和节点域名解析。
proxy-server-nameserver专门用于解析代理节点域名。配置 DNS 遵循路由规则时,官方文档提示需要考虑该字段,否则可能出现“解析节点需要代理、建立代理又需要先解析节点”的循环。 - 暂时简化 DNS。排查期间不要同时启用复杂的 nameserver-policy、多个 fake-IP 过滤规则和自定义代理 DNS。先保留最小配置,确认基础解析恢复后再逐项加回。
- 检查 fake-IP 和 IPv6。如果只有局域网设备、特定应用或 IPv6 目标失败,可临时关闭 IPv6 或将相关局域网域名加入 fake-IP 过滤,验证是否为兼容性问题。修改前保存原配置。
第五层:关闭 TUN,先验证普通代理
TUN 会接管更底层的系统流量,因此权限、路由、DNS 劫持、网卡选择和防火墙都可能影响结果。Mihomo 文档说明,TUN 的 auto-route、auto-detect-interface、dns-hijack、strict-route 和 dns-mode分别影响路由、出口网卡和 DNS 流量接入,详见Mihomo TUN 配置文档。
- 关闭 TUN,并关闭系统代理自动切换后重新启用普通代理。
- 在浏览器或支持代理的应用中,手动填写 Mihomo 的 HTTP、SOCKS 或 mixed 端口。
- 使用实际目标站点测试。如果普通代理能用而 TUN 不能用,说明节点本身大概率不是第一嫌疑,应转查 TUN 权限、路由和 DNS。
- 确认普通代理稳定后,再只开启 TUN,不同时修改 DNS、规则和代理组。
- 如果开启 TUN 后断网,立即关闭 TUN;必要时重启客户端,让系统路由恢复,再检查防火墙和网卡配置。
常用命令示例,端口请替换成当前配置中的 mixed-port:
curl -v -x http://127.0.0.1:7890 https://example.com/该命令只用于验证本地 HTTP 代理是否能发起请求;如果你的端口不是 7890,不能直接照抄。
按系统分流:Windows、macOS、Android、Linux
| 系统 | 先检查 | 仍失败时 |
|---|---|---|
| Windows | 关闭 TUN,确认系统代理地址和端口;检查是否有其他客户端占用端口或拦截网络 | 以管理员权限重新启用 TUN,检查自动路由、DNS 劫持和 Windows 防火墙规则 |
| macOS | 确认系统代理是否指向 Mihomo 端口,关闭 TUN 测试普通代理 | 检查系统授权、虚拟网卡、DNS 状态和多网卡出口;不要同时启用多个代理软件 |
| Android | 区分应用代理、VPN/TUN 和系统 Private DNS;先关闭 Private DNS 或 TUN 做对照测试 | 检查电池优化、VPN 权限、应用分流和局域网访问限制 |
| Linux | 检查端口监听、默认路由、DNS 管理服务和防火墙状态 | 确认 NetworkManager、systemd-resolved 或其他网络服务没有接管 TUN 接口 |
不同客户端对 TUN 的权限提示、菜单名称和恢复网络按钮可能不同,以上是排查方向,不代表所有客户端都使用完全相同的界面。Linux 上尤其要注意多个网络管理服务同时管理 TUN;相关场景也可能导致 DNS 设置被覆盖,遇到此类问题应记录网络管理服务状态后再处理。
规则模式、全局模式与代理组怎么对照
如果节点测试成功,但某些网站或应用仍无法访问,问题可能是规则没有把请求交给代理。Mihomo 支持 rule、global 和 direct 三种运行模式,默认通常为规则模式;官方说明见Mihomo 全局配置文档。
- 临时切换到全局模式,并在 GLOBAL 代理组中明确选择一个节点。
- 访问同一个实际目标站点,记录是否恢复。
- 如果全局模式可用、规则模式不可用,检查规则顺序、代理组选择和是否被
DIRECT提前匹配。 - 如果两种模式都不可用,继续检查节点、DNS、端口或 TUN,不要只修改规则。
- 测试完成后恢复原模式,避免把全局模式长期当作故障修复。
最小闭环是:同一设备、同一节点、同一目标站点,依次测试“普通代理关闭 TUN”“普通代理开启 TUN”“规则模式”“全局模式”。每次只改变一个变量,才能知道是哪一层造成失败。
排查结束后如何恢复和提交信息
如果仍然无法连接,建议先恢复到最近一次可用配置,再整理脱敏信息。不要公开订阅地址、密码、UUID、私钥或完整节点配置。
- 记录系统、客户端名称、Mihomo 内核版本和 CPU 架构;版本无法确认时写“需核实”。
- 记录是单节点失败还是全部节点失败,以及关闭 TUN 后是否恢复。
- 复制最小范围的 debug 日志,保留错误关键词和时间,不要附带订阅链接。
- 记录配置中是否启用 TUN、fake-IP、IPv6、规则模式和自定义 DNS。
- 如果更改后无法上网,先关闭 TUN并恢复原配置,再逐项重新启用。
最终判断标准不是“节点测速是否变绿”,而是普通代理、TUN 和实际目标请求是否分别通过了验证。这样可以避免把节点问题、客户端问题和系统网络问题混在一起。
常见问题
Mihomo 节点测速失败,是不是节点已经失效?
不一定。测速可能只测试 TCP 建连或固定网址,不能完全代表实际网页请求。先关闭 TUN,用同一个节点通过普通代理访问实际目标站点;如果网页可用而测速失败,应继续检查测速目标、规则和测速方式。
Mihomo 显示已连接,但浏览器打不开网页怎么办?
先确认浏览器是否使用了 Mihomo 的 HTTP、SOCKS 或 mixed 端口,然后临时切换全局模式并关闭 TUN测试。如果普通代理可用而 TUN不可用,重点检查 TUN权限、auto-route、DNS劫持和防火墙;如果普通代理也不可用,则回到节点、DNS和订阅配置。
出现 dns resolve failed 应该改哪个 DNS 参数?
先判断失败的是目标域名还是代理节点域名。目标域名主要检查 nameserver、fallback 和 nameserver-policy;节点域名则重点检查 proxy-server-nameserver。不要一次修改全部 DNS字段,先保留最小配置并查看 debug 日志。
Mihomo 开启 TUN 后断网,怎么恢复?
先关闭 TUN,必要时正常退出并重新打开客户端,让系统路由恢复。之后检查 TUN权限、auto-route、auto-detect-interface、dns-hijack、strict-route和防火墙。不同客户端的恢复网络功能名称可能不同,具体以当前客户端界面为准。
Windows、macOS、Android 和 Linux 的排查方法一样吗?
排查层次相同,但权限和流量接入方式不同。Windows和macOS优先核对系统代理与TUN授权,Android要额外检查VPN权限、Private DNS和电池优化,Linux则要检查端口、路由、防火墙以及NetworkManager或systemd-resolved是否接管网络。