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

关键点

  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 时)

# 获取 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。