Skip to content

metacubexd 开 TUN 后断网,怎么把网络找回来 ​

在 MetaCubeXD 桌面版里打开 TUN,浏览器、聊天软件一起掉线,关掉面板窗口也不见好转。README 有一节就叫 “If TUN takes down your network”,专门讲这种情况。这一页按那一节的内容,告诉你先点哪里、点了没用再做什么。

先分清:断网是 TUN 造成的,不是系统代理 ​

结论:只有开了 TUN 才会出现整机断网,关系统代理开关解决不了。

README 开头就把两者分开讲:“System proxy and TUN are separate features.” 系统代理只是通过平台自带工具改当前用户的代理设置,不安装任何特权组件。TUN 则在网络层接管整机流量,连那些不理会代理设置的程序也一并接管。

TUN 会改写系统的默认路由。README 写得很清楚:配置有错,或者隧道卡住,就会把网络带下线。所以判断方法是:断网发生在打开 TUN 之后,关掉系统代理开关也没有变化,就属于这一类。

第一条路:点 Recover network ​

结论:App 还开着,就先点 Recover network,它不需要退出程序。

README 给的第一种恢复方法是点 App 里的 “Recover network”。原文说它会拆掉 TUN 的路由,恢复正常网络,而且不用退出 App。

点完之后,打开一个平时能访问的网页确认一下。如果网络回来了,可以先保持 TUN 关闭,回头检查配置。README 没有写这个按钮在界面里的具体位置,也没有写它是从哪个版本加入的,只给了按钮文字 Recover network,找的时候认准这几个英文词。

第二条路:正常退出 App ​

结论:正常退出同样会拆掉 TUN、恢复路由。

README 的第二种方法是 “Quit the app normally”。正常退出时,App 会自己把 TUN 拆掉,把路由改回去。这里说的正常退出,是用菜单或托盘里的退出项,不是直接杀进程。

App 被强制结束了怎么办 ​

结论:先重新打开 App,再点 Recover network。

如果你在 macOS 的活动监视器或者 Windows 的任务管理器里强行结束了它,TUN 的路由可能没被拆掉,网络还是断的。README 对这种情况的建议很直接:重新打开 App,然后点 Recover network。

这一步容易被忽略。README 只说正常退出会拆掉 TUN,没有说强制结束也会,所以别指望进程没了网络就自己回来。

各平台的 helper 有什么不同 ​

结论:TUN 依赖一个特权后台服务,三个平台的形态不一样,排查时要知道它在哪。

TUN 需要 root 或管理员权限。桌面版首次启用 TUN 时会安装一个 “privileged helper”,所以第一次会弹授权框。README 分平台写了它的样子:

平台helper 形态授权方式
macOSroot LaunchDaemon,内核绑定系统的 utun 接口osascript 的 “wants to make changes” 管理员弹窗
Windows自启动的 Windows 服务 metacubexd-helper,自带 wintun.dllUAC
Linuxroot systemd unitpkexec(PolicyKit),无头机器可能要装 Polkit agent

Windows 上停止 metacubexd-helper 服务,也会把 helper 和内核进程一起停掉。如果已有的 helper 连不上或者协议对不上,App 会尝试修复一次,这时可能再弹一次管理员授权。激活失败时,README 说 App 会移除 TUN 设置,再尝试重启普通的代理后端。

避免下次再断:开 TUN 前先激活配置 ​

结论:先选好并激活一个配置,再打开 TUN。

README 写的是 “Activate a profile before enabling TUN.” 这是 README 里开 TUN 之前唯一写明的前置步骤,顺序反过来做,出问题时也更难判断是哪一步错了。

如果你的 TUN 配置是手写的,可以对照 mihomo 文档的 tun 示例检查一遍。文档对 auto-route 的说明是自动设置全局路由,把全局流量导进 TUN 网卡。文档示例里还有 strict-route、dns-hijack、auto-detect-interface 等选项,各自的默认值文档页没有逐项写明,改之前先看清楚自己的配置原来是什么。

如果你用的是 Docker 版,README 另有要求:容器需要 NET_ADMIN 权限、/dev/net/tun 设备和 host 网络,配置里还要启用 tun: 块。

恢复之后怎么反馈 ​

结论:README 列了四项必填信息,缺了很难排查。

需要去项目 GitHub 提问时,带上 App 版本、系统和架构、确切的提示或错误原文,以及 Recover network 有没有让网络恢复。README 特别提醒不要贴密钥或订阅地址。

订阅本身是否正常,可以按 机场订阅问题排查 那一篇先过一遍。想先确认节点能用再开 TUN,可以参考 Clash 节点自动选择 里讲的测速方法。

常见问题 ​

开了 TUN 断网,关掉系统代理有用吗? ​

没用。README 写明系统代理和 TUN 是两个独立功能,TUN 在网络层接管整机流量,要恢复得拆掉 TUN 的路由,用 Recover network 或者正常退出 App。

Recover network 会退出 MetaCubeXD 吗? ​

不会。README 的原话是它会拆掉 TUN 路由、恢复正常网络,而且不需要退出 App。

App 被我在活动监视器或任务管理器里强行结束了,现在没网怎么办? ​

README 的建议是重新打开 App,再点 Recover network。README 只写了正常退出会自动拆掉 TUN 并恢复路由,强制结束的情况要手动补这一步。

为什么第一次开 TUN 会弹管理员授权? ​

TUN 需要 root 或管理员权限,桌面版首次启用时会安装一个特权 helper 后台服务,所以会弹授权框。macOS 走 osascript 弹窗,Windows 走 UAC,Linux 走 pkexec。

开 TUN 之前要先做什么? ​

README 要求先激活一个配置,再启用 TUN。原文是 “Activate a profile before enabling TUN.”

恢复之后想反馈问题,要写哪些内容? ​

README 列了四项:App 版本、系统与架构、确切的提示或错误,以及 Recover network 有没有让网络恢复。不要附密钥或订阅地址。

机场推荐排行榜 2026 · 便宜机场推荐 · 专线机场推荐 · 稳定机场推荐
本站内容仅供学习交流,请遵守当地法律法规。本站与部分服务商存在联盟推广关系,标注「站长主推」的栏目为商业推荐位;本站不做速度实测,收录名单中没有采集记录的字段显示「未采集」,详见「关于本站」的利益披露。发现内容有误欢迎通过「联系与反馈」指出。