Mihomo Party TUN模式怎么开?开启、验证与故障排查
简答:Mihomo Party 开启 TUN 的最短路径是:先确认配置和节点正常,再在左侧找到“TUN”或“TUN模式”开关,按系统提示授予权限,最后通过日志、虚拟网卡和实际应用连接复测。TUN 负责接管系统流量,不等于全局模式;最终走代理、直连还是拒绝,仍由规则和代理模式决定。
定义:TUN 模式是一种通过虚拟网卡接管系统 IP 流量的工作方式,通常比系统代理覆盖更多应用,但需要路由、DNS、虚拟接口和系统权限配合。
先试这一步:确认配置正常,再打开 TUN
本文是 MistyCloud 的第三方使用指南,不代表 Mihomo Party 官方。核验日期为 2026-11-03;客户端菜单、权限提示和可用选项可能随客户端版本、操作系统和语言变化,遇到界面差异时应以当前客户端显示为准。
- 打开 Mihomo Party,确认已经导入配置并选中一个配置文件。
- 确认内核已经启动,配置页面能够看到代理组、节点或规则信息,日志中没有持续出现启动错误。
- 先不要打开 TUN,使用系统代理测试一次浏览器或其他支持代理的应用,排除配置、节点和订阅本身不可用。
- 退出其他 VPN、游戏加速器、网络过滤器和同类代理客户端,避免多个虚拟网卡同时修改路由。
- 记录开启前状态:是否能正常上网、是否能访问局域网设备、系统代理是否已开启。
预期结果:打开 TUN 前,至少应确认配置已启用、内核没有持续报错,并且节点或直连规则能够正常工作。若配置本身不可用,直接开启 TUN 往往会让问题更难定位。
最快判断:如果你只是想让浏览器使用代理,先使用系统代理;如果目标应用不读取系统代理,再考虑 TUN。Mihomo 文档将 TUN 描述为用于接管系统流量、自动路由、DNS 劫持和按应用路由的入口,普通配置优先使用顶层 TUN 配置,而不是高级 TUN Listener。可参考 Mihomo 入站配置文档。
Windows:找到 TUN 开关并完成权限授权
- 启动 Mihomo Party。首次创建虚拟网卡、修改路由或安装相关服务时,如果 Windows 弹出用户账户控制提示,先阅读提示内容,再按需要允许。
- 在左侧边栏查找“TUN”“TUN模式”或带有虚拟网卡含义的开关。不同版本可能将入口放在设置、网络或侧边栏卡片中,菜单文字不一定完全一致。
- 打开 TUN 开关。若客户端提示安装服务、创建虚拟网卡、重新以管理员权限运行或授权网络组件,按当前弹窗完成操作。
- 第一次测试时保持协议栈、自动路由、自动检测网络接口和 DNS 相关选项的默认值,不要一开始同时修改 DNS、MTU、严格路由和网络栈。
- 等待状态显示为已启用、运行中或类似状态,再关闭系统代理,测试一个通常不读取系统代理的桌面应用。
Windows 下,Mihomo 的 TUN 文档说明,auto-route 用于自动设置全局路由;DNS 劫持模式与严格路由存在配合关系,不能把某一版本的默认值当成所有客户端版本都一致。首次排查时应优先使用客户端界面提供的默认设置,不要直接复制网络上的完整 YAML。可查看 Mihomo TUN 配置文档。
预期结果:TUN 开启后,客户端状态保持运行,日志不持续出现权限、虚拟接口创建或路由错误;关闭系统代理后,至少有一个原本不支持手动代理设置的应用能够产生连接记录。
macOS:完成系统授权后再验证 utun 接口
- 打开 Mihomo Party,先确认配置已经启用,节点或规则模式可以正常工作。
- 在侧边栏查找并打开“TUN”或“TUN模式”。首次启用时,系统可能要求输入管理员密码或批准网络相关权限。
- 完成系统授权后,等待客户端刷新网络状态或重新启动内核,不要在授权窗口尚未完成时反复点击开关。
- 观察客户端日志,重点查看权限不足、虚拟网卡创建失败、路由设置失败或 TUN 启动错误。
- 如需进一步确认,可在终端执行演示命令
ifconfig查看是否出现由系统创建的utun接口。该命令只用于观察,不要根据接口编号手工写入配置。
Mihomo 文档说明,macOS 的 TUN 设备名称需要以 utun 开头。接口编号、权限机制和后台组件仍可能因操作系统与客户端版本不同而变化,因此看到接口存在只能说明系统创建了相关接口,不能单独证明所有流量都按预期处理。
如果“开关显示已开但实际不接管流量”,先查看运行时日志和当前配置,不要盲目复制旧版 YAML。Mihomo Party 项目的公开问题记录曾描述特定 macOS 环境下,界面开关启动的运行时 TUN 配置与配置文件内容不一致;这属于特定版本和环境的公开问题记录,不能推断所有设备都会出现同样现象。可查看 Mihomo Party 项目公开问题记录。
Linux:重点检查权限、自动路由和防火墙
- 确认客户端与 CPU 架构匹配,并让 Mihomo Party 正常启动内核。
- 在侧边栏打开 TUN 模式。若桌面环境弹出 PolicyKit、sudo 或其他提权提示,按当前系统提示完成授权。
- 第一次测试保持自动路由为默认值。Linux 下部分透明转发能力还可能涉及防火墙、iptables 或 nftables。
- 使用
ip link或ip route观察虚拟接口和路由变化。命令只用于检查,除非你明确知道回滚方法,否则不要直接手工删除默认路由。 - 如果开启后无法联网,先关闭 TUN 或退出客户端,确认系统网络恢复,再逐项检查防火墙、路由和 DNS。
Mihomo 文档将 auto-redirect 标注为 Linux 专用选项,并说明它依赖 auto-route;因此不要把 Linux 的配置项直接照搬到 Windows 或 macOS。若防火墙拦截 TUN 接口或核心程序,先按系统防火墙界面放行必要程序,再复测,而不是立即调整 MTU 或更换协议栈。
如果你使用的是 Linux 路由器或多网卡设备,Mihomo 文档还提示自动检测出口接口可能需要人工指定。普通桌面用户不必先修改该项,只有在存在多个同时联网的接口且日志显示出口选择错误时,才进入这一层排查。
TUN、系统代理、规则模式和全局模式有什么区别?
| 项目 | 主要作用 | 常见适用场景 | 注意事项 |
|---|---|---|---|
| TUN 模式 | 通过虚拟网卡接管 IP 流量 | 需要覆盖不支持手动代理设置的桌面应用 | 通常需要较高系统权限,并可能影响路由、DNS 和局域网 |
| 系统代理 | 把 HTTP、HTTPS 或 SOCKS 代理写入系统设置 | 浏览器和支持系统代理的应用 | 不保证所有应用都会遵循系统代理 |
| 规则模式 | 按域名、IP、进程或规则决定代理、直连或拒绝 | 日常分流使用 | TUN 开启后仍可能有流量命中 DIRECT |
| 全局模式 | 让匹配到的流量统一使用指定代理组 | 排查规则是否导致连接异常 | 不等于 TUN,也不代表所有系统流量都会被接管 |
关键结论:TUN 决定“流量如何进入客户端”,规则模式或全局模式决定“进入后怎么处理”。看到某个应用仍然直连,不能直接得出 TUN 失效的结论;先查看连接日志中的策略结果,确认是否命中了 DIRECT。
开启后如何确认 TUN 真正生效?
- 看客户端状态:TUN 开关应保持开启,日志中不应持续出现权限、接口创建、路由或 DNS 错误。
- 关闭系统代理再测:不要让系统代理同时提供结果。关闭系统代理后,测试一个通常不读取系统代理的桌面应用。
- 看实际连接日志:确认测试应用或目标域名出现在连接记录中,并查看它最终命中了代理策略、DIRECT 还是拒绝策略。
- 看系统接口:Windows 可使用
ipconfig,Linux 可使用ip link和ip route,macOS 可使用ifconfig观察虚拟接口。命令只用于观察当前状态。 - 做反向测试:关闭 TUN、保留系统代理,再测试同一个应用。对比两种状态,有助于判断问题来自 TUN、系统代理还是配置规则。
不要只用“网页能打开”作为唯一标准:网页可能读取了系统代理,也可能命中了直连规则。更可靠的判断是同时对照客户端日志、系统代理状态、虚拟接口和测试应用的连接结果。
如果配置中启用了自动路由,Mihomo 文档说明它会将全局流量自动路由到 TUN 接口;但是否代理仍由规则和代理模式决定。可参考 Mihomo TUN 参数说明。
常见故障:按现象分流处理
一开 TUN 就全网断开
先关闭 TUN,确认网络恢复,然后检查配置是否已启用、DNS 是否正常、自动路由是否被关闭,以及是否同时运行其他 VPN。Windows 或 macOS 如果日志出现权限不足或虚拟接口创建失败,重新启动客户端并按系统提示授权。若仍然断网,不要继续叠加修改 DNS、MTU 和严格路由,先保存日志并回滚到关闭 TUN。
开关显示已开启,但桌面应用没有变化
先确认该应用是否有自己的代理、VPN 或网络沙箱,再查看连接日志中是否出现该应用的连接记录。若日志完全没有记录,可能是 TUN 未真正创建、路由未生效,或应用使用了特殊网络通道;此时检查虚拟接口和路由比反复切换代理模式更有效。
浏览器能用,但其他应用不能用
浏览器可能正在使用系统代理,而其他应用没有遵循系统代理。关闭系统代理后再测试其他应用,观察是否产生 TUN 连接日志。如果仍无记录,检查 TUN 权限、路由和防火墙;不要先把问题归因于节点速度。
开启后局域网设备无法访问
检查规则是否把局域网地址送入代理,并确认客户端是否提供局域网排除或路由排除选项。Mihomo 文档提供了路由排除地址等配置能力,但具体界面是否开放这些选项取决于客户端版本。修改前记录原始设置,优先使用客户端界面提供的局域网选项,不要直接复制未经核验的完整 YAML。
关闭 TUN 后仍然无法联网
先关闭系统代理,再正常退出并重新打开客户端,让客户端清理虚拟接口和路由。Windows 可重新检查系统代理设置,Linux 可检查路由,macOS 可再次观察 utun 接口是否仍存在。若系统仍异常,重启客户端或系统前先保存日志,避免错误信息丢失。
安全的开启与回滚顺序
- 备份当前配置,或记下原有 TUN、DNS、系统代理状态。
- 退出其他 VPN、加速器和代理客户端。
- 确认配置和节点可用,先测试系统代理。
- 只开启 TUN,其他高级选项保持默认。
- 按系统提示完成权限授权。
- 用日志、测试应用和系统接口进行复测。
- 异常时先关闭 TUN,再关闭系统代理,确认网络恢复后再继续调整。
如需查看客户端版本或安装包,应从项目当前 Releases 页面选择与你的系统和架构匹配的文件,不要盲目复制旧版本文件名或旧下载地址。当前发布状态请以 Mihomo Party 项目 Releases 页面显示为准;页面当前可见的版本、文件名和系统分类应以打开页面时的实际内容为准。
常见问题
Mihomo Party 开启 TUN 后还需要开启系统代理吗?
不一定。TUN 通过虚拟网卡接管流量,系统代理主要服务于会读取系统代理设置的应用。首次排查时建议不要同时开启两者,先关闭系统代理单独测试 TUN,避免多个入口叠加导致判断困难。
TUN 模式是不是等于全局模式?
不是。TUN 负责把系统流量送入 Mihomo Party,规则模式或全局模式再决定这些流量走代理、直连还是其他策略。TUN 开启后,连接仍可能因为规则命中 DIRECT 而直连。
Mihomo Party TUN 模式需要管理员权限吗?
通常需要较高系统权限来创建虚拟接口、修改路由或安装相关服务,但具体提示会因 Windows、macOS、Linux 和客户端版本而变化。以当前系统弹窗和客户端提示为准,不要手工授予超出需要的权限。
为什么 TUN 一打开就断网?
常见方向包括权限未完成、虚拟接口创建失败、自动路由或 DNS 设置异常、其他 VPN 冲突,以及客户端或内核的版本特定问题。先关闭 TUN 确认网络恢复,再查看日志和系统接口,避免同时修改多个高级选项。
如何判断 TUN 是否真的生效?
关闭系统代理后测试一个通常不读取系统代理的应用,同时查看客户端连接日志和系统虚拟接口。Windows 可使用 <code>ipconfig</code>,macOS 可使用 <code>ifconfig</code>,Linux 可使用 <code>ip link</code> 或 <code>ip route</code>;这些命令用于观察,不要直接据此手工改路由。