大哥云 - 极速稳定的加速器,加速上外网 自由切换节点 - 1080P无压力 防封稳定xin

Mihomo 节点连接失败怎么办?按日志、DNS 和 TUN 逐步排查

更新于 2026-11-04 · dageyun.buzz

简答: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—流量接入”执行。

第一层:确认内核和配置真的加载成功

  1. 确认内核正在运行。如果客户端界面打开但内核进程没有启动,所有节点都会失败。查看客户端的内核状态、启动日志或控制页面,重点寻找配置加载失败、进程退出和端口监听失败。
  2. 把日志级别临时改为 debug。Mihomo 文档说明,log-level: debug 会输出运行时尽可能多的信息;排查完成后可恢复为 info,避免日志过多。参考Mihomo 全局配置中的日志级别说明。
  3. 检查 YAML 格式。重点看缩进、冒号后的空格、列表短横线、重复字段和引号。配置文件能被加载,不代表节点字段一定正确;如果配置为空、节点列表为空或代理组引用了不存在的节点,先重新载入配置。
  4. 检查端口占用。如果日志出现 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 出站代理配置。

  1. 只选一个节点进行测试,记录节点类型和服务器地址是否为空。
  2. 重新更新订阅,确认返回内容不是登录页、错误页、空文件或无法解析的格式。
  3. 检查订阅更新是否需要认证,以及客户端是否报告 HTTP 状态码、超时或格式错误。
  4. 如果导入后节点名称存在但参数缺失,不要手工猜密码、UUID 或 TLS 字段,优先从原始配置重新导入。
  5. 若只有某一协议失败,先换同协议的另一个节点;若所有协议都失败,再回到订阅、网络出口和 DNS 层排查。

节点的“延迟测试”与真实网页请求不是同一件事。延迟测试可能只检查 TCP 建连或特定 URL,不能替代实际目标站点访问;判断故障时应同时记录测速结果、实际请求结果和日志。

第四层:DNS 解析失败时怎么处理

DNS 问题常见于“节点域名解析失败”“网页打不开但 IP 请求正常”或“开启 TUN 后反复解析同一个地址”。Mihomo 的 DNS 配置包括 default-nameserver、nameserver、fallback、proxy-server-nameserver 和 direct-nameserver,它们用途不同,不能随意互换。官方字段说明见Mihomo DNS 配置文档。

  1. 先确认是否为节点域名问题。如果节点服务器填写的是域名,重点看日志中是否出现该域名的解析失败。节点服务器填写 IP 时,则应转查端口、TLS 或网络出口。
  2. 区分普通域名解析和节点域名解析。proxy-server-nameserver专门用于解析代理节点域名。配置 DNS 遵循路由规则时,官方文档提示需要考虑该字段,否则可能出现“解析节点需要代理、建立代理又需要先解析节点”的循环。
  3. 暂时简化 DNS。排查期间不要同时启用复杂的 nameserver-policy、多个 fake-IP 过滤规则和自定义代理 DNS。先保留最小配置,确认基础解析恢复后再逐项加回。
  4. 检查 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 配置文档。

  1. 关闭 TUN,并关闭系统代理自动切换后重新启用普通代理。
  2. 在浏览器或支持代理的应用中,手动填写 Mihomo 的 HTTP、SOCKS 或 mixed 端口。
  3. 使用实际目标站点测试。如果普通代理能用而 TUN 不能用,说明节点本身大概率不是第一嫌疑,应转查 TUN 权限、路由和 DNS。
  4. 确认普通代理稳定后,再只开启 TUN,不同时修改 DNS、规则和代理组。
  5. 如果开启 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 全局配置文档。

  1. 临时切换到全局模式,并在 GLOBAL 代理组中明确选择一个节点。
  2. 访问同一个实际目标站点,记录是否恢复。
  3. 如果全局模式可用、规则模式不可用,检查规则顺序、代理组选择和是否被 DIRECT 提前匹配。
  4. 如果两种模式都不可用,继续检查节点、DNS、端口或 TUN,不要只修改规则。
  5. 测试完成后恢复原模式,避免把全局模式长期当作故障修复。

最小闭环是:同一设备、同一节点、同一目标站点,依次测试“普通代理关闭 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是否接管网络。

相关阅读

参考资料

  1. Mihomo 代理端口配置文档
  2. Mihomo 全局配置、运行模式与日志级别
  3. Mihomo API 与实时日志接口
  4. Mihomo 出站代理通用字段
  5. Mihomo DNS 配置文档
  6. Mihomo TUN 配置文档
  7. Mihomo GitHub Issue:Linux TUN 与 DNS 服务冲突案例