boxproxy/box 模块教程

发布日期: 2026-09-24更新日期: 2026-10-12平台: Android(Magisk / KernelSU / APatch)类别: 客户端下载配置

boxproxy/box(项目自称 Box for Root)是一个面向 Android Root 环境的透明代理工具箱模块,可用 Magisk、KernelSU 或 APatch 刷入。它借鉴并延续了 box4magisk、AndroidTProxyShell 和 box_for_magisk 等项目的思路。

请注意,它和本站介绍的 Box for Root(taamarin/box_for_magisk) 是 不同的仓库,名称相近但由不同作者维护,目录和脚本也有差异,配置时以各自文档为准。

安装方式Magisk / KernelSU / APatch 模块
支持内核mihomo、sing-box、xray、v2fly、hysteria
网络模式TProxy、Redirect、Tun、Mixed、Enhance
工作目录/data/adb/box/

本文只讲软件本身,不推荐具体服务商。客户端只是工具,节点需要另外订阅;如果还没有订阅,可以先看 性价比机场挑选与防坑指南。

官方项目地址:https://github.com/boxproxy/box

刷入模块

  1. 从官方发布页下载模块 zip 包。
  2. 打开 Magisk、KernelSU 或 APatch 管理器,在“模块”页面选择从本地安装,选中 zip 包刷入。
  3. 按模块说明完成配置后重启手机。

刷入前请备份重要数据,并确认您知道如何在无法正常开机时禁用模块(例如 Magisk 的安全模式)。

目录与脚本

  • /data/adb/box/settings.ini:全局配置文件,选择内核和网络模式。
  • /data/adb/box/mihomo/:mihomo 配置目录,机场的 Clash 订阅配置放在这里。sing-box、xray 等内核各有对应目录。
  • scripts/box.service:启停、重启、状态和定时任务。
  • scripts/box.iptables:透明代理规则的启用、重建和清理。
  • scripts/box.tool:订阅更新、Geo 更新、内核更新、配置检查和 WebUI 维护。
  • run/:运行状态与日志。

使用机场订阅

在 settings.ini 中把内核设为 mihomo,然后在 mihomo 配置目录的配置文件中填入机场的 Clash / Mihomo 订阅(通常写在 proxy-providers 中)。保存后在模块管理器中重新开关模块即可生效,订阅和 Geo 数据可以用 box.tool 更新。详细参数请查看项目 Wiki。

常见问题 (FAQ)

它和 box_for_magisk 能同时装吗?

不能。两者都使用 /data/adb/box/ 目录并接管透明代理规则,只能二选一。

模式该选哪个?

大多数设备选 TProxy 即可兼顾 TCP 和 UDP;设备不支持时再尝试 Tun 或 Mixed。