--- name: termux-su-wrapper title: Termux SU Wrapper version: 1.0.0 description: Termux 自带的 su wrapper 脚本路径、行为和使用方法 author: user tags: [termux, su, root, wrapper, android] --- # Termux SU Wrapper ## 路径 Termux 自带的 su wrapper 脚本位于: ``` /data/data/com.termux/files/usr/bin/su ``` 该路径已经在 Termux 默认 PATH 中(`/data/data/com.termux/files/usr/bin`),直接运行 `su` 即可调用。 ## 脚本行为 wrapper 脚本内容: ```sh #!/data/data/com.termux/files/usr/bin/sh unset LD_LIBRARY_PATH LD_PRELOAD for p in /debug_ramdisk/su /sbin/su /system/sbin/su /system/bin/su /system/xbin/su /su/bin/su /magisk/.core/bin/su do if [ -x $p ]; then PATH=/debug_ramdisk:/sbin:/sbin/su:/su/bin:/su/xbin:/system/bin:/system/xbin \ exec $p "$@" fi done echo "No su program found on this device. Termux" echo "does not supply tools for rooting, see e.g." echo "http://www.androidcentral.com/root for" echo "information about rooting Android." exit 1 ``` ### 关键点 1. **不是真正的 root su** — 只是一个搜索器/转发器 2. **搜索路径顺序**: - `/debug_ramdisk/su` - `/sbin/su` - `/system/sbin/su` - `/system/bin/su` - `/system/xbin/su` - `/su/bin/su` - `/magisk/.core/bin/su` 3. **找到后 exec 替换** — 用 `"$@"` 传递所有参数 4. **设置 PATH** — 确保 su 能找到依赖工具 5. **清除 LD_LIBRARY_PATH / LD_PRELOAD** — 避免 Termux 库污染系统二进制 ## 当前设备状态 运行 `su -c "id"` 返回: ``` No su program found on this device. ``` 说明当前设备 **尚未 root**,没有可用的真实 su 二进制文件。 ## 使用方式 ### 标准用法(设备已 root 时) ```sh # 获取 root shell su # 单条命令 su -c "id" # 带环境变量 su -c "env VAR=val command" ``` ### Magisk 特有用法(如果安装了 Magisk) ```sh # 切换到指定 UID 和组(Termux 装包时用到) su -G 3003 -c "command" # 示例:以 Termux app UID 运行 apt su -G 3003 $(stat -c %u /data/data/com.termux) -c "apt update" ``` 注意:`su -G` 是 Magisk su 的扩展参数,标准 su 不支持。 ## 故障排查 | 症状 | 原因 | 解决 | |------|------|------| | `No su program found` | 设备未 root | 使用 Magisk 等工具 root 设备 | | `Permission denied` | SELinux 限制 | 检查 SELinux 状态:`getenforce` | | `command not found` | PATH 问题 | 使用绝对路径调用命令 | ## 相关文件 - wrapper 脚本:`/data/data/com.termux/files/usr/bin/su` - 真实 su 搜索路径:见上文列表 - Magisk su(如果已安装):`/data/adb/magisk/su` ## 记录时间 2026-06-25 — 当前设备未 root,su wrapper 可用但无法转发到真实 su。