tsu：Termux环境下的root权限管理工具

功能亮点

核心价值

在移动设备开发和测试过程中，经常需要执行系统级操作。tsu作为Termux专用的root权限管理工具，提供了类似Linux系统中sudo的功能，让你无需离开Termux环境即可安全地获取和管理root权限。

[!TIP] 核心功能卡片

• 🔧 无缝切换：一键获取root权限，无需重启Termux
• 🛠️ 灵活配置：支持指定shell环境和PATH路径管理
• 🔄 sudo兼容：提供简化版sudo实现，兼容多数需要root权限的操作

tsu与传统sudo功能对比

功能特性	tsu	传统sudo
适用环境	Termux专用	通用Linux系统
权限切换	仅root用户	支持多用户权限切换
路径管理	内置-p/-a参数调整PATH	需要手动配置
调试模式	提供--dbg选项	需通过系统日志
依赖要求	无额外依赖	需系统级安装

快速上手

准备工具

• Android设备（已开启开发者选项并激活USB调试）
• Termux应用（最新版本）
• ADB工具（可选，用于电脑端操作）

执行命令

# 安装Git（如果尚未安装）
pkg install git -y

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/ts/tsu

# 进入项目目录
cd tsu

# 生成可执行脚本
python3 extract_usage.py

# 赋予执行权限
chmod +x tsu

# 移动到系统可执行路径
mv tsu /data/data/com.termux/files/usr/bin/

验证结果

# 验证安装是否成功
tsu --version

# 尝试获取root权限
tsu

# 验证root权限是否生效
whoami  # 应输出"root"

[!TIP] 参数组合示例

• 同时使用-p和-s参数：tsu -p -s /data/data/com.termux/files/usr/bin/bash 该命令会将系统二进制文件路径前置，并使用指定的bash作为shell环境

深度解析

环境配置

硬件兼容性列表

• 推荐设备：Android 7.0及以上版本的设备
• 最低配置：1GB RAM，100MB可用存储空间
• 兼容架构：ARM、ARM64、x86（部分设备可能需要额外配置）

详细功能说明

基本使用

当你需要临时获取root权限执行系统命令时，只需在Termux中输入：

tsu

高级选项

[!TIP] 常用参数说明

• --dbg：启用调试模式，输出详细执行过程
• -s <shell>：指定替代shell，如tsu -s zsh
• -p：将系统二进制文件路径前置到PATH
• -a：将系统二进制文件路径附加到PATH
• -h/--help：显示帮助信息
• --version：显示版本信息

典型使用场景

1. 系统文件操作

# 以root权限编辑系统配置文件
tsu nano /etc/profile

2. 安装系统级软件

# 使用apt安装需要root权限的包
tsu apt install -y some-package

3. 自定义shell环境

# 使用bash并前置系统路径
tsu -p -s /data/data/com.termux/files/usr/bin/bash

风险提示

⚠️ 安全风险：获取root权限可能导致设备保修失效，并带来潜在安全风险。请确保只在必要时使用tsu，并了解每个操作的后果。

⚠️ 数据安全：以root身份执行命令可能意外删除或修改系统关键文件，建议在操作前备份重要数据。

⚠️ 兼容性问题：部分设备可能因厂商限制而无法正常使用tsu功能。

常见问题速查

Q1: 执行tsu后提示"permission denied"

A: 确保设备已正确root，可尝试重新安装Magisk或其他root工具。

Q2: 运行extract_usage.py时报Python错误

A: 检查Python版本是否为3.x，使用python3 --version确认，如未安装可通过pkg install python安装。

Q3: tsu命令找不到

A: 检查是否已将tsu移动到正确路径，或手动将安装目录添加到PATH：export PATH=$PATH:/path/to/tsu/directory

Q4: 切换root后命令提示符不变

A: 这是正常现象，可通过echo $UID确认是否为0（root用户UID）。

Q5: 使用-p参数后部分命令无法执行

A: 系统路径可能包含与Termux冲突的程序，尝试使用-a参数替代或手动指定命令完整路径。

许可证说明

• 核心代码：遵循ISC许可证
• 依赖库：部分代码来自excode项目，遵循MIT许可证

详细许可条款请参见项目根目录下的LICENSE.md和LICENSE_MIT文件。