TUN 模式开启失败怎么办?权限、虚拟网卡与断网排查
简答:TUN 模式开启失败,先关闭 TUN 并确认普通系统代理、节点和订阅正常,再按“权限—虚拟网卡—冲突—DNS与路由—日志”顺序排查。开关自动关闭多与授权或驱动有关;开关亮但全断网,则优先检查路由、DNS、栈设置和防火墙。
定义:TUN 模式是通过系统虚拟网络接口接管 IP 数据包的一种网络连接方式,启动失败通常不是节点本身故障,而是权限、接口、路由或其他网络接管组件冲突。
先看症状:不要把“开不了”和“开了没网”混在一起
截至2026年11月15日页面显示,TUN 故障最适合先按现象分组。TUN 会创建虚拟网络接口并接收系统路由到该接口的 IP 数据包;Android 官方对 VpnService 的说明也明确提到,系统会建立虚拟接口、配置地址与路由,并把数据包交给应用处理。可先参考Android VpnService API 说明理解这一层关系。
| 现象 | 优先怀疑 | 先做什么 |
|---|---|---|
| 点击开关后立即弹回 | 权限、服务、网络扩展或 VPN 授权未完成 | 退出客户端,重新授权;Windows 尝试管理员运行,macOS 检查网络扩展,手机重新确认 VPN 请求 |
| 提示 Access is denied | Windows 权限不足、服务未启动或安全软件拦截 | 关闭 TUN,退出其他网络接管软件,再以管理员身份启动 |
| 提示 operation not permitted | Linux 权限、能力或 TUN 设备不可用 | 检查 root、CAP_NET_ADMIN 和 /dev/net/tun |
| 提示 wintun、adapter、virtual interface | Windows 虚拟网卡组件异常或被占用 | 检查虚拟网卡、重启系统,必要时按客户端官方方式修复组件 |
| 开关亮但所有网页都打不开 | 默认路由、DNS、栈、防火墙或代理回环 | 先关闭 TUN 恢复网络,再检查 DNS、路由和 TUN 栈 |
| 只有部分软件不通 | 应用不使用系统代理、分流规则或 UDP 兼容性 | 先用浏览器和命令行分别测试,再调整应用代理或分流 |
| 局域网设备无法访问 | 全局路由接管了局域网,或启用了局域网隔离 | 检查绕过局域网、排除网段和防火墙规则 |
最快恢复路径:先确认是不是 TUN 独有故障
- 关闭 TUN,保留客户端主连接,打开系统代理或应用代理模式。
- 访问一个平时能打开的网页,并测试一个普通域名解析,确认节点、订阅和基础网络没有同时故障。
- 如果系统代理正常、TUN 失败,故障范围基本集中在虚拟接口、权限、路由或冲突组件;不要先反复更换节点。
- 退出其他 VPN、网络加速器、虚拟机网卡管理工具、局域网组网工具和重复运行的代理客户端,然后重启客户端再试。
- 仍然失败时,记录完整英文报错、系统版本、客户端版本、是否管理员运行、TUN 开关前后的网络状态,再提交给软件维护者或设备管理员。
Android 官方说明指出,同一用户或工作资料通常只能有一个活动 VPN;创建新的 VPN 接口时,已有接口可能被停用。iOS 与 macOS 的网络扩展也由系统管理 VPN 配置和虚拟接口,因此手机上反复切换多个 VPN 应用、苹果设备上同时存在企业 VPN 与个人 VPN,都可能造成状态判断混乱。相关机制可分别查看Android VPN 官方指南和Apple Packet Tunnel Provider 文档。
Windows:管理员权限、虚拟网卡与防火墙按顺序检查
Windows 上先不要直接删除网卡或修改注册表。按下面顺序检查,前一步确认无误后再做下一步:
- 完全退出客户端,再右键选择“以管理员身份运行”。如果弹出系统权限确认,选择允许;若设备属于公司管理环境,权限可能由管理员策略控制。
- 打开设备管理器,查看“网络适配器”中是否出现客户端创建的虚拟适配器。名称和位置会因客户端不同而变化,未核实的组件名称不要照抄。
- 在 PowerShell 中查看网卡状态:
Get-NetAdapter | Format-Table -Auto Name,InterfaceDescription,Status,MacAddress如果能看到虚拟适配器但状态异常,先禁用后启用该适配器,再重启客户端。若完全没有出现,优先检查客户端服务、安装完整性和安全软件拦截。
- 检查 Windows 防火墙或安全软件是否拦截客户端核心程序、服务或虚拟适配器。只添加明确对应的程序或接口例外,不要为了测试长期关闭防火墙。
- 若错误包含
wintun、adapter或driver,按客户端提供的修复或重装流程处理。Wintun 是 Windows 网络隧道驱动组件,相关项目资料说明其以 DLL 形式供程序加载;不要从来源不明的下载站替换系统文件,可参考公开项目中的 Wintun 使用说明核对基本文件关系。
修复后先不要马上开启全局接管。先启动 TUN,观察虚拟适配器是否出现,再访问一个普通网页;如果开关亮起后立刻全断网,回到 DNS、默认路由和栈设置检查。
macOS:重点查网络扩展、VPN授权与路由接管
macOS 的 TUN 类功能通常依赖系统 Network Extension 或 VPN 配置。Apple 文档说明,Packet Tunnel Provider 会为虚拟接口设置 IP、DNS、代理、MTU 和路由;Network Extension 也是苹果支持的 VPN 扩展方式。可先查看NETunnelProviderManager 官方说明。
- 关闭客户端并断开其他 VPN,再重新打开客户端。
- 到系统设置中的 VPN、网络扩展或相关隐私与安全设置,确认该应用的网络扩展、VPN 配置或系统扩展已经获准。不同 macOS 版本的菜单位置可能不同,未核实的菜单名不要按旧教程机械寻找。
- 如果系统弹出“允许添加 VPN 配置”或类似确认,完成授权后再返回客户端开启 TUN。
- 若曾安装多个网络过滤器、企业 VPN、虚拟机网络组件或安全软件,逐个退出后测试,避免同时修改路由表。
- 打开终端查看接口与路由:
ifconfig
route -n get default
scutil --dns如果 TUN 开启后默认路由消失、DNS 服务器异常或接口反复出现又消失,先关闭 TUN 恢复网络,再保存日志交给软件维护者。Apple 也提醒,直接修改路由表可能与系统或其他应用安装的路由规则冲突;使用系统支持的 Network Extension 路径更合适,可参考Apple 关于 Network Extension 与路由的说明。
Linux:检查 /dev/net/tun、权限和网络能力
Linux 上的“operation not permitted”不一定表示节点或远端连接失败,常见问题是当前用户没有创建 TUN 接口的权限,或系统没有加载 tun 模块。Linux 内核文档将 TUN/TAP 作为内核网络接口文档的一部分,具体说明可查看Linux 内核 TUN/TAP 文档。
- 确认设备文件存在:
ls -l /dev/net/tun
test -c /dev/net/tun && echo TUN_DEVICE_OK || echo TUN_DEVICE_MISSING- 如果设备缺失且你有管理员权限,检查模块:
sudo modprobe tun
lsmod | grep '^tun'- 查看当前用户和网络接口:
id
ip link show
ip route- 如果客户端要求 root 或
CAP_NET_ADMIN,按其官方安装方式授予最小必要权限,不要直接对未知二进制授予长期高权限。 - 若客户端能创建接口但启动后断网,先查看默认路由是否被替换,再检查 DNS 和防火墙:
resolvectl status
sudo nft list ruleset
ip route容器、虚拟机、企业 Linux 主机或受限服务器可能禁止创建 TUN 接口;这类情况需要系统管理员调整策略。若普通用户代理可用而 TUN 只能在 root 下运行,应把它视为权限差异,不要误判为线路故障。
Android 与 iOS:授权冲突比“驱动坏了”更常见
Android 应用需要通过系统 VPN 授权建立虚拟接口。官方 API 说明要求应用先调用 prepare 获取用户同意,再建立接口;系统同时只允许一个活动 VPN。遇到 TUN 开关弹回时,先到系统 VPN 页面确认当前是否已有其他 VPN、始终开启 VPN或锁定模式,再重新授权。
- 关闭其他 VPN 应用和始终开启 VPN设置,重新启动目标客户端。
- 出现系统 VPN 请求时选择允许;如果此前点过拒绝,进入系统设置撤销旧授权后再试。
- 检查电池优化、后台限制和工作资料策略,避免应用刚启动就被系统停止。
- 如果开启后全断网,先关闭 VPN 恢复网络,再检查客户端的 DNS 接管、分流和 IPv4/IPv6 选项,不要同时修改多个开关。
iOS 通常不提供用户手动修复虚拟网卡驱动的路径,重点是系统 VPN 配置、网络扩展授权、其他 VPN 配置和企业设备管理策略。Apple 文档说明,Packet Tunnel Provider 的配置包含虚拟接口和路由设置;如果授权已完成但开关仍自动关闭,应记录系统提示和客户端日志,必要时删除旧 VPN 配置后重新添加,而不是反复切换节点。
DNS、路由与 TUN 栈:开关亮起后断网的分流方法
当 TUN 已显示开启但所有应用都断网,先按以下顺序恢复:关闭 TUN、确认普通代理可用、重新开启 TUN、只改变一个设置并记录结果。
- DNS:先确认域名解析是否失败,再判断是 DNS 接管、Fake-IP、系统 DNS 或分流规则问题。不要在未确认客户端支持的情况下直接照抄 DNS 配置。
- 默认路由:检查 TUN 是否写入了默认路由,以及局域网网段是否被错误接管。需要访问打印机、NAS 或公司内网时,确认是否有绕过局域网或排除网段选项。
- 防火墙:某些 TUN 栈需要允许核心程序或 TUN 接口的出站流量。客户端文档列出的 stack 选项可能包括
system、gvisor、mixed等,但具体可用值与默认值必须以当前客户端页面为准,可参考公开 TUN 配置文档中的栈与防火墙说明。 - 传输兼容:如果只有部分软件不通,先区分 TCP、UDP、IPv4 和 IPv6,不要把浏览器可用等同于所有应用都可用。
每次只改一个变量,例如先从 mixed 切到 system,测试后再切换其他选项。若改动后出现全断网,立即关闭 TUN 并恢复上一项设置。
日志关键词与验证命令:确认 TUN 是否真正生效
日志位置因客户端和系统不同,本文不写死菜单名。优先搜索包含 tun、route、dns、permission、adapter、core exited 的行,并保留前后各几行上下文。
| 日志关键词 | 含义倾向 | 可改进的动作 |
|---|---|---|
| Access is denied | 权限或安全策略拒绝 | 改用管理员权限,检查服务和安全软件,再联系设备管理员 |
| operation not permitted | Linux 能力、设备文件或系统策略不足 | 检查 /dev/net/tun、root、CAP_NET_ADMIN 和容器限制 |
| wintun / adapter failed | 虚拟网卡组件创建或加载失败 | 检查适配器状态和客户端组件安装,不要下载未知 DLL 替换 |
| core exited | 核心进程启动后退出 | 查看上一条配置解析、端口占用或权限错误 |
| route add failed | 路由写入失败或与现有网络冲突 | 退出其他 VPN、虚拟网卡工具,再检查默认路由和局域网网段 |
| DNS timeout | DNS 接管、上游解析或路由路径异常 | 先关闭 TUN 对比解析,再单独检查 DNS 设置 |
Windows 可用 PowerShell 检查接口和路由:
Get-NetAdapter
Get-NetIPConfiguration
Get-NetRoute -AddressFamily IPv4macOS 可用:
ifconfig
route -n get default
scutil --dnsLinux 可用:
ip link
ip route
resolvectl status这些命令只能说明本机接口、路由和 DNS 状态,不能单独证明远端节点质量。验证时应同时记录 TUN 关闭与开启两组结果,避免把本地故障误归因于线路。
修不好时的安全回退与提交信息清单
如果 TUN 反复失败,但系统代理或单应用代理正常,可以暂时使用较小范围的模式完成工作,再安排维护,不必继续反复删除网卡或修改系统路由。适合回退的情况包括:设备由公司管理、没有管理员权限、多个企业 VPN 必须共存、虚拟机或容器禁止创建 TUN、客户端日志显示核心进程持续崩溃。
提交问题时一次提供以下信息:
- 操作系统及版本,设备是个人设备还是企业管理设备。
- 客户端名称和版本;未核实版本号不要用旧教程推断。
- 完整英文报错原文,例如
Access is denied或operation not permitted。 - TUN 关闭时系统代理是否可用,TUN 开启后是弹回、全断网还是部分应用不通。
- 是否同时运行其他 VPN、虚拟机、组网工具、安全软件或网络过滤器。
- 对应系统的接口、路由、DNS 命令输出,以及脱敏后的相关日志。
如需继续排查,可先参考站内的代理模式与 TUN 对比,再结合连接失败分层排查判断问题是否已经超出 TUN 范围。
常见问题
以下问题集中回答 TUN 排障中最容易误判的部分。
常见问题
TUN 模式开关一点击就自动关闭,先查什么?
先关闭其他 VPN 和网络接管工具,再重新启动客户端并完成系统授权。Windows 优先尝试管理员运行;macOS 检查网络扩展或 VPN 配置授权;Android 检查系统是否已有活动 VPN。
TUN 开启后所有网页都打不开,是节点坏了吗?
不一定。先关闭 TUN,确认普通系统代理或单应用代理是否正常;如果普通代理可用,优先检查 TUN 的默认路由、DNS、栈设置和防火墙,而不是马上更换节点。
Windows 提示 wintun 或虚拟网卡失败怎么办?
查看设备管理器中的网络适配器,确认虚拟适配器是否存在并处于正常状态;退出其他 VPN 后重启客户端。组件修复应使用客户端提供的安装流程,不要从来源不明的网站替换 DLL。
Linux 提示 operation not permitted,应该输入什么命令?
先运行 <code>ls -l /dev/net/tun</code> 和 <code>ip link show</code>;设备不存在时,在具备管理员权限的前提下运行 <code>sudo modprobe tun</code>,再检查当前用户是否具备创建网络接口所需权限。
Android 和 iOS 能不能同时开多个 TUN 或 VPN?
通常不能把多个 VPN 同时作为活动连接使用。Android 官方说明同一用户或工作资料只能有一个活动 VPN;iOS 也由系统管理 VPN 配置。遇到弹回或抢占,先关闭其他 VPN 并重新授权。