47 行
4.1 KiB
Markdown
47 行
4.1 KiB
Markdown
# 交接:飞牛 APFS 只读访问
|
||
|
||
更新时间:2026-11-11(Asia/Shanghai)。
|
||
|
||
## 当前目标
|
||
|
||
基础 APFS 只读挂载已验证。下一步用普通测试文件验证素材读取及导入,再确定应用封装方案。
|
||
|
||
## 已确认
|
||
|
||
- SSH 已登录 `192.168.31.21:22`,管理员提权已验证;网页管理端口为 5668。
|
||
- NAS:Intel i5-12400T / x86_64;Debian 12;内核 `6.18.18.c1107-trim`。
|
||
- 有 `/dev/fuse`、FUSE 3.14、Docker;未检测到 apfs-fuse 或本机编译器。
|
||
- 测试卡为约 29.7 GiB USB SD 卡;APFS 分区当前为 `/dev/sde2`,分区 GUID 类型 `7c3457ef-0000-11aa-aa11-00306543ecac`,4096 字节块大小,NXSB 标识正确。
|
||
- APFS PARTUUID:`5b255495-2ba8-4e49-8774-227d8dd8878f`。每次操作仍需核实其设备身份、USB 传输及挂载状态,不能盲用 sde2。
|
||
- 读卡器以 USB 5000M 连接。飞牛图形界面显示“未知文件系统”;独立 FUSE 挂载已成功,但尚未集成系统界面。
|
||
- 本轮 SSH 曾返回 `Exceeded MaxStartups`,等待后恢复。未修改 SSH 服务。
|
||
|
||
## 工程与恢复
|
||
|
||
- 本机:`/Users/mac/Documents/dayu-git/repositories/fnos-apfs`。
|
||
- 私有远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 main;首个基线 `08e7da7f237c1a21aedad17b7a259726b8182060` 已推送并回读核验。
|
||
- `vendor/apfs-fuse` 保存完整源码快照,含 LZFSE 子模块内容;固定版本见 `UPSTREAM.json`。apfs-fuse `66b86bd525e8cb90f9012543be89b1f092b75cf3`,LZFSE `e634ca58b4821d9f3d560cdc6df5dec02ffc93fd`。
|
||
- `packaging/Dockerfile` 在固定 Debian 12 基础镜像中编译 Release;`scripts/build-driver.sh` 导出驱动;`scripts/validate-card.py` 按 PARTUUID + USB 序列号核对设备,临时设置内核只读,测试后卸载并恢复原标志。
|
||
- 验证程序检查挂载只读、样本复制 SHA-256、APFS 分区写计数和首 MiB 内容;这不是对整盘所有文件或全部 APFS 特性的兼容性保证。
|
||
- 首次代码检查点已从远程独立克隆核验,LZFSE 源码完整。实际验证代码为 `d24400b492a90275d8432e63db78c61ff0ddfa09`;本阶段恢复标签为 `poc-apfs-readonly-20261111`,详见 [RECOVERY.md](RECOVERY.md)。
|
||
- NAS 验证工程路径为 `/var/tmp/dayu-apfs-validation`,驱动只放在该目录 `build/bin`,未安装至系统路径。保留该目录和专用构建镜像供后续开发。
|
||
- 首次构建因 Debian 官方源下载缓慢主动取消,改用容器内中科大镜像后 Release 构建成功,仍保留 Debian 原有签名校验;NAS 宿主机软件源未修改。
|
||
|
||
## 验证结果与边界
|
||
|
||
- Python/Bash 语法检查通过;实际不匹配 USB 身份测试被拒绝。
|
||
- NAS 本机 Release 构建成功,运行库均可解析;源码的上游编译警告保留,未修改上游实现。
|
||
- APFS 分区内核只读标志设为 1 后,以 `ro,nodev,nosuid,noexec` 挂载成功。
|
||
- 读取并复制三个 64 KiB 系统隐藏文件,合计 196608 字节,目标 SHA-256 与读取流一致。
|
||
- APFS 分区写入计数测试前后均为 0,首 MiB 哈希不变;测试后已卸载、删除样本副本、恢复原内核只读标志。
|
||
- 未找到 512 MiB 以内的普通文件可作样本;尚未验证普通素材导入、独立 macOS 参考哈希、大文件速度、加密及其他 APFS 特性。64 KiB 隐藏文件的速度没有代表性,不据此承诺提速。
|
||
- 脱敏证据见 [verification/2026-11-11-apfs-sd.json](verification/2026-11-11-apfs-sd.json),编译依赖见同目录清单。证据不包含源文件内容、文件名或凭据。
|
||
- 不使用当前聊天原工作目录“大鱼调色”,不修改 NAS 网站生产源。
|
||
- 凭据在用户指定的本机安全位置,不进入工程。
|
||
|
||
## 待完成
|
||
|
||
1. 等待用户确认普通测试文件情况;建议 100–500 MB 视频,若可提供 macOS 的 SHA-256 则做独立比对。拔卡前从飞牛系统推出整张卡。
|
||
2. 继续使用 PARTUUID 和 USB 身份核对,不假设重新插入后仍为 sde2;重新格式化后 PARTUUID 也会变化。
|
||
3. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现,本阶段不是正式应用交付。
|