闪连VPN | LightningX VPN: 安装返现返回首页

Mihomo TUN模式连不上怎么办?按故障阶段排查

更新于 2026-10-31 · shanlian.shop

简答:先关闭 TUN,用 Mixed、HTTP 或 SOCKS 代理确认节点和订阅是否正常;普通代理正常而 TUN 失败,优先检查管理员权限、虚拟网卡、auto-route、DNS 劫持和其他 VPN 冲突,不要先换节点或同时修改多项配置。

定义:Mihomo 的 TUN 模式会创建虚拟网卡并接管系统流量,因此“无法启动”“启动后断网”“只有域名打不开”和“只有某个应用失败”需要分开处理。

先看这张分流表:你属于哪一种故障

本文是第三方使用指南,不代表任何客户端或服务品牌的官方说明。先把 TUN 关闭,再开启系统代理或手动使用 Mihomo 的 Mixed、HTTP、SOCKS 端口测试同一个节点。这个动作的停止条件是:普通代理已经能打开测试网页,或明确确认普通代理也无法连接。

现象优先怀疑下一步
TUN 开关一打开就报错权限、虚拟网卡、IPv6 配置、内核或防火墙先看完整日志中的第一条 error,再检查管理员/root 权限和 TUN 网卡
TUN 显示启动,但所有网页都打不开自动路由、出口网卡、DNS 劫持、其他 VPN 冲突关闭其他 VPN、WireGuard、Tailscale 类隧道,再暂时关闭 TUN 验证普通代理
IP 能访问,域名打不开DNS、fake-ip、dns-hijack 或 DNS 出站不可达检查 DNS 配置和日志中的解析失败,不要把浏览器缓存当成验证结果
只有一个应用不走代理应用自身代理、分流规则、Android 包名或进程排除先用浏览器和另一个应用复现,再检查规则与 include/exclude 配置
TCP 正常,Hysteria/Hysteria2 或其他 UDP 节点失败UDP、协议栈、MTU、IPv6 或防火墙先用普通 TCP 节点对照,再一次只改一个 TUN 参数

关键边界:“TUN 网卡已出现”只说明设备可能创建成功,不等于路由、DNS和节点连接都正常。

5步最短修复路径:先恢复,再定位

  1. 备份配置。复制当前配置文件或导出配置,保留客户端版本、Mihomo 核心版本、操作系统和完整错误日志。不要公开订阅地址、密码、UUID、私钥或完整节点参数。
  2. 关闭 TUN 做对照。使用 Mixed、HTTP 或 SOCKS 代理测试同一节点。若普通代理也失败,先处理订阅、节点或基础网络问题;若普通代理正常,继续下一步。
  3. 只保留一个隧道。退出其他 VPN、WireGuard、虚拟网卡工具和可能接管 DNS 的软件,然后重新启动 Mihomo。仍无法启动时,检查系统是否弹出管理员、root 或网络扩展授权。
  4. 恢复为最小 TUN 配置。先保留 enable、stack、auto-route、auto-detect-interface 和必要的 dns-hijack,暂时移除复杂的 include/exclude、IPv6 路由和自定义 MTU。官方文档列出了这些字段及其作用,不建议把大量默认值和经验参数一次性堆入配置:Mihomo TUN 配置文档。
  5. 按日志验证。修复后必须分别验证 TUN 是否启动、DNS 是否能解析、浏览器是否能打开网页、目标应用是否走预期路径。单次打开网页不能证明长期稳定,也不能证明所有 UDP 流量可用。

如果改动后出现完全断网,立即关闭 TUN并恢复备份配置;不要在断网状态下连续修改路由、DNS和协议栈。

按日志关键词分流处理

日志关键词或现象含义边界可执行检查
permission denied、Start TUN listening error通常指创建或配置 TUN 接口时权限不足,但不能仅凭这一行断定唯一原因重新以系统要求的权限启动;检查是否完成特权服务、网络扩展或 VPN 权限授权
network is unreachable某条出站路径不可达,可能与默认网卡、路由或上游网络有关关闭 TUN后确认基础网络正常,再检查 auto-detect-interface、默认网卡和其他隧道
dns resolve failed、域名超时解析链路失败,不等于节点一定失效用 IP 与域名分别测试;检查 dns-hijack、fake-ip、DNS 出站和 IPv6 解析结果
timeout连接在规定时间内没有完成,可能是节点、路由、协议或 MTU 问题用普通代理测试同节点,再换一个已知协议的节点做对照;每次只改变一个变量
Mixed/HTTP/SOCKS 正常,TUN 不正常更接近 TUN 接管链路的问题,而不是订阅本身优先查权限、虚拟网卡、auto-route、DNS 劫持和系统冲突

官方 TUN 文档说明,stack 可使用 system、gvisor、mixed 或 mips;文档还特别提示,启用防火墙时不同协议栈可能需要放行 Mihomo 内核。因此,协议栈和防火墙应作为单独变量测试,而不是与 DNS、路由、MTU 一起修改:TUN 字段与协议栈说明。

Windows、macOS、Linux、Android分别怎么查

Windows

  • 确认客户端已获得管理员权限,系统网络适配器中能看到对应的 TUN/Wintun 类虚拟网卡。
  • 在 Windows 防火墙中检查 Mihomo 内核是否被阻止。官方文档明确提到,Windows 防火墙可能影响 system 和 mixed 协议栈。
  • 关闭其他 VPN 和虚拟网卡后重启客户端;如果普通代理正常、TUN仍失败,再查看 auto-detect-interface 是否选中了当前实际联网的网卡。

macOS

  • 检查系统是否弹出网络扩展或 VPN 授权,并确认没有停留在未完成授权状态。
  • 如果更换 Wi-Fi、网线或热点后出现问题,重新关闭再开启 TUN,让客户端重新识别出口接口。
  • 仍然失败时,用普通代理验证节点,再检查 DNS 和 MTU,不要直接删除系统网络配置。

Linux

  • 确认运行 Mihomo 的用户具备创建 TUN 设备和调整路由所需的权限;容器环境还要单独检查设备和网络能力。
  • 查看系统是否已经存在同名 TUN 设备、重复路由或其他隧道服务。
  • 先使用较简单的协议栈和自动路由配置复现,再逐项恢复自定义规则。

Android

  • Android 的 TUN 通常受系统 VPN 权限管理,先确认系统弹窗授权已完成,并关闭其他 VPN 应用。
  • 若日志出现 TUN 配置权限错误,同时配置了 IPv6 或 TUN IPv6 地址,先记录原配置,再暂时关闭 IPv6 相关项进行对照。Mihomo 的公开 issue 中有 Android 15、IPv6 与 permission denied 同时出现的复现记录,但该 issue 不能证明所有设备都由同一原因导致:Mihomo IPv6/TUN issue #1667。
  • 若只有某个应用失败,检查应用是否被 TUN 的 include/exclude package 规则排除。

DNS、IPv6、MTU和UDP:最后再处理边界情况

DNS:如果网页显示“无法解析域名”,先区分“DNS失败”和“节点连接失败”。Mihomo TUN 文档列出了 dns-mode、dns-hijack 等字段;建议先使用配置中已经验证过的 DNS 出站,不要一次添加多组公共 DNS。验证结果应包括:域名能解析、网页能打开、日志不再出现解析失败。

IPv6:如果系统或网络没有可用 IPv6,而配置又要求创建 TUN IPv6 地址,可能出现权限或接口配置错误。公开 issue #1667 记录了这一类 Android 复现,但它是单个问题报告,不能直接推导为通用故障结论。可先备份配置,暂时关闭 IPv6 相关配置进行对照;若恢复正常,再检查系统 IPv6能力和配置是否匹配。

MTU:MTU 过大可能表现为部分网站、UDP 或特定协议失败,但没有统一适用于所有网络的数值。不要照抄其他设备的 MTU;先恢复默认或已知可用值,再用同一节点和同一应用对照验证。

Hysteria/Hysteria2:如果只有这类 UDP 节点在 TUN 下失败,先用普通代理和 TCP 节点做对照。Mihomo 的公开 issue #1222 展示了 Windows 下 TUN、gVisor、DNS、MTU 与 Hysteria/Hysteria2 同时出现的排查场景,但 issue 内容不是对所有版本和系统的通用修复方案:Mihomo Hysteria/Hysteria2 与 TUN issue #1222。

需要办公网络线路诊断时,可在确认基础网络、DNS和路由后,再使用边界云加速的相关服务进行进一步测试;请以实际配置和官方说明为准。

排查完成后的回滚与记录清单

  • 记录日期、操作系统、客户端版本、Mihomo 核心版本和配置变更前后差异。
  • 保留一份能正常工作的最小配置,之后每次只增加一项规则或一个字段。
  • 记录四个结果:TUN 是否创建、DNS 是否解析、网页是否打开、目标应用是否正常。
  • 如果恢复网络仍失败,关闭 TUN、退出客户端并恢复备份;必要时重启系统后再确认系统代理和网络连接。
  • 提交问题或寻求帮助时,提供脱敏后的最小配置和完整日志,不要发布订阅链接、账号密码、UUID、私钥及完整服务器参数。

MetaCubeX 的 Dashboard 项目说明了 Mihomo 面板可查看连接、规则和实时日志;面板或客户端日志适合用来确认状态,但“能看到日志”本身不代表节点或网页已经可用:MetaCubeX Dashboard 项目说明。

常见问题

Mihomo普通代理能用,但TUN模式连不上,应该先换节点吗?

通常不应先换节点。普通代理已经能用时,优先检查权限、TUN虚拟网卡、auto-route、auto-detect-interface、DNS劫持和其他VPN冲突;换节点会改变变量,反而不利于定位。

TUN已经显示启动,为什么网页还是打不开?

TUN启动只说明虚拟接口可能创建成功,不代表路由、DNS和节点出站都正常。请分别验证DNS解析、网页访问和目标应用,并检查日志中是否有network is unreachable、dns resolve failed或timeout。

Mihomo TUN模式一定要开启IPv6吗?

不一定。是否启用IPv6取决于系统、网络和配置是否匹配。若启用IPv6后出现TUN接口权限或配置错误,先备份配置,再暂时关闭IPv6相关项做对照,不要据此断定所有设备都存在同一问题。

MTU应该设置成多少才不会断网?

没有适用于所有系统、线路和协议的统一数值。建议先恢复默认或已知可用值,再用同一个节点、同一个应用和同一网络对照验证;不要只凭一次网页访问判断MTU已经正确。

排查时可以把完整配置和订阅链接发到群里吗?

不建议。订阅链接、密码、UUID、私钥和完整节点参数可能包含敏感信息。分享问题时应使用脱敏后的最小配置,并删除账号、密钥和服务器认证字段。

相关阅读

参考资料

  1. 虚空终端 Docs:Mihomo TUN 配置、协议栈与路由字段
  2. MetaCubeX/metacubexd:Mihomo Dashboard 项目说明
  3. MetaCubeX/mihomo Issue #1667:IPv6与TUN接口权限错误复现
  4. MetaCubeX/mihomo Issue #1222:TUN下Hysteria/Hysteria2连接问题