Mihomo TUN 模式断网怎么解决?先恢复网络再按症状排查
简答:Mihomo TUN 模式开启后断网,先关闭 TUN、恢复系统代理并退出核心,确认普通网络恢复;再单独测试 HTTP、SOCKS 或 Mixed 代理端口。只有代理端口正常而 TUN 断网时,才继续检查权限、虚拟网卡、auto-route、出口网卡、DNS 劫持和其他 VPN 冲突。每次只改一个配置项,并保留回滚副本。
定义:Mihomo TUN 模式是通过虚拟网卡和路由规则接管系统流量的工作方式,开启后断网可能涉及权限、路由、DNS、虚拟网卡或其他网络软件冲突,单凭一个现象不能直接确定根因。
先试这一步:30秒恢复网络并缩小故障范围
本文面向 Windows、macOS 和 Linux 上使用 Mihomo 内核的桌面客户端或命令行环境,重点处理“开启 TUN 后断网、域名打不开、局域网失效”等问题。客户端菜单、配置路径、内置 Mihomo 版本和权限模型可能不同,以下步骤应以当前客户端显示的核心版本、实际加载配置和启动日志为准。本文不覆盖订阅购买、节点评分或线路质量承诺。
本文核验日期为 2026-10-31。Mihomo 官方 TUN 文档目前列出 system、gvisor、mixed、mips 等协议栈,但客户端是否支持、默认值和实际行为仍应以当前内核文档及配置校验结果为准,不要仅凭其他教程覆盖整份 YAML。可先查看Mihomo 官方 TUN 配置文档。
五步速查卡
- 关闭 TUN,并关闭客户端的系统代理开关。
- 完全退出客户端和后台 Mihomo 核心,确认核心进程已经停止。
- 恢复企业代理、PAC、静态 DNS、固定 IP、VLAN 或其他 VPN 原值。
- 确认普通网络恢复后,只测试 HTTP、SOCKS 或 Mixed 代理端口。
- 只有代理端口正常而 TUN 仍断网时,才检查 TUN 权限、虚拟网卡、路由和 DNS。
操作底线:修改前截图或备份配置;不要直接清空全部系统路由;不要同时修改 DNS、MTU、IPv6、协议栈和节点;每次只改变一个变量并记录结果。
| 现象 | 优先排查方向 | 先做什么 | 说明 |
|---|---|---|---|
| 关闭 TUN 后代理端口也不能用 | 配置、节点、核心进程或端口 | 查看启动日志并执行配置校验 | 先排除代理本身问题,不要继续改 TUN。 |
| 能访问 IP,域名打不开 | DNS、dns-mode、dns-hijack或浏览器 DoH | 分别测试 IP 连通和域名解析 | 这是 DNS 的优先排查方向,不等于已经确定根因。 |
| 公网和局域网全部不通 | 权限、虚拟网卡、auto-route或出口网卡 | 查看网卡状态、默认网关和路由表 | 也可能受到防火墙、其他 VPN 或出口不可用影响。 |
| 公网正常,但 NAS、虚拟机或企业内网打不开 | strict-route、局域网排除项或其他虚拟网卡 | 先测试局域网网关,再对照 strict-route | 不要直接删除全部系统路由。 |
| 只有 UDP 或某个应用失败 | 协议栈、MTU、应用代理方式或节点协议 | 使用同一节点对照 TCP 与 UDP | 单个应用失败不代表整个 TUN 都失效。 |
先区分:是代理端口故障,还是 TUN 层故障
关闭 TUN 后,优先使用当前配置中已有的 HTTP、SOCKS 或 Mixed 端口测试。端口名称和端口号以实际配置为准,不要直接套用其他教程中的数字。可以先在浏览器中指定该端口访问一个已知可用页面,再用命令行测试本机端口是否监听。
如果代理端口本身无法使用,检查配置是否成功加载、节点是否可用、核心是否启动、端口是否被其他程序占用。Mihomo 官方入站配置文档将 HTTP、SOCKS、Mixed 端口与 TUN 分开说明;因此,代理端口能用而 TUN 不能用时,故障范围才较集中在 TUN 的路由、DNS、权限和虚拟网卡层。相关字段可查看Mihomo 官方入站配置文档。
如果企业网络使用 PAC、静态 DNS、固定 IP、VLAN 或企业 VPN,关闭系统代理前先截图或导出原值。普通用户可以暂时关闭这些设置用于恢复测试,但恢复办公网络时要按原值还原,不能把“关闭系统代理”当作永久修复。
配置校验与权限检查:先确认你改的是生效配置
先保存当前配置副本,并记录客户端名称、Mihomo 核心版本、配置文件路径、TUN开关状态和最近一次启动日志。若客户端提供“校验配置”“测试配置”或“检查 YAML”功能,优先使用该功能。
原生 Mihomo 当前代码中的命令参数包含 -t,用于测试配置并退出。可按当前版本帮助信息确认参数后执行:
mihomo -t -f /实际配置路径/config.yaml
其中路径必须替换为本机真实文件路径。配置测试通过,只能说明文件和字段基本能够解析,不代表节点、DNS、路由或 TUN 一定能正常工作。相关参数可查看Mihomo 官方仓库 main.go 命令参数。
如果日志出现 permission denied、无法创建 TUN、无法打开设备或核心立即退出,先处理权限和虚拟网卡。Windows 可能需要客户端管理员授权、Service Mode 或允许核心程序通过防火墙;macOS 可能需要允许客户端使用系统级网络组件;Linux 可能需要对应的 root、Polkit、网络管理权限或访问 /dev/net/tun。这些要求取决于客户端封装、系统版本和运行方式,不能概括为所有 Mihomo 安装方式的统一要求。
同时暂时退出其他 VPN、网络加速器、虚拟机网络、容器网络和抓包工具,再复测一次。如果故障消失,说明多个程序可能同时修改默认路由、DNS 或虚拟网卡;应逐个重新启用,而不是一次性全部打开。
Windows:关闭 TUN 后按网关、IP、DNS、代理端口测试
确认 TUN 和系统代理已关闭、核心已退出后,打开 PowerShell 或命令提示符,按以下顺序收集信息:
- 查看网卡、默认网关和 DNS:
ipconfig /all。 - 查看默认路由:
route print。 - 测试域名解析:
nslookup example.com。 - 测试指定 TCP 端口:
Test-NetConnection example.com -Port 443。 - 确认代理端口是否监听:
Test-NetConnection 127.0.0.1 -Port 端口号。
ipconfig /all用于查看地址、网关和 DNS,route print用于查看路由表;Microsoft 文档说明,nslookup可进行 DNS 查询,Test-NetConnection可输出 DNS、接口、路由选择和 TCP 连接结果。对应资料见Microsoft ipconfig 文档、Microsoft route 文档、Microsoft nslookup 文档和Microsoft Test-NetConnection 文档。
若 DNS 缓存可能残留,可在确认 TUN 已关闭并且系统代理已恢复后执行:
ipconfig /flushdns
不要直接执行清空全部路由的命令,也不要在没有备份静态 IP、DNS、企业 VPN、虚拟网卡和固定路由时执行 Windows 网络重置。网络重置应当是最后手段,并且可能改变企业网络环境。
macOS:检查 DHCP、DNS、系统解析和代理端口
关闭 TUN、系统代理和后台核心后,先在“系统设置→网络”中选择当前 Wi-Fi 或有线网络,进入“详细信息”。Apple 的网络设置文档中,TCP/IP 页面可查看或续租 DHCP,DNS 页面可查看当前 DNS 服务器。
- 先确认当前网络接口仍有 IP 地址和默认网关。
- 在 TCP/IP 页面尝试“续租 DHCP 租约”,但固定 IP 或企业网络用户应先记录原值。
- 在 DNS 页面检查是否残留客户端或 VPN 写入的 DNS。
- 使用
scutil --dns查看系统解析器状态。 - 使用
dig example.com测试域名解析。 - 确认客户端的 HTTP、SOCKS 或 Mixed 端口能够单独工作后,再恢复 TUN。
Apple 的 DHCP 和 DNS 设置说明分别见Apple 续租 DHCP 地址说明和Apple 更改 Mac DNS 设置说明。若系统使用企业 DNS 或 VPN DNS,不要把公共 DNS 直接覆盖为长期配置,应先记录原值并确认管理员要求。
Linux:固定为路由、网关、DNS和代理端口四层测试
Linux 命令随发行版和网络管理方式不同。若系统使用 iproute2 与 systemd-resolved,可在关闭 TUN 后依次执行:
- 查看地址和网卡:
ip addr。 - 查看默认路由和网关:
ip route。 - 查看 DNS 状态:
resolvectl status。 - 测试域名解析:
resolvectl query example.com。 - 测试代理端口:
curl -I -x http://127.0.0.1:端口号 https://example.com。
resolvectl status用于查看 DNS 配置,resolvectl query用于通过 systemd-resolved 查询域名;相关命令说明见freedesktop.org resolvectl 文档。如果系统没有 systemd-resolved,使用发行版自带的 NetworkManager、systemd-networkd 或其他网络管理工具,不要强行照搬上述命令。
如果 ip route 显示默认路由指向已停止的 TUN 或不存在的接口,先关闭 TUN、停止核心并重新检查网络管理服务。不要直接删除全部路由;应先记录默认网关、企业路由和虚拟网络配置。
按症状调整 TUN:路由、DNS、strict-route与协议栈
确认普通代理端口可用、配置校验通过、系统基础网络正常后,再恢复 TUN。优先保留现有的 auto-route、auto-detect-interface 和 DNS 配置,只检查是否加载成功。Mihomo 官方文档说明,auto-route用于自动设置全局路由,auto-detect-interface用于自动识别出口网卡;多网卡同时连接时,才需要进一步核对出口接口或手动指定。
如果所有流量都断,优先查看 TUN 网卡是否建立、核心是否有权限、默认路由是否被改到正确出口,以及其他 VPN 是否抢占路由。若只有域名失败,优先检查 dns-mode、dns-hijack、顶层 dns.enable、DNS 的 enhanced-mode、系统 DNS 和浏览器 DoH。Mihomo 官方 DNS 文档将 fake-ip 与 redir-host列为增强模式取值,不能把旧教程中的字段直接视为当前版本必然支持。
官方 TUN 文档列出 dns-mode 的 disabled、native、hijack取值,并说明 hijack在 Windows 需要 strict-route、在 Linux 需要 auto-redirect 才能配合相关行为。文档还说明,Windows 和 macOS 不能自动劫持发往本地网络的 DNS 请求;这是当前文档列出的平台限制,不应扩大理解为所有网络环境的绝对结论。详细字段见Mihomo TUN 文档和Mihomo DNS 文档。
如果公网正常但局域网、NAS或虚拟机失效,单独对照 strict-route 和局域网排除项。官方文档提示,Windows 下严格路由会增加用于阻止 DNS 泄漏的防火墙规则,并可能在特定场景影响 VirtualBox 等应用;这不是所有系统和客户端都会出现的必然结果。
协议栈只用于对照测试。官方文档当前列出 system、gvisor、mixed、mips,并给出不同栈的行为说明;但客户端是否支持、默认值和防火墙表现应以当前内核版本、配置校验和启动日志为准。不要为了“优化”盲改协议栈。正确做法是备份配置、只改 stack、重启核心,然后分别测试公网、DNS、局域网和 UDP,失败就恢复原值。
MTU、IPv6 和 UDP 也应采用同样方式。一次只改一个变量,并记录修改前后的普通代理、TUN、公网、DNS、局域网和应用结果。一次成功不能证明某个字段就是唯一根因。
验证与回滚:确认配置真的生效,而不是只看浏览器
每次复测固定分为三层:第一层是本地网络和默认网关;第二层是域名解析;第三层是应用流量。Windows 可分别使用 Test-NetConnection、nslookup 和浏览器或办公软件测试;macOS 可使用 scutil --dns、dig 和应用测试;Linux 可使用 ip route、resolvectl query 和 curl -x 测试。这样能避免把“浏览器打不开”直接等同于路由或节点故障。
建议记录:操作系统、客户端名称和版本、Mihomo 核心版本、实际加载的配置文件、修改字段、修改前值、修改后值、是否重启核心、代理端口结果、TUN 公网结果、DNS结果、局域网结果和应用结果。若要记录成功率,使用“成功测试次数÷总测试次数×100%”,并写明测试时间、节点、协议和是否经过代理;单次 ping 不足以代表稳定性或线路质量。
回滚顺序是:关闭 TUN→关闭系统代理→停止核心→恢复配置备份→重新启动客户端→检查默认路由和 DNS→再测试普通网络。如果仍然无法联网,恢复 DHCP、DNS、PAC、固定 IP、企业 VPN 和原有路由设置。若日志没有出现 permission、route 或 DNS 关键词,先确认客户端实际加载的配置文件和核心版本,避免排查未生效的文件。
如果问题仍未解决,保留操作系统版本、客户端版本、核心版本、TUN 实际字段、关闭 TUN 后的代理端口结果、启动日志中的首个错误,以及正在运行的 VPN 或虚拟网卡信息。不要公开订阅链接、密钥或账号信息。
常见问题
Mihomo TUN 的 stack 应该填什么?
不能脱离版本直接指定。Mihomo 当前官方 TUN 文档列出 system、gvisor、mixed、mips,并说明不同协议栈的行为;但客户端是否支持、默认值和防火墙限制可能不同。先查看核心版本、配置校验和启动日志;如果当前配置能够工作,不要为了优化盲改。需要对照时一次只改一个值,并保留原配置。
为什么能 ping IP,但浏览器打不开域名?
这说明 DNS 路径值得优先检查,但不能仅凭该现象确定根因。分别测试域名解析、系统 DNS、Mihomo DNS、dns-mode、dns-hijack、Fake-IP 和浏览器 DoH;如果 DNS 查询正常但应用仍失败,还要检查应用自身代理设置和防火墙。
strict-route 导致局域网或虚拟机失效怎么办?
先关闭 TUN,确认局域网网关、NAS或虚拟机网络本身正常,再只对照 strict-route 和局域网排除项。Mihomo 官方文档提示,Windows 下严格路由可能在特定场景影响 VirtualBox 等应用。不要直接删除全部系统路由,也不要同时修改 MTU 和 DNS。
没有看到 permission、route 或 DNS 报错时查什么?
先确认客户端实际加载的配置文件、核心版本和 TUN 网卡状态,再查看默认路由、DNS状态和其他 VPN、虚拟机或容器网卡。前端没有显示关键词,不代表配置一定正确,也可能只是没有展示核心完整日志。
关闭 TUN 后仍然断网,可以直接重置系统网络吗?
不建议直接重置。先恢复原来的 PAC、静态 IP、DNS、企业 VPN、默认网关和路由设置,再检查网卡是否获得有效地址。Windows 网络重置可能影响静态 IP、DNS、VPN、虚拟网卡和企业网络配置,应当作为最后手段,并提前备份。
常见问题
Mihomo TUN 的 stack 应该填什么?
以当前 Mihomo 核心版本、官方 TUN 文档、配置校验和启动日志为准。官方文档当前列出 system、gvisor、mixed、mips,但客户端是否支持及默认值可能不同,不要盲目覆盖已有配置。
为什么能 ping IP,但浏览器打不开域名?
优先检查 DNS 路径,包括 dns-mode、dns-hijack、Mihomo DNS、系统 DNS、Fake-IP和浏览器 DoH,但应通过 nslookup、dig或resolvectl query进一步确认。
strict-route 导致局域网打不开怎么办?
先关闭 TUN 验证局域网网关和目标设备正常,再单独对照 strict-route和局域网排除项。不要直接删除全部系统路由。
没有明显日志报错时怎么排查?
确认客户端实际加载的配置文件、Mihomo核心版本、TUN网卡和默认路由,再检查DNS状态及其他VPN、虚拟机或容器网卡。
关闭 TUN 后仍然断网,能直接重置系统网络吗?
不建议直接重置。先备份并恢复PAC、静态IP、DNS、企业VPN和路由配置;破坏性网络重置应作为最后手段。