Skip to content

Home

Jump to bottom
re-zero-0 edited this page Apr 4, 2026 · 4 revisions

Box Wiki

本文档只保留必要说明。详细背景介绍请看仓库 README。

目录

  • 下载
  • 安装
  • 更新与备份
  • 常用命令
  • FAQ
  • 反馈建议

下载

推荐两种方式：

  1. APP 内检查更新（推荐）
  2. GitHub Releases 手动下载

安装

支持：

  • Magisk
  • KernelSU
  • APatch

安装步骤：

  1. 在 Root 管理器中选择“从本地安装”
  2. 选择模块 zip
  3. 按安装脚本提示完成音量键选项

安装脚本会询问是否下载以下组件：

  • Geo 数据（GeoIP/GeoSite）
  • 工具（yq、curl）
  • 内核（sing-box、mihomo、mihomo_smart、xray、v2fly、hysteria）

快速使用（Mihomo）

推荐先完成这一步再做其他高级配置。

方式一：手动改配置文件

  1. 打开 /data/adb/box/mihomo/config.yaml
  2. 找到 填写订阅链接，替换成你自己的订阅链接
  3. 保存后启动服务
su -c /data/adb/box/scripts/box.service start && su -c /data/adb/box/scripts/box.iptables enable

方式二：APP 内更新订阅

  1. 打开 APP，进入 工具 → 订阅
  2. 在 mihomo 链接里填入你的订阅链接并保存
  3. 返回订阅页面，点击右侧下载/更新按钮
  4. 更新成功后，启动服务

更新与备份

检测到旧的 /data/adb/box 时，安装脚本会自动备份并恢复用户数据。

settings.ini 提供两种处理方式：

  • 增量合并（推荐）：保留旧配置键值，并写回新版已有键
  • 覆盖：使用新版默认配置

建议：

  1. 更新时优先选择“增量合并”
  2. 更新后执行一次重启服务

常用命令

所有命令均在 root 下执行。

服务管理

su -c /data/adb/box/scripts/box.service {start|stop|restart|status|cron|kcron}

透明代理规则

su -c /data/adb/box/scripts/box.iptables {enable|disable|renew}

工具脚本

su -c /data/adb/box/scripts/box.tool {check|memcg|cpuset|blkio|geosub|geox|subs|upkernel [name]|upkernels [name...]|upgeox_all|upxui|upyq|upcurl|upcnip|reload|webroot|bond0|bond1|all}

常用示例：

# 更新订阅并尝试热重载
su -c /data/adb/box/scripts/box.tool subs

# 更新 Geo 数据
su -c /data/adb/box/scripts/box.tool geox

# 更新指定内核
su -c /data/adb/box/scripts/box.tool upkernel sing-box

# 重置规则
su -c /data/adb/box/scripts/box.iptables renew

FAQ

1) 改了配置不生效

执行重启：

su -c /data/adb/box/scripts/box.service restart

2) 更新后配置丢了

重新安装并在 settings.ini 处理选项中选择“增量合并”。

3) 缺少 yq / curl

su -c /data/adb/box/scripts/box.tool upyq
su -c /data/adb/box/scripts/box.tool upcurl

4) 规则异常或网络不通

先重置规则，再重启服务：

su -c /data/adb/box/scripts/box.iptables disable
su -c /data/adb/box/scripts/box.iptables enable
su -c /data/adb/box/scripts/box.service restart

反馈建议

反馈问题时建议同时提供：

  1. 复现步骤
  2. 设备型号、Android 版本、Root 管理器版本
  3. 当前核心与 network_mode
  4. /data/adb/box/run 相关日志或 APP 日志截图

Clone this wiki locally