Mihomo TUN模式连不上怎么办?按故障阶段排查
简答:先关闭 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步最短修复路径:先恢复,再定位
- 备份配置。复制当前配置文件或导出配置,保留客户端版本、Mihomo 核心版本、操作系统和完整错误日志。不要公开订阅地址、密码、UUID、私钥或完整节点参数。
- 关闭 TUN 做对照。使用 Mixed、HTTP 或 SOCKS 代理测试同一节点。若普通代理也失败,先处理订阅、节点或基础网络问题;若普通代理正常,继续下一步。
- 只保留一个隧道。退出其他 VPN、WireGuard、虚拟网卡工具和可能接管 DNS 的软件,然后重新启动 Mihomo。仍无法启动时,检查系统是否弹出管理员、root 或网络扩展授权。
- 恢复为最小 TUN 配置。先保留
enable、stack、auto-route、auto-detect-interface和必要的dns-hijack,暂时移除复杂的 include/exclude、IPv6 路由和自定义 MTU。官方文档列出了这些字段及其作用,不建议把大量默认值和经验参数一次性堆入配置:Mihomo TUN 配置文档。 - 按日志验证。修复后必须分别验证 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、私钥和完整节点参数可能包含敏感信息。分享问题时应使用脱敏后的最小配置,并删除账号、密钥和服务器认证字段。