兔洞博客
兔洞博客
个人博客

KunBox:OLED 纯黑界面与规则集中心

KunBox

Compose 界面 · 双架构

平台Android
代理内核sing-box
开源状态开源(MIT)
价格免费
维护状态活跃维护(2026-10 更新)
最新版本v2.24.2(2026-10-04 发布)
最近提交2026-10-07
安装包共 2 个文件,下方列常用安装包
开发方roseforljh(GitHub 仓库所有者)
GitHub★ 349 · Fork 24
数据核验2026-10-11 · 来源 GitHub API
下载最新版 v2.24.2

不知道选哪个:Intel/AMD 电脑选 x64,苹果 M 系列芯片选 arm64,安卓手机一般选 arm64。

这是什么

KunBox 是围绕 sing-box libbox 构建的 Android 图形客户端,Jetpack Compose 界面没有照搬常见 Material 外观,而是主打 OLED True Black。

首页的耿鬼会随 VPN 状态变化,真正实用的部分则是规则集中心、UID 加包名的应用分流、系统快捷开关和桌面快捷方式。VPN 服务放在独立进程,UI 通过 IPC 读取状态。

适合谁

  • 使用 OLED 屏幕且喜欢纯黑界面的人:暗色不是简单换配色,而是项目明确的视觉主题
  • 需要精细应用分流的人:规则匹配同时使用 UID 与 Package Name
  • 经常从通知栏或桌面开关 VPN 的人:Quick Settings Tile 和快捷方式都由客户端提供

和同类怎么比

对比KunBoxMeow AndroidHusi
界面路线OLED 纯黑、耿鬼状态动画Compose 标签页与实时视图Compose 多端工程
分流重点规则集中心、UID + 包名域名/IP/端口/地理规则、分应用proxy-set 自定义
工程结构独立 VPN 进程 + IPCKotlin、Rust FFI 与 REST APIAndroid/桌面分别构建 libcore

一句话:KunBox 把视觉识别和 Android 快捷操作放在显眼位置,同时保留了规则集与多进程架构这条技术主线。

八卦生态

KunBox 是 2025 年 12 月建立的独立项目,仓库没有上游 fork 关系。README 从 OLED 美学一路写到 VPN 数据流,视觉和工程结构都公开得很细。

项目采用 MVVM 与 Clean Architecture,核心调用链写成 SingBoxService -> CoreManager -> BoxWrapperManager -> libbox.aar,并用 Room 与 MMKV 分别处理持久化和跨进程状态。

避坑

  • 订阅格式会影响能力边界:sing-box JSON 是原生格式;Clash YAML 会转换策略组,Standard Base64 则用于兼容常见订阅
  • APK 要按 CPU 架构选择:官方分别提供 arm64-v8a 与 armeabi-v7a 构建
  • 系统最低要求是 Android 7.0:更早版本不在 README 的支持范围内
  • 内核同步目录不要提交:.kernel-sync-local/ 只供本地工作区使用,脚本会排除 prerelease 条目

深入教程

协议导入、规则集、快捷操作和源码构建说明见 KunBox 官方仓库 的中文 README。

Kunbox sing-box 客户端 翻墙软件
工具与软件