dsocks.site | Premium SS IEPL Private Line

Mihomo TUN 模式开启方法与常见报错排查

更新于 2026-11-16 · dsocks.site

简答:Mihomo TUN 开启失败时,先关闭 TUN、用普通 HTTP/SOCKS 代理确认节点可用,再备份配置并用 mihomo -t 校验。之后按权限、虚拟网卡、路由、DNS 四层排查;开启成功后要检查虚拟网卡、出口 IP、域名解析和实际流量,而不是只看开关是否保持开启。

定义:Mihomo TUN 模式是通过虚拟网卡接管系统网络流量的工作方式,和只代理已设置系统代理的 HTTP、SOCKS 或 Mixed 模式不同。

先试这一步:备份、校验,再开启 TUN

如果你看到 TUN 自动关闭、全网断网或域名无法打开,不要先反复切换开关。先关闭 TUN,确认普通代理仍能连接,再备份当前配置。Mihomo 官方文档将 enable、stack、auto-route、auto-detect-interface、dns-hijack 和 strict-route 作为 TUN 相关配置项;字段是否被当前内核支持,应以当前版本文档和实际校验结果为准。

先把配置文件复制为备份,例如 Linux/macOS 使用:

cp /path/to/config.yaml /path/to/config.yaml.bak

Windows PowerShell 5.1 建议使用:

Copy-Item .\config.yaml .\config.yaml.bak

Windows PowerShell 5.1 中,curl 默认可能是 Invoke-WebRequest 的别名;需要调用真正的 curl 时写成 curl.exe。PowerShell 7.x 不定义这个别名,仍建议显式使用 curl.exe 以避免命令参数混淆。微软关于 Windows curl 与 PowerShell 别名的说明

命令行内核可先检查版本,再校验配置:

mihomo -v
mihomo -t -d /path/to/mihomo

如果配置文件不在数据目录,可使用:

mihomo -t -d /path/to/mihomo -f /path/to/config.yaml

-t 用于测试配置并退出;在图形客户端中,应寻找类似“配置校验”“检查配置”或“重新载入配置”的入口。若客户端没有校验按钮,可找到它实际使用的内核和配置目录后,在终端执行上述命令。校验通过只说明 YAML 和字段基本可解析,不等于 TUN 权限、路由和 DNS 已经正常。

现象先做什么正常判据异常处理
TUN 开关自动关闭查看内核启动日志并执行配置校验校验返回成功,内核保持运行修正缩进、字段或权限后再启动
开启后全网断开关闭 TUN,恢复普通代理普通代理可访问测试网页检查路由、出口接口、DNS 和其他 VPN 冲突
IP 可访问但域名打不开分别测试 IP 和域名两者都能访问检查 DNS、dns-hijack 和 Android 私人 DNS
只有部分应用不通比较浏览器、终端和目标应用至少能判断是否为单应用问题检查应用自身代理、UDP 支持、规则和严格路由

YAML 缩进必须保留空格,复制配置时使用下面这种代码块,不要把每行拼接成段落:

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53
    - tcp://any:53
  strict-route: true

这是排查用的最小示例,不代表所有版本、客户端或系统都应直接照搬。auto-redirect 是 Linux 相关选项;macOS 的设备名如需手动指定,应遵守以 utun 开头的限制。字段支持与默认值可能随内核版本变化,校验失败时以当前版本文档为准。Mihomo TUN 配置字段说明

按系统开启:Windows、macOS、Linux 与 Android

Windows

  1. 先退出其他 VPN、WireGuard、虚拟机网络工具或可能创建虚拟网卡的程序,保留一个网络接管组件做测试。
  2. 以管理员身份启动客户端或内核。若使用 system 或 mixed 协议栈,检查 Windows 防火墙是否允许 Mihomo 内核通过。
  3. 在配置中先启用 enable、auto-route 和 auto-detect-interface。多网卡设备不要盲目固定出口接口,先用自动检测;如果仍选错,再根据“设置—网络和 Internet—高级网络设置”确认实际联网网卡名称。
  4. 首次成功启动后,在“设置—网络和 Internet—高级网络设置”查看是否出现 Mihomo 或类似名称的虚拟网卡,同时查看内核日志是否出现 TUN 已监听或适配器已创建的成功信息。

Windows 的 strict-route 可用于减少普通多宿主 DNS 解析造成的泄漏,但官方文档也提示它在特定场景可能影响 VirtualBox 等应用。遇到虚拟机无法联网时,先关闭该选项重新验证,不要直接删除系统路由。Mihomo TUN 的 Windows、DNS 与 strict-route 说明

macOS

  1. 关闭其他 VPN 或网络过滤器,确认客户端拥有系统要求的网络权限。
  2. 配置中先不手动写 device;如果确实需要指定,使用以 utun 开头的名称。
  3. 开启 TUN 后查看“系统设置—网络”,确认虚拟接口或网络状态发生变化,再测试网页和命令行。
  4. 如果浏览器打不开但 IP 测试正常,重点检查 DNS;macOS 和 Windows 不能自动劫持发往局域网的 DNS 请求,局域网 DNS 场景不能只依赖 dns-hijack。

Linux 与 Linux 容器

  1. 宿主机先确认 TUN 设备存在:
    ls -l /dev/net/tun
    正常应能看到设备;若不存在,先按发行版启用 TUN 模块或设备。
  2. 宿主机运行内核时,使用能够修改路由和防火墙的权限。启用 auto-redirect 时,确认 iptables 或 nftables 条件满足,并且 auto-route 已启用。
  3. 在 Docker 中,通用启动参数可写为:
    docker run --cap-add=NET_ADMIN \
      --device=/dev/net/tun:/dev/net/tun \
      <image>
    这只是容器权限示例,镜像、网络模式和配置目录仍需按实际部署方式设置。若容器内能启动但宿主机流量不通,继续检查容器网络模式、路由和防火墙。
  4. Linux 多出口设备不要只看默认路由;用 ip route 和 ip link 确认实际出口接口、TUN 接口及路由是否存在。

Android

  1. 在客户端中允许系统创建 VPN 连接,并关闭其他 VPN 应用。
  2. 先启用 TUN 和自动路由,再查看系统 VPN 图标或客户端连接状态。
  3. 如果开启了 Android“私人 DNS”,DNS 请求可能无法被自动劫持;先将私人 DNS 改为自动或关闭后重测,确认是否为 DNS 层问题。
  4. Android 的 TUN 转发和热点共享不是同一件事;官方文档说明其自动转发有平台限制,不能把“手机自身能用”直接等同于“热点设备也能用”。

常见报错对照:从权限、网卡到路由和 DNS

下面的关键词用于定位方向。不同客户端可能会改写日志文字,因此“现象描述”不一定是内核逐字输出;看到相近提示时,先按故障层处理。

日志或现象可能层级处理动作复核方法
permission denied权限Windows 以管理员身份运行;Linux 使用具备路由和 TUN 权限的用户或能力;Android 重新接受 VPN 授权重启内核后查看虚拟网卡是否创建,日志是否继续进入运行状态
cannot create TUN 或创建虚拟网卡失败设备关闭其他 VPN,检查旧接口、驱动、/dev/net/tun 和容器设备映射确认只保留一个接管流量的组件,再重新开启
Start TUN listening error启动先校验 YAML,再检查权限、设备名、端口或残留进程;这是日志关键词,不应单独据此判断唯一原因记录修改前后完整启动日志,确认错误是否消失
device or resource busy接口冲突关闭其他 VPN、虚拟机、容器或旧的 Mihomo 进程,必要时重启客户端查看系统进程和网络接口,确保没有重复占用
address already in use端口或监听冲突检查客户端是否启动了多个内核或重复控制接口,不要只改 TUN 配置停止重复进程后重新启动,并查看监听端口
TUN 成功但网页全打不开路由或规则临时关闭 TUN 恢复网络;再检查 auto-route、出口接口、规则和默认路由先测 IP,再测域名,再测浏览器,逐层确认
IP 能通、域名不通DNS检查 DNS 模块、dns-hijack、私人 DNS 和局域网 DNS 限制用命令行分别执行域名解析与 IP 访问
浏览器能用、某应用不通应用或协议检查应用是否自带代理、是否依赖 UDP、是否被规则匹配为 DIRECT 或 REJECT比较同一目标的浏览器、终端和应用结果

不要把 mips、mixed 或 system 当成“越新越好”的固定答案。当前官方文档列出的可用值包括 system、gvisor、mixed 和 mips,但不同内核版本的默认值和推荐写法可能不同;如果某个值校验失败,应以当前版本文档和 mihomo -t 结果为准。官方英文 TUN 字段与协议栈说明

开启后怎么确认 TUN 真的接管了流量

  1. 检查虚拟网卡:Windows 查看网络适配器,Linux 使用 ip link,macOS 使用 ifconfig,Android 查看系统 VPN 图标或客户端状态。正常是接口存在且客户端没有立即报错。
  2. 检查出口 IP:在关闭 TUN 和开启 TUN 时,分别用浏览器访问同一个 IP 查询页面,或用命令行请求同一个文本接口。PowerShell 5.1 可使用:
    (Invoke-WebRequest -UseBasicParsing -Uri 'https://example.com').StatusCode
    如果要下载并保存内容,PowerShell 5.1 使用:
    Invoke-WebRequest -Uri 'https://example.com' -OutFile '.\check.html'
    PowerShell 7.x 也可以使用 curl.exe;不要把订阅链接、令牌或完整响应内容直接粘贴到公开日志中。
  3. 检查 DNS:Windows 使用 nslookup example.com,Linux/macOS 使用 nslookup example.com 或系统已有的 DNS 工具。正常是域名能解析且解析请求没有持续超时;异常时先区分 DNS 失败还是节点连接失败。
  4. 检查实际流量:打开一个此前未缓存的网页,观察客户端流量计数、日志中的规则匹配和连接记录。只看到 TUN 开关为开启,不足以证明业务流量已经经过它。
  5. 检查 UDP:不要用一次普通网页访问推断 UDP 正常。选择明确依赖 UDP 的应用或测试,在客户端日志中确认是否有 UDP 会话;若 TCP 正常而 UDP 失败,再检查协议栈、节点能力、规则和防火墙。

延迟测试、ICMP ping、HTTP 请求和真实网页访问不是同一口径,不能把它们的数值简单相减来推导 TUN 或节点的“额外延迟”。排障时应保持测试目标和测试方式一致,记录开启前后的结果。

断网后的安全回滚流程

  1. 先关闭 TUN 开关,不要立刻删除系统路由或网络适配器。
  2. 如果客户端无响应,退出客户端或停止对应内核进程,再恢复系统原有 VPN、代理和网络设置。
  3. 用普通代理模式验证网络是否恢复;若恢复,说明故障集中在 TUN、路由、DNS 或权限层,而不是节点本身。
  4. 将配置恢复为备份文件,再执行 mihomo -t 校验。不要直接覆盖仍在运行的配置,避免把错误配置再次加载。
  5. Linux 只清理由本次测试创建、且能明确识别的接口和规则;不熟悉路由表时不要执行批量删除命令。Windows 也不要手动删除不确定归属的路由。

如果每次重启客户端都重复断网,优先检查是否保存了错误的活动配置、是否同时启动了两个内核,以及是否残留其他 VPN 的路由规则。先回到备份配置,再一次只修改一个字段。

核对日期:2026-11-16。本站为第三方使用指南,不是任何客户端或内核项目的官方网站。

接下来可继续排查什么

如果 TUN 已经能够启动,但订阅节点、系统代理或具体应用仍然连接失败,建议继续按“节点可用性—系统代理—规则—DNS—TUN”顺序分层排查,避免把多个变量同时修改。

常见问题

Mihomo TUN 模式和系统代理有什么区别?

系统代理通常只影响遵守系统代理设置的应用;TUN 通过虚拟网卡和路由接管更多系统流量,因此还会涉及网卡权限、路由、DNS、IPv4/IPv6 和 UDP。开启 TUN 后,必须用虚拟网卡、出口 IP、DNS 和实际流量分别验证。

Mihomo TUN 开启后全网断网,应该先改哪个字段?

不要立即连续修改多个字段。先关闭 TUN恢复普通代理,备份配置并执行 mihomo -t;随后优先检查 auto-route、auto-detect-interface、出口接口、DNS 和其他 VPN 冲突。若仍无法定位,可暂时使用最小配置,只保留 enable、stack、auto-route 和自动检测接口,再逐项加回。

为什么 Mihomo TUN 能启动,但域名打不开?

这通常属于 DNS 层,而不是虚拟网卡创建层。先测试 IP 是否可访问,再检查 dns-hijack、DNS 模块、Windows/macOS 局域网 DNS 限制,以及 Android 是否开启私人 DNS。普通网页能打开并不代表所有 DNS 请求都被 TUN 接管。

Mihomo 的 stack 应该选 system、gvisor、mixed 还是 mips?

当前官方文档列出这四个可用值,但默认值和推荐写法可能随内核版本变化。没有明确兼容性需求时,不要依据旧教程判断;先用当前版本文档中的示例,并通过 mihomo -t 校验,启动后再按 TCP、UDP、应用兼容性进行对照测试。

Linux Docker 中为什么 TUN 无法创建?

先检查宿主机是否存在 /dev/net/tun,再确认容器映射该设备并具备 NET_ADMIN 能力。可用 --cap-add=NET_ADMIN 和 --device=/dev/net/tun:/dev/net/tun 作为通用检查起点;如果仍失败,继续检查容器网络模式、宿主机路由和防火墙。

相关阅读

参考资料

  1. MetaCubeX Mihomo 官方中文文档:TUN 配置
  2. MetaCubeX Mihomo 官方英文文档:TUN 字段与平台说明
  3. 微软官方文档:Windows curl 与 PowerShell 别名
  4. MetaCubeX 官方项目文档:容器 TUN 权限与配置校验
  5. MetaCubeX Mihomo 官方 Releases 页面