Box for Magisk 怎么用：安卓 root 透明代理模块

先说结论

Box for Magisk 是一个运行在已 root 安卓设备上的透明代理模块，官方仓库位于 GitHub 的 taamarin/box_for_magisk。仓库 README 中把项目称为 Box for Root，描述为面向 root 安卓设备的透明代理，可作为 Magisk、KernelSU 或 APatch 模块安装。它不是一个带界面的 App，而是在系统层面运行代理内核，并通过网络规则让设备上的应用流量经过代理。

本站核对时，仓库未归档，许可证为 GPL-3.0，最新正式版本为 v1.10.2，发布于 2025 年 9 月 5 日。

在继续之前，请务必先读这三句话：使用它必须先 root；刷入任何系统模块都有风险，包括断网、与其他模块冲突乃至无法正常开机；操作前请备份手机上的重要数据。如果你对 root 和模块管理不熟悉，普通的安卓客户端 App 会是更安全的选择。

核对到的官方信息

项目	核对结果
名称	Box for Magisk（仓库名为 box_for_magisk，README 中称为 Box for Root）
类型	安卓 root 透明代理模块，可通过 Magisk、KernelSU、APatch 安装
最新版本号	v1.10.2（官方 Releases 页面标记为 Latest）
发布日期	2025 年 9 月 5 日（GitHub 接口返回的发布时间）
平台	已 root 的安卓设备；README 写明 KernelSU 版本号低于 10670 不受支持，不支持通过 Recovery 安装
价格	未能核实（官方页面未出现价格信息，项目为开源软件）
许可证	GPL-3.0
是否归档	未归档
官方来源	https://github.com/taamarin/box_for_magisk 与 https://github.com/taamarin/box_for_magisk/releases

关于 Magisk 与 APatch 的最低版本，官方 README 没有列出，本页写为未能核实。网上存在一些模块仓库的镜像条目，它们的版本信息与官方一致时可以作为参考，但下载仍应以官方 Releases 为准。

它适合谁，不适合谁

适合的人：已经熟悉 root 与模块管理，希望整台手机所有应用都走透明代理，而不想依赖某个 App 的 VPN 接口；或者希望在系统层面运行与电脑上相同的内核配置，在多台设备之间保持一致。

不适合的人：手机没有 root；不了解如何在开机异常时禁用模块；只是想在手机上打开几个网站。对于这些情况，站内的 Clash Meta for Android 页面 和 安卓客户端指南 是更合适的起点。普通 App 通过系统 VPN 接口工作，不需要 root，出了问题卸载即可，风险小得多。

支持的内核与网络模式

官方 README 列出了模块可以调用的内核：Clash 系（包括 Mihomo）、sing-box、Xray、v2fly 以及 hysteria。不同内核可用的网络模式并不相同，这是配置时最容易出错的地方。

• Xray 与 v2fly 需要使用 tproxy 模式。
• hysteria 支持 redirect、tproxy 与 enhance 几种方式。
• tun 模式只有 Clash 系与 sing-box 可用。

如果你选择的内核与网络模式不匹配，模块可能启动成功但流量不经过代理，或者直接断网。想理解 tun 与透明代理的基本原理，可以阅读站内的 TUN 模式说明。各内核本身的介绍，可以参考 sing-box 页面 和 Xray-core 页面。

Box for Magisk 刷入前的准备

刷模块不是可以随手尝试的操作，以下准备请逐项完成。

1. 备份数据。照片、聊天记录、二步验证的恢复码等，先备份到电脑或云端。
2. 确认 root 管理器版本。如果使用 KernelSU，确认版本号不低于官方要求；Magisk 与 APatch 请使用较新的正式版本。
3. 了解救援方法。提前查清你的 root 管理器在开机异常时如何进入安全模式或禁用全部模块，不同管理器的方法和菜单名称略有差异。
4. 检查已有模块。如果已经装有其他修改网络或防火墙规则的模块，最好先停用，避免冲突。
5. 只从官方 Releases 下载模块压缩包，并阅读站内的 下载安全指南。系统模块拥有最高权限，来源不明的文件绝对不要刷入。

官方 README 明确写明不支持通过 Recovery 安装，请在 root 管理器里完成安装。

Box for Magisk 的一般使用流程

下面是通用流程，不涉及具体命令参数，细节以官方 README 为准。

1. 在 root 管理器的模块页面中，选择从本地安装，选中下载好的模块压缩包，安装后重启。
2. 重启后，模块的持久数据目录位于 /data/adb/box。主设置文件是该目录下的 settings.ini，用于选择内核、网络模式等。
3. 将所选内核的配置文件放到对应位置。README 给出的例子是 Clash 系内核的 config.yaml 放在 /data/adb/box/clash 目录下，其他内核可参照 README 说明。
4. 如果只想让部分应用走代理，README 提到可以通过应用包名列表、用户组列表和网络接口列表进行过滤，这些列表文件都在 /data/adb/box 目录下。
5. 启用或停用模块即可控制代理的开关。README 也提供了通过终端以 root 权限调用服务脚本进行启动、停止的方式，具体写法请以 README 原文为准。

几条官方给出的提醒值得特别注意：修改配置文件应在模块停止的状态下进行；代理监听端口要与 settings.ini 中的设置保持一致；IPv6、网络状态控制等选项默认关闭，需要时才在 settings.ini 中打开；运行日志与状态文件位于 /data/adb/box/run，排查问题时先看这里。

Box for Magisk 的配置与订阅

很多人期待它能像 App 一样「粘贴订阅、一键连接」，但这类模块的工作方式不同。它本质上是让内核按照你提供的配置文件运行，配置文件里写好了节点、分流规则和端口。

如果服务商提供的是 Clash 系配置，搭配 Clash 系内核会比较顺手；如果提供的是 sing-box 配置，则搭配 sing-box 内核。本页没有在官方页面核实到模块内置的订阅更新功能，因此不做承诺，frontmatter 中的适配格式也留空。配置里的分流规则写法，可以参考站内的 分流规则指南。不同协议之间的区别，可以看 协议科普。

请记住，配置文件里通常直接包含订阅链接或节点信息，相当于账号凭证，不要把整个目录打包分享给别人。

出问题时怎么办

• 启用后断网：先在 root 管理器中停用模块并重启，确认网络恢复，再检查内核与网络模式是否匹配、端口是否一致。
• 持续弹出 root 授权通知：README 建议在 root 管理器的超级用户设置中，关闭该模块的日志与通知。
• 开机异常：使用事先查好的安全模式或禁用模块方法进入系统，再卸载模块。
• 卸载后的残留：README 说明卸载会删除 /data/adb/box，剩余文件需要手动清理。
• 连接时断时续：可以参照站内的 断线排查页面 检查节点和网络环境。

与普通安卓客户端的对比

为了帮助判断是否真的需要这个模块，这里把它和普通安卓客户端 App 做个对比。

工作方式上，普通 App 通过安卓系统提供的 VPN 接口接管流量，状态栏会出现钥匙图标；模块则直接在系统层面修改网络转发规则，不占用 VPN 接口。这意味着用了模块之后，你仍然可以同时使用其他依赖 VPN 接口的应用，这也是一部分用户选择它的原因。

上手难度上，普通 App 有完整的图形界面，导入订阅、切换节点、查看日志都在界面里完成；模块主要依靠编辑配置文件，出了问题要自己读日志，对新手并不友好。

风险上，普通 App 出问题时卸载即可恢复；模块出问题时可能影响整机网络，严重时影响开机，需要掌握救援方法。

维护上，普通 App 更新时直接覆盖安装；模块更新时要留意配置文件是否需要调整，更新前最好先备份 /data/adb/box 目录中的配置。

系统升级也是需要考虑的一环。安卓大版本更新或 root 管理器更新后，模块可能需要重新适配，建议在系统更新前先停用模块，更新完成并确认 root 正常后再启用。

综合来看，对于大多数只需要在手机上使用机场节点的人，普通 App 更合适；对于已经熟悉 root 环境、确实需要系统级透明代理的人，模块才能体现价值。

小结

Box for Magisk 是一个功能强大但门槛不低的工具：核对时仓库未归档，许可证为 GPL-3.0，最新版本 v1.10.2。它需要 root，刷入有风险，操作前必须备份并掌握禁用模块的方法。如果你只是想在手机上正常使用机场节点，普通 App 更省心；只有在确实需要系统级透明代理时，再考虑它。更多客户端可以回到 客户端总览 查看。