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 形态 | 授权方式 |
|---|---|---|
| macOS | root LaunchDaemon,内核绑定系统的 utun 接口 | osascript 的 “wants to make changes” 管理员弹窗 |
| Windows | 自启动的 Windows 服务 metacubexd-helper,自带 wintun.dll | UAC |
| Linux | root systemd unit | pkexec(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 有没有让网络恢复。不要附密钥或订阅地址。