Files
LN-Code-Editor/PROOT_PERL_FIX_PLAN.md
2026-09-16 13:40:49 +08:00

94 lines
5.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PRoot 环境下 `apt install perl` 失败问题修复计划
## 一、问题现象与背景
在 Ubuntu / Debian 容器环境中执行 `apt install perl` 时报错:
```text
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` 中:
```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 syscall `svc 0`)**,并不走 `fchownat` 的 PLT 动态重定位跳转。
- 因此 `dpkg` 调用的 `chown` 彻底绕过了 Shim 的 `fchownat` 拦截,直达 PRoot/内核。PRoot 在跟随 l2s 替身链接时返回 `ENOENT`。
---
## 三、修改计划与实施步骤
### 步骤 1:Dart 端 `.l2s` 路径对标 Termux 并自动迁移
**修改文件**:[`lib/services/distro_manager.dart`](file:///d:/Flutter/Projects/code_editor/lib/services/distro_manager.dart)
1. 将 `_ensureL2sDir(String systemName)` 升级为 `_ensureL2sDir(String systemName, Directory rootDir)`:
- 目录指向 `p.join(rootDir.path, '.l2s')`。
- 若此前存在旧路径 `<baseDir>/<systemName>/.l2s` 且内含文件,自动平滑移动至新位置。
2. 环境变量配置:
- PRoot 宿主环境传递:`'PROOT_L2S_DIR': l2sDir.path`。
- 容器内 guest 环境变量同步注入:`'PROOT_L2S_DIR=/.l2s'`。
### 步骤 2:Debian / Ubuntu 环境部署 `dpkg` 优化配置
**修改文件**:[`lib/services/distro_installer.dart`](file:///d:/Flutter/Projects/code_editor/lib/services/distro_installer.dart)
1. 新增 `ensureDpkgConfiguration(Directory rootfsDir)` 方法:
- 检查 `etc/dpkg` 是否存在(判断是否为 Debian/Ubuntu 环境)。
- 确保 `/etc/dpkg/dpkg.cfg.d/` 目录存在。
- 写入 `/etc/dpkg/dpkg.cfg.d/01_proot`,内容包含:
```text
force-unsafe-io
```
- 避免容器内因 fsync / flash I/O 阻塞或权限校验引发的解包异常(Docker / proot-distro 官方推荐实践)。
2. 在 `postInstallConfigure` 与容器启动检查中自动调用。
### 步骤 3:Shim (`libfix_seccomp.c`) 补充 `chown` 与 `lchown` 导出
**修改文件**:[`android/app/src/main/cpp/libfix_seccomp.c`](file:///d:/Flutter/Projects/code_editor/android/app/src/main/cpp/libfix_seccomp.c)
1. 增加标准 `chown` 和 `lchown` 导出符号:
```c
__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);
}
```
2. 如此一来,无论是 glibc 还是 musl 的应用程序直接调用 `chown` 或 `lchown`,均会走入已有的 `fchownat` 机制:在遭遇 `ENOENT` 时自动以 `AT_SYMLINK_NOFOLLOW` 重试设置替身属性,保证硬链接解压 100% 成功。
---
## 四、验证与验收方案
1. **单元测试回归**:
- 运行全量单元测试:`flutter test`(确保现有 282 项测试无任何回退)。
- 增加关于 `.l2s` 位于 `rootDir/.l2s` 以及 `dpkg.cfg.d/01_proot` 的自动化测试用例。
2. **静态分析**:
- 运行 `flutter analyze` 确保无任何语法和类型告警。
3. **真实场景(Ubuntu 容器)验证**:
- 在容器中执行 `apt update && apt install perl -y`。
- 验证 `/usr/bin/perlthanks` 与 `/usr/bin/perlbug` 成功安装且解包 ownership 正确设置,退出码为 0。