Mihomo连接失败怎么解决?按日志、节点、DNS和TUN逐步恢复
简答:Mihomo连接失败,最快的处理顺序是:先关闭TUN并退出其他代理或VPN,确认普通网络恢复;再检查内核是否启动、配置是否加载、订阅是否返回有效内容,最后根据日志区分节点、DNS、规则和系统代理问题。Windows可用curl.exe验证Controller和订阅,macOS、Android则优先查看客户端日志与连接记录。
定义:Mihomo连接失败,是指内核未启动、配置未加载、节点无法建立连接,或流量没有经过正确的代理端口、DNS和TUN路径。
先做这一步:关闭TUN和代理冲突,建立网络基线
如果你看到“连接失败”、网页全部打不开、TUN启动失败或开启客户端后系统断网,不要先连续修改DNS、规则和节点参数。先把故障缩小到“客户端本身”还是“系统网络接入”两层。
- 关闭TUN:在当前客户端的设置或网络模式页面关闭TUN、虚拟网卡或增强模式。不同图形客户端菜单名称可能不同,无法核实具体入口时,以当前客户端界面为准。
- 关闭系统代理:关闭客户端的系统代理开关,并检查系统代理设置中是否仍保留HTTP或SOCKS代理地址。
- 退出其他网络工具:暂时退出其他VPN、代理客户端、网络过滤器和虚拟网卡工具,避免多个程序争抢端口或默认路由。
- 确认普通网络:直接打开一个平时可访问的网站,或在终端执行
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 failed | TLS协商、时间、证书或节点参数异常 | 校准系统时间,核对节点的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字段,按下面顺序检查:
- 在日志中区分网页域名解析失败,还是节点服务器域名解析失败。
- 查看当前配置是否启用DNS,以及
enhanced-mode是fake-ip还是redir-host。官方文档说明这两种模式的行为不同,Fake-IP还涉及Fake-IP地址范围和过滤列表。Mihomo DNS与Fake-IP配置说明 - 如果只有节点域名失败,检查
proxy-server-nameserver相关设置;如果普通网页域名失败,再检查nameserver、规则和上游可达性。 - 清理缓存后只复测一个目标。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配置说明
- 权限:退出客户端后以正常方式重新启动,并按客户端提示授予虚拟网卡或网络扩展权限。具体菜单和权限名称因客户端、系统版本而异,无法核实的入口不要照搬其他客户端。
- 网卡:如果设备同时使用Wi-Fi、网线、虚拟机或其他网卡,检查自动探测到的出站接口是否正确。必要时记录当前活动网卡名称,再按客户端支持的字段设置。
- 路由:开启TUN后如果所有网络都断开,先关闭TUN恢复基线,再检查自动路由、严格路由和防火墙,不要在断网状态下连续修改多个字段。
- DNS劫持:只在日志明确出现DNS拦截、Fake-IP或53端口相关错误时处理,不要因为网页打不开就直接增加多个DNS劫持项。
- 防火墙: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 API文档:Controller、日志、流量与缓存接口
- Mihomo TUN配置文档
- Mihomo DNS配置文档
- Mihomo路由规则文档
- Microsoft Learn:Windows中的curl
- Clash Verge系统代理失败的排查方法
- 节点速度慢时的延迟、丢包与连接排查
- 订阅链接导入失败时的地址与格式核验
常见问题
为什么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都失败、订阅来源无法确认、配置字段持续报错,或日志包含密钥和隐私信息时,应保留脱敏日志、版本、复现时间和已尝试步骤,不要继续公开粘贴完整配置。