## 项目简介
SudoBox 是一款面向 Android (12+) 临时 Root 设备的移动 GNU/Linux 工作台。它融合 Termux 的终端体验与 Linux Deploy 的容器编排能力，为开发者提供一个“随用随开、用完即走”的纯净 Linux 环境。
- **Root 独立性**：基于 KernelSU / Magisk 模块（模块 id `chroot-mgr`，显示名 SudoBox Service），全局至多运行一个容器实例，确保系统稳定性。
- **零修改原则**：利用 `unshare -m + chroot` 技术，不篡改系统分区，卸载后无残留。
- **原生终端体验**：深度复用 Termux 的 terminal-emulator / terminal-view 组件（PTY/JNI 与渲染），保证输入法兼容与视觉效果。
- **组件化架构**：移植 Linux Deploy 的组件机制（mnt / net / profile + 部署钩子），支持按需插拔。
## 核心特性
| 特性 | 描述 |
|------|------|
| **按需提权** | 通过 KernelSU 获取 Root，仅在容器启动瞬间提权，用完即还 |
| **双层界面** | Jetpack Compose 控制面 + Termux 核心终端渲染 |
| **多发行版** | Alpine / Ubuntu / Kali 在线安装；Debian 及任意 rootfs 压缩包导入（tar.gz / tar.xz / tar.bz2 / tar.zst） |
| **双 Shell 入口** | `root` 强制 Root 进入；`enter` 按配置落到容器内非 root 用户（setpriv 直降权，不经 PAM） |
| **多级保活** | App `KeepAliveService`（前台服务 + WakeLock）＋ 模块 `guard` watchdog（cgroup 防冻结、崩溃自愈）＋ 全局监督 `daemon` |
| **自定义终端** | 内置 17 种配色方案、导入自定义字体、多会话 Tab（本地 / 容器 / Root 多开） |
## 技术栈
- **系统环境**：Android 12+（minSdk 31）
- **Root 方案**：KernelSU（兼容 Magisk）
- **容器引擎**：`unshare -m` + `chroot`
- **终端模拟**：Termux 组件（terminal-emulator / terminal-view，JNI）
- **UI 框架**：Jetpack Compose（Material 3）
- **模块主控**：POSIX sh 单文件脚本 `chroot-mgr`（依赖模块自带 busybox）
- **许可协议**：GPL-3.0
## 项目结构
```
SudoBox/
├── module/ # 📦 KernelSU / Magisk 可刷入模块
│ ├── module.prop # 模块元数据（id=chroot-mgr, name=SudoBox Service）
│ ├── customize.sh # 幂等安装脚本（PATH 注入、升级对账清理）
│ ├── service.sh # 开机自启服务（boot-restore 门控，默认关闭）
│ ├── action.sh # KSU 管理器“操作”按钮的免 App 控制面
│ ├── bin/
│ │ ├── chroot-mgr # 核心管理程序（POSIX sh 单文件实现，v0.1.26）
│ │ ├── chroot-enter.sh # 容器进入 helper（unshare -m 私有 ns 补挂载 + exec chroot）
│ │ ├── net.sh # DNS / 网络配置工具
│ │ └── busybox # 模块自带 busybox（aarch64 静态 musl）
│ ├── distro/ # 发行版描述符（alpine / ubuntu / kali 在线；debian 需导入）
│ ├── include/
│ │ ├── core/ # 组件：mnt（挂载/mtab）、net（网络/DNS）、profile（shell 环境/motd）
│ │ └── hooks/ # 部署钩子：dns、hosts、apk-repos、seccomp-off-apt、pacman-key
│ └── sepolicy.rule # SELinux 策略（最小精确规则，如 App 读 /proc/loadavg）
└── app/ # 📱 Android 控制应用（v0.1.40）
├── app/ # 主应用模块
│ ├── backend/ # ChrootBackend（su 桥接 chroot-mgr，JSON 状态解析）
│ ├── ui/ # Compose UI（仪表盘 / 容器 / 设置 + 终端覆盖页）
│ ├── terminal/ # 终端会话管理（Tab 元数据 / Session Registry / 字体）
│ ├── service/ # KeepAliveService + TerminalSessionHostService
│ └── prefs/ # 偏好持久化（主题 / 保活 / 配色 / 字体）
├── terminal-emulator/ # Termux 终端模拟核心（JNI）
└── terminal-view/ # Termux 终端视图组件
```
## 快速开始
### 1. 准备工作
- 一台 **Android 12+** 设备，已通过 KernelSU 完成临时 Root（越狱 / GKI 内核模式）
- 或一台已解锁 Bootloader、永久刷入 KernelSU 的设备（可选场景，建议搭配 DroidSpaces）
- 设备已安装 KernelSU / Magisk 管理器
- PC 侧已安装 Android SDK（或 ADB）
### 2. 安装 SudoBox 模块
模块本体即 `module/` 目录：`chroot-mgr` 为 POSIX sh 脚本、`busybox` 为预编译静态二进制，无需设备端编译。将其打包为 ZIP 后在 KernelSU / Magisk 管理器中刷入并重启：
```bash
cd module
zip -r ../SudoBox-service-v0.1.26.zip . -x '*.git*'
```
安装时 `customize.sh` 会自动完成全局 PATH 注入（`chroot-mgr path install`）。模块安装后可通过 `su -c chroot-mgr 
