Box4Magisk/KernelSU/APatch
本项目通过 Magisk 、KernelSU 或 APatch 部署 clash、mihomo、sing-box、v2ray、xray、hysteria 代理，支持 REDIRECT（仅 TCP）、TPROXY（TCP + UDP）透明代理，支持由核心提供的 TUN（TCP + UDP）代理，也支持 REDIRECT（TCP） + TUN（UDP） 混合模式代理。
免责声明
本项目不对以下情况负责：设备变砖、SD 卡损坏或 SoC 烧毁。
请确保您的配置文件不会造成流量回环，否则可能会导致您的手机无限重启。
如果你真的不知道如何配置这个模块，你可能需要像 ClashForAndroid、sing-box for Android、v2rayNG、surfboard、SagerNet、AnXray 等应用程序。
安装
- 从 Release 页下载模块压缩包，然后通过 Magisk Manager，KernelSU Manager 或 APatch 安装
- 支持后续在 Magisk Manager 中在线更新模块（更新后免重启即生效）
- 更新模块时会备份用户配置，且附加用户配置至新
/data/adb/box/scripts/box.config文件（在 shell 中，后定义的变量值会覆盖之前的定义值，但仍建议更新模块后再次编辑box.config文件去除重复定义与移除废弃字段）
注意
模块不包含 clash、mihomo、sing-box、v2ray-core、Xray-core、Hysteria 等二进制可执行文件。
模块安装完成后请您自行下载设备对应架构的核心文件放置到 /data/adb/box/bin/ 目录。
配置
- 各核心工作在
/data/adb/box/核心名字目录，核心名字由/data/adb/box/scripts/box.config文件中bin_name定义，有效值只有clash、mihomo、xray、v2ray、sing-box，bin_name决定模块启用的核心 - 各核心配置文件需用户自定义，模块脚本会检查配置合法性，检查结果存储在
/data/adb/box/run/check.log文件中 - 提示：
mihomo和sing-box核心自带默认配置已做好配合透明代理脚本工作的准备。建议编辑proxy-providers或outbounds部分来添加您的代理服务器，进阶配置请参考相应官方文档。地址：clash 文档，mihomo 文档，sing-box 文档，v2ray 文档，xray 文档，Hysteria 文档
使用方法
常规方法（默认 & 推荐方法）
管理服务的启停
以下核心服务统称 Box
- Box 服务默认会在系统启动后自动运行
- 您可以通过 Magisk Manager 应用打开或关闭模块实时启动或停止 Box 服务，不需要重启您的设备。启动服务可能需要等待几秒钟，停止服务可能会立即生效
选择需要代理的应用程序（APP）
-
Box 默认代理所有安卓用户的所有应用程序（APP）
-
如果您希望 Box 代理所有应用程序（APP），除了某些特定的应用，那么请打开
/data/adb/box/scripts/box.config文件，修改proxy_mode的值为blacklist（默认值），在user_packages_list数组中添加元素，数组元素格式为安卓用户:应用包名，元素之间用空格隔开。即可不代理相应安卓用户应用。例如user_packages_list=("0:com.android.captiveportallogin" "10:com.tencent.mm")代表不代理用户 0 的 CaptivePortalLogin 和用户 10 的 Wechat -
如果您希望只对特定的应用程序（APP）进行透明代理，那么请打开
/data/adb/box/scripts/box.config文件，修改proxy_mode的值为whitelist，在user_packages_list数组中添加元素，数组元素格式为安卓用户:应用包名，元素之间用空格隔开。即可仅代理相应安卓用户应用。例如user_packages_list=("0:com.termux" "10:org.telegram.messenger")代表代理用户 0 的 Termux 和用户 10 的 Telegram -
proxy_mode的值为core时，透明代理不会工作，仅仅启动相应核心，这可以用来支持部分核心（sing-box、clash、mihomo）原生的 TUN 入站
高级用法
更改代理模式
-
Box 默认使用 TPROXY 透明代理 TCP + UDP，若检测到设备不支持 TPROXY，则自动使用 REDIRECT 仅代理 TCP
-
打开
/data/adb/box/scripts/box.config文件，修改proxy_method的值为REDIRECT或MIXED则使用 REDIRECT 代理 TCP，在核心（仅 sing-box、clash、mihomo支持 TUN）没有启用 TUN 时 UDP 不会被代理
更改启动 Box 服务的用户
-
Box 默认使用
root:net_admin用户用户组启动 -
打开
/data/adb/box/scripts/box.config文件，修改box_user_group的值为设备中已存在的UID:GID，此时 Box 使用的核心必须在/system/bin/目录中（可以使用 Magisk），且需要setcap二进制可执行文件，它被包含在 libcap 中
连接到 WLAN 或开热点时绕过透明代理
-
Box 默认透明代理本机、热点、USB 网络共享
-
打开
/data/adb/box/scripts/box.config文件，修改ignore_out_list数组添加wlan+元素则透明代理绕过 WLAN，热点不受影响 -
打开
/data/adb/box/scripts/box.config文件，修改ap_list数组删除wlan+元素则不透明代理热点（联发科机型可能为ap+而非wlan+，可使用 ifconfig 命令查看）
特定进程的透明代理
-
Box 默认透明代理所有进程
-
如果您希望 Box 代理所有进程，除了某些特定的进程，那么请打开
/data/adb/box/scripts/box.config文件，修改proxy_mode的值为blacklist（默认值），在gid_list数组中添加 GID 元素，GID 之间用空格隔开。即可不代理相应 GID 的进程 -
如果您希望只对特定的进程进行透明代理，那么请打开
/data/adb/box/scripts/box.config文件，修改proxy_mode的值为whitelist，在gid_list数组中添加 GID 元素，GID 之间用空格隔开。即可仅代理相应 GID 进程
小贴士：因为安卓 iptables 不支持 PID 扩展匹配，所以 Box 匹配进程是通过匹配 GID 间接达到的。安卓可以使用 busybox setuidgid 命令使用特定 UID 任意 GID 启动特定进程
进入手动模式
如果您希望完全通过运行命令来控制 Box 服务，只需新建一个文件 /data/adb/box/manual。在这种情况下，Box 服务不会在您的设备启动时自动启动，您也不能通过 Magisk Manager 或 KernelSU Manager 应用管理 Box 服务的启动或停止。
管理服务的启停
-
Box 服务脚本是
/data/adb/box/scripts/box.service -
例如，在测试环境中（Magisk version: 25200）
- 启动服务：
/data/adb/box/scripts/box.service start- 停止服务：
/data/adb/box/scripts/box.service stop- 重启服务：
/data/adb/box/scripts/box.service restart- 显示状态：
/data/adb/box/scripts/box.service status
管理透明代理是否启用
-
透明代理脚本是
/data/adb/box/scripts/box.tproxy -
例如，在测试环境中（Magisk version: 25200）
- 启用透明代理：
/data/adb/box/scripts/box.tproxy enable- 停用透明代理：
/data/adb/box/scripts/box.tproxy disable- 重载透明代理：
/data/adb/box/scripts/box.tproxy renew
其他说明
-
修改各核心配置文件时请保证相关配置与
/data/adb/box/scripts/box.config文件中的定义一致 -
Box 服务初次启动时（或使用 box.tproxy renew 命令）会将本机 IP 加入绕过列表防止流量环路，但仍建议如本机存在公网 IP 地址请将 IP 添加至
/data/adb/box/scripts/box.config文件中的intranet数组中 -
Box 服务的日志在
/data/adb/box/run目录
卸载
- 从 Magisk Manager，KernelSU Manager 或 APatch 应用卸载本模块，会删除
/data/adb/service.d/box4_service.sh文件，保留 Box 数据目录/data/adb/box - 可使用命令清除 Box 数据：
rm -rf /data/adb/box
更新日志
项目 Star 数增长趋势图
