跳转到内容

认识 B-box ​

B-box 是基于 sing-box-for-android 的非官方 Android 客户端,使用 FlClash 与 prism_ui 的 Flutter 界面组件。它保留 sing-box 的连接、代理与路由能力,并加入 MITM、HTTP 改写和 JavaScript 请求处理。

本指南主要讲如何观察和处理请求。代理协议与路由的完整说明,请查阅 sing-box 官方文档。

三个项目的关系 ​

名称在 B-box 中负责什么
sing-box / libbox协议、入站、出站、DNS、路由与服务运行
sing-box-for-androidAndroid 应用后端、VPN、配置和平台能力的基础
FlClash / prism_uiFlutter 界面与共享交互组件,参考 FlClash v0.9.3

B-box 的配置格式是 sing-box JSON。FlClash 风格的界面不改变配置格式;Clash YAML、Mihomo 提供者和覆写脚本不能直接使用。

先记住四个入口 ​

你想做什么入口控制对象
解密指定 HTTPS 域名配置 → 编辑 → MITMexperimental.mitm
修改 Header、URL、正文或 Mock配置 → 编辑 → HTTP 改写experimental.http_rewrite
编写请求、响应脚本或 Cron配置 → 编辑 → 脚本experimental.scripts
查看连接、保存和查看请求工具 → 连接与请求当前连接与本地抓取记录

这四项独立控制。停止请求记录后,已启用的解密、改写和脚本仍随本地服务运行。关闭 HTTP 改写,也不会关闭独立的 MITM 或脚本。

界面只需了解这些 ​

  • 仪表盘:启动与停止本地服务,查看流量和代理组等状态;右上角进入设置。
  • 代理:显示当前核心提供的代理组和节点。自动组由核心选择。
  • 配置:导入或新建 sing-box JSON,选择配置;编辑页直接提供各分项及“打开配置内容”。
  • 工具:进入连接与请求、日志和网络诊断等页面。

本指南的 MITM、证书和请求记录操作针对 本地服务。远程会话不能管理本机证书或读取本机请求记录。

获取应用与核对版本 ​

从 B-box 项目 的 Releases 查看可用 APK 与发布说明。项目声明的安装范围为 Android 7.0+、ARM64;具体以下载产物为准。

本文档依据 2026-11-11 的 B-box 源码整理。源码功能可能领先于已安装 APK。若页面入口或字段不同,先看资料来源与版本,再核对安装包对应的提交。

继续:跑通第一条请求。

B-box 中文指南 · 基于实际源码整理