
![]()
1. Box4Magisk 适合哪些环境
Box4Magisk 面向已 Root 的 Android,可在 Magisk、KernelSU、APatch 下部署 clash、mihomo、sing-box、v2ray、xray、hysteria 等核心,并配合 AndroidTProxyShell 做透明代理。支持 REDIRECT(仅 TCP)、TPROXY(默认优先,TCP+UDP)、核心自带 TUN,以及 REDIRECT+TUN 混合模式。
本站收录平台:Android。官方明确:模块 ZIP 不包含任何代理核心二进制,安装后需自行把对应架构的可执行文件放到 /data/adb/box/bin/。不熟悉配置时,先用普通图形客户端弄清订阅与规则概念,再上模块,以免错误配置导致流量回环。
2. 如何下载并刷入 Box4Magisk
打开 Box4Magisk 下载与项目入口,从 GitHub Releases 获取最新模块包,在 Root 管理器中本地安装。项目支持在线更新,更新后通常无需重启即可生效。站内版本仅供对照,实际以发布页为准。
刷入后按 README 下载与设备架构匹配的核心,写入 /data/adb/box/bin/。不要与其他透明代理模块同时启用,以免规则互相覆盖。
3. 选择核心并完成第一次验证
打开 Box4Magisk 项目仓库,对照中文 README。核心由 /data/adb/box/scripts/box.config 里的 bin_name 决定(默认推荐 sing-box,也可选 mihomo 等);工作目录为 /data/adb/box/<核心名>。mihomo / sing-box 自带默认可配合透明代理的配置,先改订阅或出站字段,再核对 tproxy.conf 中的网卡接口名。配置检查结果见 /data/adb/box/run/check.log。
4. 更新前备份与排障
升级前备份整个 /data/adb/box/,尤其是自用配置与 box.config / tproxy.conf。若更新后无法上网或设备异常重启,先停模块并检查是否存在回环;记下模块版本、Root 方案、当前 bin_name 与日志原文再到 Issues 检索。
