tsu：Termux获取root权限的轻量级解决方案

一、核心价值模块

解决的核心问题

在Termux环境中安全获取root权限，无需退出应用即可执行高级系统操作，为移动设备开发和调试提供便利。

与同类工具对比优势

• 无需复杂配置，轻量化设计
• 支持多种shell切换，适配不同操作习惯
• 提供路径管理功能，灵活调整系统环境

二、环境适配指南

Android设备配置清单

• 已开启开发者选项
• 激活USB调试功能
• 安装Termux应用
• 可选：电脑端安装ADB工具

基础环境准备

🔧 打开Termux，安装Git工具 🔧 克隆项目到本地 🔧 进入项目目录

三、场景化操作手册

基础使用（高频）

🔧 运行提取脚本生成可执行文件 验证标准：生成tsu可执行文件 🔧 赋予执行权限 🔧 移动到系统可执行路径 验证标准：输入tsu命令有响应

指定shell（中频）

🔧 使用-s参数指定shell路径 示例：tsu -s /path/to/shell

路径管理（中频）

🔧 -p参数：系统二进制文件路径前置 🔧 -a参数：系统二进制文件路径附加

调试模式（低频）

🔧 使用--dbg参数启用调试输出 示例：tsu --dbg

四、风险控制方案

权限管理

⚠️ 仅在必要时使用root权限 ⚠️ 避免在不信任的网络环境下使用

故障恢复

• 若命令执行失败，尝试重新生成tsu文件
• 路径问题可使用-p或-a参数调整系统路径

五、新手避坑指南

• 确保设备已正确获取root权限
• 移动tsu文件时注意目标路径的可写性
• 若提示"command not found"，检查系统PATH配置

六、技术参数卡片

• 适用系统：Android（Termux环境）
• 脚本语言：Shell
• 构建工具：Python 3.x
• 许可证：ISC（部分代码MIT）

七、项目结构树状图

tsu/
├── scripts/
│   ├── drun.sh
│   ├── lint.sh
│   ├── prettify.sh
│   ├── tadb
│   └── tsu_adb_helper
├── shell/
│   └── tsu.sh
├── LICENSE.md
├── LICENSE_MIT
├── README.md
└── extract_usage.py

⚠️ 注意：使用root权限可能导致设备保修失效，操作前请确保了解相关风险。本工具遵循ISC许可证，部分代码来自excode项目并遵循MIT许可证。