4.5 KiB
4.5 KiB
容器自检工具(container-selfcheck)
在 Android app 进程内的 PRoot 容器里做系统调用级自检,用于定位"某个 syscall 被平台策略
拦掉 / PRoot 语义不对"这类问题。本目录是 2026-09-13 排查 apk temporary error /
Failed to preserve modification time 时用的工具,已固化为可复用资产。
结论与证据见仓库根目录 CONTAINER_FIX_SUMMARY.md。
组件
| 文件 | 作用 |
|---|---|
probe3.c |
系统调用策略自检:poll/ppoll/select/pselect6/epoll_wait(epoll_pwait)/fcntl/ioctl/utimensat/fstat/statfs/clone/unshare/chroot/getrandom。支持 x86_64 与 arm64(两者系统调用表不同,代码里已按架构区分)。 |
probe4.c |
复现 apk 安装动作序列:建目录 → openat 解包 → utimensat 保 mtime → linkat 硬链接 → renameat 改名,用来定位 PRoot --link2symlink 的问题。 |
probe5.c |
检查 PRoot 对空路径 newfstatat(fd,"",st,AT_EMPTY_PATH) 的处理(曾用于判定旧 workaround 是否还必要)。 |
selfcheck.sh |
容器内一键验收:apk update / 硬链接包全新安装 / 带触发器安装 / broken 标记 / 三个 probe。 |
guest-run.sh |
免重装 APK 的 adb 侧跑手:用 pm path 推导原生库目录,自己拼 PRoot 命令行,在容器里执行任意命令。 |
编译探针
NDK=<ndk>/toolchains/llvm/prebuilt/<host>/bin
# arm64 真机
"$NDK/clang" --target=aarch64-linux-android21 -nostdlib -static -fno-stack-protector -O1 -o probe3 probe3.c
# x86_64 模拟器
"$NDK/clang" --target=x86_64-linux-android21 -nostdlib -static -fno-stack-protector -O1 -o probe3 probe3.c
无 libc、无依赖:所有系统调用直接发 svc #0 / syscall,结果用 write(2) 打印。
用法(真机 / 模拟器都适用)
前提:app 为 debug 构建(run-as 需要),设备已连 adb。
PKG=com.example.code_editor
BASE=/data/data/$PKG/files/distros/alpine
R=$BASE/rootfs
# 1) 把探针与自检脚本放进容器
adb push probe3 /data/local/tmp/probe3
adb push selfcheck.sh /data/local/tmp/selfcheck.sh
adb shell "run-as $PKG sh -c 'cat /data/local/tmp/probe3 > $R/root/probe3; chmod 755 $R/root/probe3; \
cat /data/local/tmp/selfcheck.sh > $R/root/selfcheck.sh; chmod 755 $R/root/selfcheck.sh'"
# 2) 在容器里跑(adb 侧免重装)
adb shell "run-as $PKG sh /data/local/tmp/guest-run.sh /bin/sh /root/selfcheck.sh"
# 或者:push guest-run.sh 后
adb shell "run-as $PKG sh /data/local/tmp/guest-run.sh /root/probe3"
# 3) 读结果
adb shell "run-as $PKG cat $R/root/acc.log"
在「App 自己的终端会话」里跑(需要 app 上下文时)
App 上下文(有 zygote 装上的 seccomp filter)才是线上真实环境。两种方式:
- 直接在终端里敲:
sh /root/selfcheck.sh - 免打字:把钩子挂到
/etc/profile.d,新会话自动执行(本目录不含该钩子文件,按需创建):然后重启 App 并进入终端页,结果写入# <rootfs>/etc/profile.d/zz-selfcheck.sh ( sh /root/selfcheck.sh >/dev/null 2>&1 ) &/root/acc.log。
两条铁律
- 不要在容器运行中原地覆盖
/lib/libfix_seccomp.so:正在映射该文件的进程会 SIGSEGV (实测:会话proot info: vpid 1: terminated with signal 11)。必须 「写临时文件 →mv重命名」。 - 换 shim 后需要新起进程才生效:已运行的进程仍映射旧库。用
am force-stop重启 App, 或直接新开一个会话。
已定位(供参考,不必重跑)
| 现象 | 结论 |
|---|---|
apk 报 temporary error (try again later) |
x86_64 专属:arm64 无 poll/select 系统调用;x86_64 有且被 app seccomp 封为 ENOSYS,musl 的 #ifdef SYS_poll 命中 ⇒ 解析器超时 ⇒ EAI_AGAIN。 |
apk 报 IO ERROR |
同上(select),libfetch 失败时不设错误码。 |
Failed to preserve modification time(tzdata 等硬链接包) |
跨架构:Android 禁止 link(2) ⇒ PRoot 用 symlink + .proot-meta-file.* 模拟 ⇒ apk 跟随语义的 utimensat 落到隐藏名 ⇒ ENOENT ⇒ 包被标 broken。 |
newfstatat(fd,"",st,AT_EMPTY_PATH) |
PRoot 处理正常(=0),旧的 workaround 已删除。 |
--sysvipc |
本项目 libproot.so 不支持(unknown option),不能加;Termux 的 proot 是带 libandroid-shmem 的 fork 版。 |
openat(dir, O_DIRECTORY) |
在本项目 proot 下返回 EINVAL(`O_PATH |