5.2 KiB
5.2 KiB
PRoot 环境下 apt install perl 失败问题修复计划
一、问题现象与背景
在 Ubuntu / Debian 容器环境中执行 apt install perl 时报错:
dpkg: error processing archive /var/cache/apt/archives/perl_5.38.2-3.2ubuntu0.4_arm64.deb (--unpack):
error setting ownership of '/usr/bin/perlthanks.dpkg-new': No such file or directory
二、底层根因分析(深度对标 Termux / proot-distro)
1. 核心诱因:硬链接解包转换
- Perl 软件包在解压时,
/usr/bin/perlthanks是指向/usr/bin/perlbug的硬链接(Hard Link)。 - Android 应用私有目录下,底层文件系统/SELinux 策略禁止非 root 应用直接创建硬链接(
link(2)返回EPERM)。 - PRoot 启用了
--link2symlink,它将硬链接拦截并转换为:指向.l2s目录下替身文件的符号链接(Symlink)。
2. 缺陷一:.l2s 目录路径错位(位于 Rootfs 外部)
- 现状:
在
lib/services/distro_manager.dart中:该路径在宿主为final l2sDir = Directory(p.join(baseDir.path, systemName, '.l2s'));<baseDir>/<systemName>/.l2s,而容器 Rootfs 为<baseDir>/<systemName>/rootfs。.l2s位于 Rootfs 外部。 - Termux 官方规范:
在 Termux
proot-distro的l2s.py源码中明确声明:(proot-distro sets it to <rootfs>/.l2s) - 导致的问题:
PRoot 在创建替身符号链接时,记录的是绝对路径。当
.l2s位于 rootfs 外时,PRoot 内部的路径逆向规范化(detranslate_path)无法将其识别为容器内合法路径;容器内应用跟随链接访问时也无法访问容器外的宿主目录,从而触发ENOENT(No such file or directory)。
3. 缺陷二:libfix_seccomp.so 遗漏导出 chown 与 lchown 符号
- 现状:
此前为 Alpine(musl libc)修复
apk add tzdata时,Shim 仅拦截了fchownat,因为 musl 的chown/lchown内部均调用fchownat。 - Ubuntu/Debian (glibc) 差异:
dpkg在解包硬链接后会直接调用chown(fnamenew, uid, gid)。- glibc 的
chown()函数实现是直接执行内联系统调用指令(inline syscallsvc 0),并不走fchownat的 PLT 动态重定位跳转。 - 因此
dpkg调用的chown彻底绕过了 Shim 的fchownat拦截,直达 PRoot/内核。PRoot 在跟随 l2s 替身链接时返回ENOENT。
三、修改计划与实施步骤
步骤 1:Dart 端 .l2s 路径对标 Termux 并自动迁移
修改文件:lib/services/distro_manager.dart
- 将
_ensureL2sDir(String systemName)升级为_ensureL2sDir(String systemName, Directory rootDir):- 目录指向
p.join(rootDir.path, '.l2s')。 - 若此前存在旧路径
<baseDir>/<systemName>/.l2s且内含文件,自动平滑移动至新位置。
- 目录指向
- 环境变量配置:
- PRoot 宿主环境传递:
'PROOT_L2S_DIR': l2sDir.path。 - 容器内 guest 环境变量同步注入:
'PROOT_L2S_DIR=/.l2s'。
- PRoot 宿主环境传递:
步骤 2:Debian / Ubuntu 环境部署 dpkg 优化配置
修改文件:lib/services/distro_installer.dart
- 新增
ensureDpkgConfiguration(Directory rootfsDir)方法:- 检查
etc/dpkg是否存在(判断是否为 Debian/Ubuntu 环境)。 - 确保
/etc/dpkg/dpkg.cfg.d/目录存在。 - 写入
/etc/dpkg/dpkg.cfg.d/01_proot,内容包含:force-unsafe-io - 避免容器内因 fsync / flash I/O 阻塞或权限校验引发的解包异常(Docker / proot-distro 官方推荐实践)。
- 检查
- 在
postInstallConfigure与容器启动检查中自动调用。
步骤 3:Shim (libfix_seccomp.c) 补充 chown 与 lchown 导出
修改文件:android/app/src/main/cpp/libfix_seccomp.c
- 增加标准
chown和lchown导出符号:__attribute__((visibility("default"))) int chown(const char *path, int owner, int group) { return fchownat(AT_FDCWD, path, owner, group, 0); } __attribute__((visibility("default"))) int lchown(const char *path, int owner, int group) { return fchownat(AT_FDCWD, path, owner, group, AT_SYMLINK_NOFOLLOW); } - 如此一来,无论是 glibc 还是 musl 的应用程序直接调用
chown或lchown,均会走入已有的fchownat机制:在遭遇ENOENT时自动以AT_SYMLINK_NOFOLLOW重试设置替身属性,保证硬链接解压 100% 成功。
四、验证与验收方案
- 单元测试回归:
- 运行全量单元测试:
flutter test(确保现有 282 项测试无任何回退)。 - 增加关于
.l2s位于rootDir/.l2s以及dpkg.cfg.d/01_proot的自动化测试用例。
- 运行全量单元测试:
- 静态分析:
- 运行
flutter analyze确保无任何语法和类型告警。
- 运行
- 真实场景(Ubuntu 容器)验证:
- 在容器中执行
apt update && apt install perl -y。 - 验证
/usr/bin/perlthanks与/usr/bin/perlbug成功安装且解包 ownership 正确设置,退出码为 0。
- 在容器中执行