SS节点、免费V2ray节点|高速V2ray机场翻墙服务-V2free机场返回首页

Mihomo连接失败怎么解决?按日志、节点、DNS和TUN逐步恢复

更新于 2026-11-16 · runba.lol

简答:Mihomo连接失败,最快的处理顺序是:先关闭TUN并退出其他代理或VPN,确认普通网络恢复;再检查内核是否启动、配置是否加载、订阅是否返回有效内容,最后根据日志区分节点、DNS、规则和系统代理问题。Windows可用curl.exe验证Controller和订阅,macOS、Android则优先查看客户端日志与连接记录。

定义:Mihomo连接失败,是指内核未启动、配置未加载、节点无法建立连接,或流量没有经过正确的代理端口、DNS和TUN路径。

先做这一步:关闭TUN和代理冲突,建立网络基线

如果你看到“连接失败”、网页全部打不开、TUN启动失败或开启客户端后系统断网,不要先连续修改DNS、规则和节点参数。先把故障缩小到“客户端本身”还是“系统网络接入”两层。

  1. 关闭TUN:在当前客户端的设置或网络模式页面关闭TUN、虚拟网卡或增强模式。不同图形客户端菜单名称可能不同,无法核实具体入口时,以当前客户端界面为准。
  2. 关闭系统代理:关闭客户端的系统代理开关,并检查系统代理设置中是否仍保留HTTP或SOCKS代理地址。
  3. 退出其他网络工具:暂时退出其他VPN、代理客户端、网络过滤器和虚拟网卡工具,避免多个程序争抢端口或默认路由。
  4. 确认普通网络:直接打开一个平时可访问的网站,或在终端执行ping本地网关。正常结果是关闭Mihomo后系统网络可用;如果仍然断网,先修复系统网络,不要继续改Mihomo配置。

如果关闭TUN后普通代理可以使用,故障重点通常在TUN权限、路由、DNS劫持、自动探测网卡或防火墙;如果普通代理也失败,应先检查内核、配置、订阅和节点。

先看哪一项:现象—日志—动作速查
现象或日志优先判断最小验证与处理
connection refused本地端口或远端端口拒绝连接确认代理端口、Controller端口没有被其他程序占用;单独测试其他节点。
timeout、i/o timeout连接超时、丢包或线路不可达换一个节点复测;只失败一个节点时优先判断节点问题,全部失败时检查网络、时间和配置。
no such host、dns resolve failed域名解析失败检查DNS配置、节点域名解析和Fake-IP;先清理DNS缓存,再查看日志是否恢复。
TLS handshake failedTLS协商、时间、证书或节点参数异常校准系统时间,核对节点的TLS参数;不要为了绕过错误直接关闭证书校验。
客户端显示已连接但网页打不开规则、代理组、系统代理或TUN未接管流量查看连接记录和规则命中结果,确认请求不是DIRECT或REJECT,并确认流量计数有变化。
所有节点都测速失败订阅、配置、DNS或整体链路异常先验证订阅返回内容,再检查内核日志和DNS;不要只反复点击测速。

确认内核、配置和Controller是否正常

Mihomo内核、图形客户端、配置文件和订阅不是同一个故障层。先查看客户端日志入口;如果客户端提供Web面板或Controller,再从配置中的external-controller字段,或客户端设置页确认实际地址。不要猜默认端口。若配置了密钥,请求必须带Authorization: Bearer请求头。官方API文档列出了/version、/configs、/logs、/traffic以及缓存清理接口的请求方法。Mihomo API文档

假设你已经从配置或设置页确认Controller为http://127.0.0.1:端口,并将密钥保存到变量SECRET。示例中的密钥可能暴露权限,复制日志或截图前请遮盖。

Windows PowerShell 5.1或7.x:查询版本和运行配置

$base = "http://127.0.0.1:端口"; $secret = "请替换为你的密钥"; curl.exe -H "Authorization: Bearer $secret" "$base/version"

curl.exe -H "Authorization: Bearer $secret" "$base/configs"

正常结果是/version返回版本字符串,/configs返回当前运行配置;异常结果包括连接被拒绝、401未授权或请求超时。401通常先检查密钥和请求头,不要把密钥直接粘贴到公开位置。

PowerShell 5.1查看订阅HTTP状态

Windows PowerShell 5.1中的curl可能是Invoke-WebRequest别名,建议显式使用curl.exe。Microsoft说明也提醒了这一差异。Microsoft Learn 的 Windows curl 说明

$url = "https://订阅地址.example/path"; try { $r = Invoke-WebRequest -Uri $url -UseBasicParsing -TimeoutSec 20; $r.StatusCode; $r.Content.Substring(0,[Math]::Min(300,$r.Content.Length)) } catch { if ($_.Exception.Response) { [int]$_.Exception.Response.StatusCode } else { $_.Exception.Message } }

PowerShell 7.x或macOS/Linux:也可使用curl.exe -L -o保存响应,Windows PowerShell 5.1保存文件时使用-OutFile,避免把响应内容直接写入配置文件导致编码或格式问题。

curl.exe -L -D headers.txt -o subscription.txt "https://订阅地址.example/path"

正常结果不等于“返回200”就一定能导入:还要检查响应是否是客户端支持的配置或节点格式,而不是登录页、HTML错误页或空内容。部分订阅服务会根据请求头返回不同格式或拒绝请求,curl结果与客户端实际更新结果可能不同;不要随意伪造User-Agent,最终以客户端更新日志和导入结果为准。

按六类日志关键词分流:配置、节点、DNS还是规则

把日志等级临时调到debug后,只复现一次问题,再恢复到合适等级。官方全局配置文档说明,debug会输出尽可能详细的信息,日志等级只影响控制台和控制页面输出。Mihomo全局配置与日志等级说明

  • 配置加载错误:如果出现YAML解析、字段类型、未知字段或配置加载失败,先回退到最近一次可用配置,检查缩进、冒号、列表层级和字段拼写。不要一次性加入多个新字段;字段是否受当前内核支持需以当前版本文档和日志为准。
  • connection refused:可能是本地代理端口未监听、远端节点拒绝连接,或端口被其他程序占用。先在客户端查看HTTP、SOCKS或混合端口,再只选择一个节点测试。
  • timeout:表示在规定时间内没有完成连接,不等于节点一定失效。换一个节点并记录时间;若全部节点超时,再检查系统网络、DNS、系统时间和订阅内容。
  • no such host或dns resolve failed:优先检查节点域名是否能解析、DNS模块是否启用、上游DNS是否可达。Mihomo文档区分了nameserver、fallback、proxy-server-nameserver等用途,不要把节点域名解析和普通网页域名解析混为一谈。Mihomo DNS配置说明
  • TLS handshake failed:先校准系统日期和时间,再核对节点类型、TLS、SNI或传输参数是否来自原始订阅。不要直接关闭证书校验作为长期修复。
  • REJECT、DIRECT或规则命中异常:规则按从上到下匹配,靠前规则优先。官方规则文档说明,规则可以将请求送往DIRECT、REJECT或代理组。打开连接记录,查看目标域名最终命中的规则和策略组;如果误命中DIRECT,检查规则顺序,如果命中REJECT,检查是否存在拦截规则。Mihomo路由规则说明

订阅失败、节点单点失败和全部失败的区别

订阅与节点故障对照表
检查对象正常表现异常表现下一步
订阅地址客户端更新成功并生成配置或节点列表401、403、404、超时、空响应或显示登录页依据订单邮件、已有订阅域名或服务方旧公告核对入口;归属无法核实的地址不要当作登录入口。
单个节点其他节点可以连接或测速只有一个节点反复拒绝、超时或TLS失败暂时停用该节点,保留日志和复现时间,不要据此断言整个订阅失效。
全部节点至少一个节点可以建立连接所有节点同时失败重新检查订阅内容、配置加载、DNS、系统时间、网络和客户端内核版本。
代理组连接记录显示请求进入选中的代理节点组内未选节点、自动选择无结果或实际走DIRECT手动选择一个可见节点测试,再查看规则命中和连接记录。

如果订阅返回401或403,PowerShell 5.1必须通过try/catch读取异常响应状态,不能假设请求会正常返回一个可读取的StatusCode变量。404则重点核对路径是否被删改;返回HTML登录页时,说明拿到的是网页而不是可直接导入的配置,需回到已有订阅记录核对地址。

DNS、Fake-IP与节点域名解析怎么查

DNS问题常见于“客户端显示已连接但网页打不开”“节点域名解析失败”或“开启TUN后部分应用失效”。先不要随意替换所有DNS字段,按下面顺序检查:

  1. 在日志中区分网页域名解析失败,还是节点服务器域名解析失败。
  2. 查看当前配置是否启用DNS,以及enhanced-mode是fake-ip还是redir-host。官方文档说明这两种模式的行为不同,Fake-IP还涉及Fake-IP地址范围和过滤列表。Mihomo DNS与Fake-IP配置说明
  3. 如果只有节点域名失败,检查proxy-server-nameserver相关设置;如果普通网页域名失败,再检查nameserver、规则和上游可达性。
  4. 清理缓存后只复测一个目标。Controller配置了密钥时,清理接口必须使用POST。

curl.exe:curl.exe -X POST -H "Authorization: Bearer $secret" "$base/cache/dns/flush"

PowerShell 7.x:Invoke-RestMethod -Method Post -Uri "$base/cache/dns/flush" -Headers @{Authorization="Bearer $secret"}

PowerShell 5.1:Invoke-RestMethod -Method Post -Uri "$base/cache/dns/flush" -Headers @{Authorization="Bearer $secret"}

如需清理Fake-IP缓存,将路径替换为/cache/fakeip/flush。正常结果通常是HTTP 204或客户端日志显示请求成功;异常结果是401、404或连接失败,分别回到密钥、接口地址和内核运行状态检查。不要把某个固定DNS地址当作所有网络环境的通用答案,示例中的上游DNS应以你的网络、客户端和实际配置为准。

TUN启动失败或开启后断网:只检查相关层

关闭TUN后普通代理正常,才需要继续检查TUN。Mihomo官方TUN文档提到,auto-route负责自动设置全局路由,auto-detect-interface用于探测出站网卡;Windows上的DNS劫持还涉及strict-route等条件。Mihomo TUN配置说明

  1. 权限:退出客户端后以正常方式重新启动,并按客户端提示授予虚拟网卡或网络扩展权限。具体菜单和权限名称因客户端、系统版本而异,无法核实的入口不要照搬其他客户端。
  2. 网卡:如果设备同时使用Wi-Fi、网线、虚拟机或其他网卡,检查自动探测到的出站接口是否正确。必要时记录当前活动网卡名称,再按客户端支持的字段设置。
  3. 路由:开启TUN后如果所有网络都断开,先关闭TUN恢复基线,再检查自动路由、严格路由和防火墙,不要在断网状态下连续修改多个字段。
  4. DNS劫持:只在日志明确出现DNS拦截、Fake-IP或53端口相关错误时处理,不要因为网页打不开就直接增加多个DNS劫持项。
  5. 防火墙:Windows检查安全软件或防火墙是否拦截虚拟网卡和内核进程;macOS检查系统网络扩展或防火墙提示;Android则以VPN权限和系统电池限制为重点。

正常判据是:开启TUN后普通网页可以访问,连接记录能看到应用请求,流量计数会随请求变化;异常判据是:TUN启动即报错、系统默认路由消失、所有应用断网或只有TUN模式失败。此时先回到关闭TUN的基线,不要把普通代理和TUN问题混为一谈。

连接成功后的验证清单与实时日志

“客户端显示已连接”不等于应用流量已经走通。至少完成以下三项验证:

  • IP或出口验证:访问一个你平时用于查看网络出口的页面,确认结果发生变化;不要只看客户端的“已连接”状态。
  • 连接记录验证:打开客户端的连接、请求或日志页面,确认目标应用产生了请求,并看到实际命中的策略组或节点。
  • 流量验证:打开Controller的/traffic或客户端流量面板,在产生请求时观察上传、下载或累计流量是否变化。官方API文档列出了up、down、upTotal和downTotal字段,但具体展示方式取决于客户端面板。Mihomo流量API说明

需要实时读取Controller日志时使用curl.exe -N关闭缓冲,不要用会等待请求结束的普通网页请求方式。

curl.exe -N -H "Authorization: Bearer $secret" "$base/logs?level=debug"

如果客户端自带日志页,优先使用日志页;复制日志时只保留时间、错误关键词、客户端和系统版本,遮盖订阅地址、密钥、节点域名、用户名和密码。停止修改的条件是:普通代理和TUN都失败、订阅内容无法确认来源、配置字段持续报错,或日志涉及证书、系统网络扩展和防火墙。此时保留脱敏日志和复现步骤,比继续盲改配置更安全。

不同平台的最小差异

  • Windows:优先确认系统代理、端口占用、TUN虚拟网卡、防火墙和PowerShell命令环境;测试HTTP接口时显式使用curl.exe,避免与PowerShell 5.1的curl别名混淆。
  • macOS:重点检查网络扩展、系统代理、活动网卡和防火墙提示;具体客户端菜单名称需以当前版本为准。
  • Android:重点检查VPN权限、电池优化、系统是否同时运行其他VPN,以及应用是否被排除在VPN之外;如果只有某个App失败,要结合该App的连接记录判断。

Mihomo官方发布页的文件名会区分操作系统和CPU架构;升级或更换内核前,先在客户端、Controller或发布页核对当前版本,不要根据文章日期猜测“最新版本”。Mihomo官方发布页

常见问题

为什么Mihomo显示已连接,但浏览器仍然打不开?

先确认浏览器是否使用系统代理,再查看连接记录是否产生请求。如果没有请求,检查系统代理或TUN接管;如果有请求但命中DIRECT或REJECT,检查规则和代理组;如果请求出现no such host或TLS handshake failed,分别回到DNS和TLS日志分支。

订阅返回401、403或404,是Mihomo坏了吗?

不一定。401和403通常表示请求未通过服务端校验,404表示路径或资源不存在;先依据已有订阅记录、订单邮件或旧公告核对地址。用PowerShell 5.1测试时必须使用try/catch读取异常响应,不能只读取正常返回对象的状态码。

为什么只有一个节点连接失败,其他节点正常?

优先把它视为单节点问题:确认其他节点可以连接,再检查该节点的域名解析、端口、TLS和传输参数。不要因为单个节点失败就直接判断整个订阅或客户端不可用。

开启TUN后断网,应该先改DNS还是先改路由?

先关闭TUN恢复网络基线,再检查权限、自动路由、出站网卡、防火墙和DNS劫持日志。只有日志明确指向DNS时才改DNS;每次只改一个变量并复测。

什么时候应该停止自己排查?

当普通代理和TUN都失败、订阅来源无法确认、配置字段持续报错,或日志包含密钥和隐私信息时,应停止继续公开粘贴配置,保留脱敏日志、系统版本、客户端版本、复现时间和已尝试步骤。

参考资料与站内延伸阅读

本文核对日期:2026年11月16日。本文为第三方使用指南,不是任何客户端或节点服务的官方页面。

常见问题

为什么Mihomo显示已连接,但浏览器仍然打不开?

先确认浏览器是否使用系统代理,再查看连接记录是否产生请求。没有请求时检查系统代理或TUN接管;有请求但命中DIRECT或REJECT时检查规则和代理组;出现no such host或TLS handshake failed时分别检查DNS和TLS日志。

订阅返回401、403或404,是Mihomo坏了吗?

不一定。401和403通常与请求校验有关,404通常与路径或资源不存在有关。先依据已有订阅记录、订单邮件或旧公告核对地址;PowerShell 5.1测试时使用try/catch读取异常响应状态。

为什么只有一个节点连接失败?

先确认其他节点可以连接,再检查该节点的域名解析、端口、TLS和传输参数。单个节点失败不能直接证明整个订阅或客户端不可用。

开启TUN后断网,先改DNS还是先改路由?

先关闭TUN恢复网络基线,再检查权限、自动路由、出站网卡、防火墙和DNS劫持日志。只有日志明确指向DNS时才修改DNS,并且每次只改一个变量。

什么时候应该停止自己排查?

当普通代理和TUN都失败、订阅来源无法确认、配置字段持续报错,或日志包含密钥和隐私信息时,应保留脱敏日志、版本、复现时间和已尝试步骤,不要继续公开粘贴完整配置。

相关阅读

参考资料

  1. Mihomo API文档:Controller、日志、流量与缓存接口
  2. Mihomo TUN配置文档
  3. Mihomo DNS配置文档
  4. Mihomo路由规则文档
  5. Mihomo全局配置与日志等级说明
  6. Mihomo官方发布页
  7. Microsoft Learn:Windows中的curl