Box for Root：安卓 root 透明代理模块

项目简介

Box for Root（BFR）是一个用于在已 root 的 Android 设备上运行透明代理的 Magisk、KernelSU、APatch 模块。它支持 Clash/Mihomo、sing-box、v2fly、xray 和 hysteria 代理核心，以模块方式接管设备流量。项目使用 Shell 编写，遵循 GPL-3.0 许可证。

主要功能

• 多种代理核心与网络模式，可配置应用与进程过滤。
• 开机自动启动服务，也可在管理器或命令行中控制服务。
• 可选的网络状态控制、定时更新与 cgroup 资源限制。

网络模式通过 settings.ini 中的 network_mode 设置：

模式	流量处理
redirect	重定向 TCP，UDP 直连
tproxy	TCP 与 UDP 走 TProxy
mixed	重定向 TCP，UDP 走 TUN
enhance	重定向 TCP，UDP 走 TProxy
tun	TCP 与 UDP 走自动路由的 TUN 接口

xray 和 v2fly 需要 tproxy；hysteria 支持 redirect、tproxy、enhance；clash 与 sing-box 支持其配置提供的模式，其中 tun 仅这两个核心可用。

应用与进程过滤：/data/adb/box/package.list.cfg 按包名过滤应用（mode:blacklist 为默认黑名单，mode:whitelist 为白名单）；/data/adb/box/gid.list.cfg 按 GID 过滤进程；/data/adb/box/ap.list.cfg 用 allow / ignore 前缀控制网络接口。

安装与使用

从 releases 下载 ZIP，在 Magisk、KernelSU 或 APatch 管理器中安装。不支持 recovery 安装，KernelSU 版本号低于 10670 不受支持。安装过程会提供下载加速与代理核心二进制选项，需要联网下载，安装完成后重启。更新时会备份并恢复 /data/adb/box 下的已有数据。

可选安装 BFR Manager 应用在设备上管理 Box for Root。

常用目录：

• 模块文件：/data/adb/modules/box_for_root
• 持久数据、脚本与核心配置：/data/adb/box
• 主设置：/data/adb/box/settings.ini
• 运行日志与状态：/data/adb/box/run

代理核心由 settings.ini 的 bin_name 选择（clash、sing-box、xray、v2fly、hysteria），可执行文件位于 /data/adb/box/bin，配置文件在 /data/adb/box 下对应目录中，例如 /data/adb/box/clash/config.yaml。

服务控制：

su -c /dev/sbfr start
su -c /dev/sbfr stop
su -c /dev/sbfr help

查看维护命令：su -c /data/adb/box/scripts/box.tool help。

注意事项

• 修改配置文件前请先停止 BFR，并保证配置中的代理监听端口与 settings.ini 一致。
• 若收到持续通知，可在 Magisk 管理器的超级用户中搜索 BoxForRoot，关闭日志与通知。
• 创建 /data/adb/box/manual 可禁止开机自启与管理器控制，此时只能用上述命令启停。
• 卸载：在管理器中移除模块；若仍有残留可手动清理：

su -c rm -rf /data/adb/box

---

本作品整理自 GitHub 开源项目 taamarin/box_for_magisk，原作者 @taamarin，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。