Termux 运行 glibc 应用的非 proot 方案启示

Termux 默认使用 Android 的 Bionic libc，无法直接运行为 glibc 编译的 Linux 二进制文件。传统方案是通过 proot-distro 安装完整的 Debian/Ubuntu 环境，但这种方式存在明显缺点：占用空间大（数百 MB 到数 GB）、性能开销高（syscall 模拟）、环境隔离复杂。

本文介绍一种更轻量的方案：使用 glibc-runner 直接在 Termux 中运行 glibc 二进制文件，无需 proot，无需完整 Linux 发行版。这个方案特别适合运行单个或少量 glibc 工具，如某些闭源软件、预编译的开发工具等。

方案原理

glibc-runner 方案的优势

glibc-runner 是 Termux 社区开发的工具，核心思路是：

1. 提供预编译的 glibc 库文件（libc.so.6、ld-linux-aarch64.so.2 等）
2. 通过 LD_LIBRARY_PATH 和动态链接器注入，让 glibc 二进制文件加载正确的库
3. 系统调用直接走 Android 内核，无需 proot 的 syscall 模拟层

关键优势：

• ✅ 轻量：只需安装 glibc 库文件（约 10-20MB），无需完整发行版
• ✅ 性能：syscall 直接调用内核，无 proot 开销
• ✅ 简单：单一 Termux 环境，无需管理 proot 容器

适用场景：

• 运行单个 glibc 二进制文件（如某些闭源工具、预编译的开发工具）
• 不需要完整 Linux 发行版的包管理和系统服务
• 对性能和空间敏感的场景

在 Termux 中运行 glibc 应用

下面演示如何使用 glibc-runner 在 Termux 中运行 glibc 二进制文件。

1. 安装 glibc-runner

1
# 安装 glibc-repo（添加 glibc-packages 仓库源）
2
pkg install -y glibc-repo
3

4
# 刷新包列表
5
pkg update
6

7
# 安装 glibc-runner
8
pkg install -y glibc-runner
9

10
# 验证安装
11
grun --version

说明：

• glibc-repo 是一个元包，安装后会在 $PREFIX/etc/apt/sources.list.d/ 添加 glibc-packages 仓库
• 必须先安装 glibc-repo 并 pkg update，否则 glibc-runner 包不可见
• grun 是 glibc-runner 提供的命令，用于运行 glibc 二进制文件

2. 基本使用方法

假设你有一个 glibc 编译的 ARM64 二进制文件 myapp：

1
# 直接用 grun 运行
2
grun ./myapp --help
3

4
# 传递参数
5
grun ./myapp arg1 arg2
6

7
# 配合管道使用
8
echo "test" | grun ./myapp

3. 创建包装脚本（推荐）

为了方便使用，可以创建一个包装脚本，这样就不需要每次都输入 grun：

1
# 创建包装脚本
2
cat > $PREFIX/bin/myapp << 'EOF'
3
#!/data/data/com.termux/files/usr/bin/sh
4
exec grun /path/to/real/myapp "$@"
5
EOF
6

7
chmod 755 $PREFIX/bin/myapp
8

9
# 现在可以直接调用
10
myapp --help

4. 验证 ELF 文件类型

在运行前，建议先验证二进制文件是否为有效的 ARM64 glibc ELF：

1
# 使用 file 命令
2
file ./myapp
3
# 应输出：ELF 64-bit LSB executable, ARM aarch64, ...
4

5
# 使用 readelf 查看动态链接器
6
readelf -l ./myapp | grep interpreter
7
# 应包含：/lib/ld-linux-aarch64.so.2 或类似路径

手动验证 ELF magic number：

1
# 读取文件头前 4 字节（ELF magic: 7f 45 4c 46）
2
od -An -tx1 -N4 ./myapp | tr -d ' \n'
3
# 应输出：7f454c46
4

5
# 读取 e_machine 字段（offset 18，ARM64 = 0xb7）
6
od -An -tx1 -j18 -N1 ./myapp | tr -d ' \n'
7
# 应输出：b7

5. 处理依赖的子进程

如果你的应用会调用其他 glibc 二进制文件作为子进程，也需要为它们创建 grun 包装：

1
# 假设应用依赖 vendor/tool
2
mv vendor/tool vendor/tool.real
3

4
cat > vendor/tool << 'EOF'
5
#!/data/data/com.termux/files/usr/bin/sh
6
exec grun "$(dirname "$0")/tool.real" "$@"
7
EOF
8

9
chmod 755 vendor/tool

或者替换为 Termux 原生工具（如果有）：

1
# 例如用 Termux 的 ripgrep 替换 glibc 版本
2
pkg install -y ripgrep
3
rm -f vendor/rg
4
ln -s $(command -v rg) vendor/rg

6. 环境变量和配置

某些应用可能需要特定的环境变量：

1
# 设置环境变量后运行
2
export MY_CONFIG=/path/to/config
3
grun ./myapp
4

5
# 或在包装脚本中设置
6
cat > $PREFIX/bin/myapp << 'EOF'
7
#!/data/data/com.termux/files/usr/bin/sh
8
export MY_CONFIG=/path/to/config
9
exec grun /path/to/real/myapp "$@"
10
EOF

自动化脚本示例

以下是一个通用的自动化安装脚本模板：

1
#!/data/data/com.termux/files/usr/bin/bash
2
set -euo pipefail
3

4
readonly APP_NAME="myapp"
5
readonly APP_BINARY="/path/to/glibc/binary"
6
readonly WRAPPER_PATH="$PREFIX/bin/$APP_NAME"
7

8
# 检查 Termux 环境
9
if [ ! -d "$PREFIX" ]; then
10
    echo "Error: Must run in Termux"
11
    exit 1
12
fi
13

14
# 安装 glibc-runner
15
echo "Installing glibc-runner..."
16
pkg install -y glibc-repo
17
pkg update
18
pkg install -y glibc-runner
19

20
# 验证二进制文件
21
if [ ! -f "$APP_BINARY" ]; then
22
    echo "Error: Binary not found: $APP_BINARY"
23
    exit 1
24
fi
25

26
# 检查 ELF magic
27
magic=$(od -An -tx1 -N4 "$APP_BINARY" 2>/dev/null | tr -d ' \n')
28
if [ "$magic" != "7f454c46" ]; then
29
    echo "Error: Not a valid ELF file"
30
    exit 1
31
fi
32

33
# 创建包装脚本
34
cat > "$WRAPPER_PATH" << EOF
35
#!/data/data/com.termux/files/usr/bin/sh
36
exec grun "$APP_BINARY" "\$@"
37
EOF
38

39
chmod 755 "$WRAPPER_PATH"
40

41
# 验证安装
42
echo "Verifying installation..."
43
grun "$APP_BINARY" --version
44
"$WRAPPER_PATH" --version
45

46
echo "Installation complete!"
47
echo "Run with: $APP_NAME"

性能对比

在 ARM64 Android 设备上的简单测试（运行一个中等大小的 glibc 应用）：

结论：

• 启动速度提升约 65%
• 内存占用减少约 33%
• 磁盘占用减少约 98%

适用范围与限制

适用场景

✅ 运行单个或少量 glibc 二进制文件
✅ 不需要完整 Linux 发行版的包管理
✅ 对性能和空间敏感
✅ 应用不依赖复杂的系统服务（systemd、dbus 等）

已知限制

❌ 不支持复杂依赖：如果应用依赖大量 glibc 专有库或系统服务，可能仍需 proot
❌ 调试困难：glibc 和 Bionic 混用可能导致难以排查的问题
❌ 兼容性风险：某些 syscall 在 Android 内核上行为可能与标准 Linux 不同

故障排查

问题 1：grun 提示找不到动态链接器

1
error: cannot execute binary file: Exec format error

解决： 确认二进制文件是 ARM64 架构，使用 file 命令检查：

1
file $CLAUDE_BINARY
2
# 应输出：ELF 64-bit LSB executable, ARM aarch64, ...

问题 2：运行时提示缺少 glibc 库

1
error while loading shared libraries: libc.so.6: cannot open shared object file

解决： 重新安装 glibc-runner：

1
pkg reinstall glibc-runner
2
grun --version  # 验证安装

问题 3：子进程调用失败

如果应用内部调用的子进程报错，检查这些子进程是否也是 glibc 二进制：

1
# 查找应用目录下的所有 ELF 文件
2
find /path/to/app -type f -exec file {} \; | grep ELF
3

4
# 对 glibc 二进制创建 grun 包装

如果发现是 glibc ELF，需要按前文方法创建包装脚本。

扩展应用

这个方案可以用于各种 glibc 应用：

运行其他 glibc 工具

1
# 下载某个 glibc 二进制工具
2
wget https://example.com/tool-linux-arm64
3

4
# 直接用 grun 运行
5
grun ./tool-linux-arm64 --help

创建通用包装脚本

1
# 为任意 glibc 二进制创建包装
2
create_grun_wrapper() {
3
  local binary="$1"
4
  local wrapper="$2"
5
  cat > "$wrapper" << EOF
6
#!/data/data/com.termux/files/usr/bin/sh
7
exec grun "$binary" "\$@"
8
EOF
9
  chmod 755 "$wrapper"
10
}
11

12
# 使用示例
13
create_grun_wrapper /path/to/glibc-app $PREFIX/bin/myapp

总结

glibc-runner 为 Termux 提供了一种轻量、高效的 glibc 应用运行方案：

• 无需 proot：直接在 Termux 环境运行，syscall 无额外开销
• 空间友好：仅需 10-20MB glibc 库，无需完整发行版
• 性能优异：启动速度和运行效率显著优于 proot 方案

对于只需运行少量 glibc 二进制文件的场景（如某些闭源工具、预编译的开发工具），这是比 proot-distro 更优的选择。

参考资源

• termux-pacman/glibc-packages - glibc-runner 官方仓库
• glibc-packages Wiki - 详细文档
• Termux Wiki - Termux 官方文档