SKILL.md
2.72 KB
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 脚本内容:
#!/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
关键点
- 不是真正的 root su — 只是一个搜索器/转发器
- 搜索路径顺序:
/debug_ramdisk/su/sbin/su/system/sbin/su/system/bin/su/system/xbin/su/su/bin/su/magisk/.core/bin/su
- 找到后 exec 替换 — 用
"$@"传递所有参数 - 设置 PATH — 确保 su 能找到依赖工具
- 清除 LD_LIBRARY_PATH / LD_PRELOAD — 避免 Termux 库污染系统二进制
当前设备状态
运行 su -c "id" 返回:
No su program found on this device.
说明当前设备 尚未 root,没有可用的真实 su 二进制文件。
使用方式
标准用法(设备已 root 时)
# 获取 root shell
su
# 单条命令
su -c "id"
# 带环境变量
su -c "env VAR=val command"
Magisk 特有用法(如果安装了 Magisk)
# 切换到指定 UID 和组(Termux 装包时用到)
su -G 3003 <termux-app-uid> -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。