Record successful APFS read-only mount and metadata copy verification

这个提交包含在:
mac 于 2026-11-11 22:15:52 +08:00 提交
1 父节点 d24400b492
当前提交 cb9f50fe89
5 个文件已更改
+255 -9

没有与搜索条件相匹配的文件

+18 -9
查看文件
@@ -4,7 +4,7 @@
## 当前目标 ## 当前目标
在用户提供的 APFS SD 卡上验证 fnOS 本机只读挂载及文件读取,再确定应用封装方案。 基础 APFS 只读挂载已验证。下一步用普通测试文件验证素材读取及导入,再确定应用封装方案。
## 已确认 ## 已确认
@@ -13,7 +13,7 @@
- 有 `/dev/fuse`、FUSE 3.14、Docker;未检测到 apfs-fuse 或本机编译器。 - 有 `/dev/fuse`、FUSE 3.14、Docker;未检测到 apfs-fuse 或本机编译器。
- 测试卡为约 29.7 GiB USB SD 卡;APFS 分区当前为 `/dev/sde2`,分区 GUID 类型 `7c3457ef-0000-11aa-aa11-00306543ecac`,4096 字节块大小,NXSB 标识正确。 - 测试卡为约 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。 - APFS PARTUUID:`5b255495-2ba8-4e49-8774-227d8dd8878f`。每次操作仍需核实其设备身份、USB 传输及挂载状态,不能盲用 sde2。
- 读卡器以 USB 5000M 连接。飞牛图形界面显示“未知文件系统”,尚未挂载 APFS。 - 读卡器以 USB 5000M 连接。飞牛图形界面显示“未知文件系统”;独立 FUSE 挂载已成功,但尚未集成系统界面。
- 本轮 SSH 曾返回 `Exceeded MaxStartups`,等待后恢复。未修改 SSH 服务。 - 本轮 SSH 曾返回 `Exceeded MaxStartups`,等待后恢复。未修改 SSH 服务。
## 工程与恢复 ## 工程与恢复
@@ -23,15 +23,24 @@
- `vendor/apfs-fuse` 保存完整源码快照,含 LZFSE 子模块内容;固定版本见 `UPSTREAM.json`。apfs-fuse `66b86bd525e8cb90f9012543be89b1f092b75cf3`,LZFSE `e634ca58b4821d9f3d560cdc6df5dec02ffc93fd`。 - `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 序列号核对设备,临时设置内核只读,测试后卸载并恢复原标志。 - `packaging/Dockerfile` 在固定 Debian 12 基础镜像中编译 Release;`scripts/build-driver.sh` 导出驱动;`scripts/validate-card.py` 按 PARTUUID + USB 序列号核对设备,临时设置内核只读,测试后卸载并恢复原标志。
- 验证程序检查挂载只读、样本复制 SHA-256、APFS 分区写计数和首 MiB 内容;这不是对整盘所有文件或全部 APFS 特性的兼容性保证。 - 验证程序检查挂载只读、样本复制 SHA-256、APFS 分区写计数和首 MiB 内容;这不是对整盘所有文件或全部 APFS 特性的兼容性保证。
- 代码检查点 `737773eb763046ad98d203f6578884ab44e609e0` 已推送并从远程独立克隆核验,LZFSE 源码完整。 - 首次代码检查点已从远程独立克隆核验,LZFSE 源码完整。实际验证代码为 `d24400b492a90275d8432e63db78c61ff0ddfa09`;本阶段恢复标签为 `poc-apfs-readonly-20261111`,详见 [RECOVERY.md](RECOVERY.md)。
- NAS 验证工程路径为 `/var/tmp/dayu-apfs-validation`。首次构建因 Debian 官方源下载缓慢主动取消,容器源改为中科大镜像并保留 Debian 原有签名校验;不改 NAS 宿主机软件源。重新构建待验证。 - 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 网站生产源。 - 不使用当前聊天原工作目录“大鱼调色”,不修改 NAS 网站生产源。
- 凭据在用户指定的本机安全位置,不进入工程。 - 凭据在用户指定的本机安全位置,不进入工程。
## 待完成 ## 待完成
1. 首次恢复克隆核验。 1. 等待用户确认普通测试文件情况;建议 100–500 MB 视频,若可提供 macOS 的 SHA-256 则做独立比对。拔卡前从飞牛系统推出整张卡。
2. 在隔离的 Debian 12 容器内构建 Release 只读驱动。 2. 继续使用 PARTUUID 和 USB 身份核对,不假设重新插入后仍为 sde2;重新格式化后 PARTUUID 也会变化。
3. 核验设备身份及驱动只读实现,测试列目录、读取与复制内容校验;不写源卡。 3. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现,本阶段不是正式应用交付。
4. 清理临时挂载与容器,更新证据和远程检查点。
5. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现。
+4
查看文件
@@ -4,6 +4,8 @@
当前阶段为只读驱动兼容性验证,尚未制作飞牛应用安装包,也未集成系统“外接存储”界面。 当前阶段为只读驱动兼容性验证,尚未制作飞牛应用安装包,也未集成系统“外接存储”界面。
2026-11-11 实机结果:APFS SD 卡只读挂载成功,三个系统隐藏文件复制校验通过,APFS 分区写计数为零。普通素材导入与大文件速度待测试;详见交接及 `verification/`。
## 安全边界 ## 安全边界
- 只对核实身份的 USB APFS 测试分区执行只读访问;不格式化、不修复、不写源盘。 - 只对核实身份的 USB APFS 测试分区执行只读访问;不格式化、不修复、不写源盘。
@@ -32,3 +34,5 @@ SD 卡只适合验证基本功能,不能代表外置 SSD 的吞吐;隐藏索
目标远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 `main`。 目标远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 `main`。
克隆后查看交接及固定驱动版本。凭据、磁盘数据、编译输出和容器镜像不纳入 Git;本机账号需独立配置。 克隆后查看交接及固定驱动版本。凭据、磁盘数据、编译输出和容器镜像不纳入 Git;本机账号需独立配置。
完整恢复入口见 [RECOVERY.md](RECOVERY.md)。
+20
查看文件
@@ -0,0 +1,20 @@
# 恢复与继续验证
- 私有远程:`https://dayu.media/git/dayu/fnos-apfs.git`。
- 分支:`main`;本轮阶段标签:`poc-apfs-readonly-20261111`。
- 已实机验证的代码提交:`d24400b492a90275d8432e63db78c61ff0ddfa09`;阶段标签还包含最终验证证据与交接。
- 完整驱动源码和 LZFSE 依赖均为普通 Git 文件,已保存至 `vendor/`;没有 LFS 对象、Git 子模块或未上传的必要源码。
- 先登录大鱼站并按现有指南配置 Git 凭据,再克隆项目。凭据和源盘数据不随 Git 保存。
```sh
git clone https://dayu.media/git/dayu/fnos-apfs.git
cd fnos-apfs
git switch --detach poc-apfs-readonly-20261111
git rev-parse HEAD
```
在 x86_64 Linux + Docker 中执行 `bash scripts/build-driver.sh`;固定 Debian 12 基础镜像及上游源码版本见 Dockerfile / UPSTREAM.json。APT 依赖版本清单保留在 `verification/`;仓库未封存全部 Debian 软件包,未来源版本变化可能改变二进制哈希。若基础镜像或镜像站不可用,需要恢复对应基础镜像或选用保持 Debian 签名校验的源,不能直接称二进制逐字节可复现。
NAS 本机运行依赖:libfuse3、libstdc++、zlib、libbz2,以及 `/dev/fuse`。验证命令见 README;先核对真实 USB 设备、APFS 分区及 PARTUUID,不能复制旧的 `/dev/sde2` 作为永久设备路径。
`verification/2026-11-11-apfs-sd.json` 记录测试范围、二进制哈希及源盘只读证据。当前仅证明基础挂载及隐藏系统文件读取;普通用户文件与吞吐尚待测试。NAS 上的 `/var/tmp/dayu-apfs-validation` 是可重建验证目录,不是正式安装或网站生产源。没有发布 FPK 或正式发行安装包。
+48
查看文件
@@ -0,0 +1,48 @@
{
"date": "2026-11-11",
"platform": "Debian 12 x86_64 / Linux 6.18.18.c1107-trim",
"source_commit": "d24400b492a90275d8432e63db78c61ff0ddfa09",
"upstream": {
"apfs_fuse": {
"url": "https://github.com/sgan81/apfs-fuse.git",
"commit": "66b86bd525e8cb90f9012543be89b1f092b75cf3",
"license": "GPL-2.0-or-later"
},
"lzfse": {
"url": "https://github.com/lzfse/lzfse.git",
"commit": "e634ca58b4821d9f3d560cdc6df5dec02ffc93fd",
"license": "BSD-3-Clause"
}
},
"build_image": "sha256:54f96ba87499856e451ed3e8725ea326f8ff8671e622df5e30c0c3b233c426c3",
"binaries": {
"apfs-fuse": {
"bytes": 396832,
"sha256": "89a7083c42fb498b021d9f7fabbc5b754eaae503649500e4926965fdcfbcb11e"
},
"apfsutil": {
"bytes": 351552,
"sha256": "692bbd961678c5db1a48e00cb2bc96c50e82dd77e39d87cfe11087608b4658ae"
}
},
"dockerfile_sha256": "cc2cba6f77f03e5beaf548d198ffe4c222b74438e512531afd4293c88a155059",
"identity_guard_rejected_mismatch": true,
"apfs_mounted_read_only": true,
"block_device_was_read_only": true,
"sampled_files": 3,
"sampled_bytes": 196608,
"all_copies_match_sha256": true,
"test_file_kind": "hidden_metadata_only",
"source_writes_unchanged": true,
"source_write_count_before": 0,
"source_write_count_after": 0,
"source_first_MiB_unchanged": true,
"unmounted_after_test": true,
"original_block_read_only_flag_restored": true,
"limits": [
"Only hidden system metadata sampled; ordinary user-file import remains unverified.",
"64 KiB samples do not support throughput conclusions.",
"Copy hashes compare the FUSE read stream with destination bytes; no independent macOS reference hashes provided.",
"No fnOS FPK or system file-manager integration delivered."
]
}
+165
查看文件
@@ -0,0 +1,165 @@
adduser 3.134
apt 2.6.2
base-files 12.4+deb12u15
base-passwd 3.6.1
bash 5.2.15-2+b13
binutils 2.40-2
binutils-common:amd64 2.40-2
binutils-x86-64-linux-gnu 2.40-2
bsdutils 1:2.38.1-5+deb12u3
cmake 3.25.1-1
cmake-data 3.25.1-1
coreutils 9.1-1
cpp 4:12.2.0-3
cpp-12 12.2.0-14+deb12u1
dash 0.5.12-2
debconf 1.5.82
debian-archive-keyring 2023.3+deb12u2
debianutils 5.7-0.5~deb12u1
diffutils 1:3.8-4
dpkg 1.21.23
e2fsprogs 1.47.0-2+b2
findutils 4.9.0-4
g++ 4:12.2.0-3
g++-12 12.2.0-14+deb12u1
gcc 4:12.2.0-3
gcc-12 12.2.0-14+deb12u1
gcc-12-base:amd64 12.2.0-14+deb12u1
gpgv 2.2.40-1.1+deb12u2
grep 3.8-5
gzip 1.12-1
hostname 3.23+nmu1
init-system-helpers 1.65.2+deb12u1
libacl1:amd64 2.3.1-3
libapt-pkg6.0:amd64 2.6.2
libarchive13:amd64 3.6.2-1+deb12u5
libasan8:amd64 12.2.0-14+deb12u1
libatomic1:amd64 12.2.0-14+deb12u1
libattr1:amd64 1:2.5.1-4
libattr1-dev:amd64 1:2.5.1-4
libaudit-common 1:3.0.9-1
libaudit1:amd64 1:3.0.9-1
libbinutils:amd64 2.40-2
libblkid1:amd64 2.38.1-5+deb12u3
libbrotli1:amd64 1.0.9-2+deb12u1
libbz2-1.0:amd64 1.0.8-5+b1
libbz2-dev:amd64 1.0.8-5+b1
libc-bin 2.36-9+deb12u14
libc-dev-bin 2.36-9+deb12u14
libc6:amd64 2.36-9+deb12u14
libc6-dev:amd64 2.36-9+deb12u14
libcap-ng0:amd64 0.8.3-1+b3
libcap2:amd64 1:2.66-4+deb12u3+b1
libcc1-0:amd64 12.2.0-14+deb12u1
libcom-err2:amd64 1.47.0-2+b2
libcrypt-dev:amd64 1:4.4.33-2
libcrypt1:amd64 1:4.4.33-2
libctf-nobfd0:amd64 2.40-2
libctf0:amd64 2.40-2
libcurl4:amd64 7.88.1-10+deb12u15
libdb5.3:amd64 5.3.28+dfsg2-1
libdebconfclient0:amd64 0.270
libexpat1:amd64 2.5.0-1+deb12u5
libext2fs2:amd64 1.47.0-2+b2
libffi8:amd64 3.4.4-1
libfuse3-3:amd64 3.14.0-4
libfuse3-dev:amd64 3.14.0-4
libgcc-12-dev:amd64 12.2.0-14+deb12u1
libgcc-s1:amd64 12.2.0-14+deb12u1
libgcrypt20:amd64 1.10.1-3+deb12u1
libgmp10:amd64 2:6.2.1+dfsg1-1.1
libgnutls30:amd64 3.7.9-2+deb12u7
libgomp1:amd64 12.2.0-14+deb12u1
libgpg-error0:amd64 1.46-1
libgprofng0:amd64 2.40-2
libgssapi-krb5-2:amd64 1.20.1-2+deb12u5
libhogweed6:amd64 3.8.1-2
libicu72:amd64 72.1-3+deb12u1
libidn2-0:amd64 2.3.3-1+b1
libisl23:amd64 0.25-1.1
libitm1:amd64 12.2.0-14+deb12u1
libjansson4:amd64 2.14-2
libjsoncpp25:amd64 1.9.5-4
libk5crypto3:amd64 1.20.1-2+deb12u5
libkeyutils1:amd64 1.6.3-2
libkrb5-3:amd64 1.20.1-2+deb12u5
libkrb5support0:amd64 1.20.1-2+deb12u5
libldap-2.5-0:amd64 2.5.13+dfsg-5
liblsan0:amd64 12.2.0-14+deb12u1
liblz4-1:amd64 1.9.4-1
liblzma5:amd64 5.4.1-1+deb12u2
libmd0:amd64 1.0.4-2
libmount1:amd64 2.38.1-5+deb12u3
libmpc3:amd64 1.3.1-1
libmpfr6:amd64 4.2.0-1
libncursesw6:amd64 6.4-4
libnettle8:amd64 3.8.1-2
libnghttp2-14:amd64 1.52.0-1+deb12u3
libnsl-dev:amd64 1.3.0-2
libnsl2:amd64 1.3.0-2
libp11-kit0:amd64 0.24.1-2
libpam-modules:amd64 1.5.2-6+deb12u2
libpam-modules-bin 1.5.2-6+deb12u2
libpam-runtime 1.5.2-6+deb12u2
libpam0g:amd64 1.5.2-6+deb12u2
libpcre2-16-0:amd64 10.42-1+deb12u2
libpcre2-32-0:amd64 10.42-1+deb12u2
libpcre2-8-0:amd64 10.42-1+deb12u2
libpcre2-dev:amd64 10.42-1+deb12u2
libpcre2-posix3:amd64 10.42-1+deb12u2
libproc2-0:amd64 2:4.0.2-3
libpsl5:amd64 0.21.2-1
libquadmath0:amd64 12.2.0-14+deb12u1
librhash0:amd64 1.4.3-3
librtmp1:amd64 2.4+20151223.gitfa8646d.1-2+b2
libsasl2-2:amd64 2.1.28+dfsg-10+deb12u1
libsasl2-modules-db:amd64 2.1.28+dfsg-10+deb12u1
libseccomp2:amd64 2.5.4-1+deb12u1
libselinux1:amd64 3.4-1+b6
libselinux1-dev:amd64 3.4-1+b6
libsemanage-common 3.4-1
libsemanage2:amd64 3.4-1+b5
libsepol-dev:amd64 3.4-2.1
libsepol2:amd64 3.4-2.1
libsmartcols1:amd64 2.38.1-5+deb12u3
libss2:amd64 1.47.0-2+b2
libssh2-1:amd64 1.10.0-3+deb12u1
libssl3:amd64 3.0.22-1~deb12u2
libstdc++-12-dev:amd64 12.2.0-14+deb12u1
libstdc++6:amd64 12.2.0-14+deb12u1
libsystemd0:amd64 252.39-1~deb12u2
libtasn1-6:amd64 4.19.0-2+deb12u1
libtinfo6:amd64 6.4-4
libtirpc-common 1.3.3+ds-1
libtirpc-dev:amd64 1.3.3+ds-1
libtirpc3:amd64 1.3.3+ds-1
libtsan2:amd64 12.2.0-14+deb12u1
libubsan1:amd64 12.2.0-14+deb12u1
libudev1:amd64 252.39-1~deb12u2
libunistring2:amd64 1.0-2
libuuid1:amd64 2.38.1-5+deb12u3
libuv1:amd64 1.44.2-1+deb12u1
libxml2:amd64 2.9.14+dfsg-1.3~deb12u6
libxxhash0:amd64 0.8.1-1
libzstd1:amd64 1.5.4+dfsg2-5
linux-libc-dev:amd64 6.1.190-1
login 1:4.13+dfsg1-1+deb12u2
logsave 1.47.0-2+b2
make 4.3-4.1
mawk 1.3.4.20200120-3.1
mount 2.38.1-5+deb12u3
ncurses-base 6.4-4
ncurses-bin 6.4-4
passwd 1:4.13+dfsg1-1+deb12u2
perl-base 5.36.0-7+deb12u4
procps 2:4.0.2-3
rpcsvc-proto 1.4.3-1
sed 4.9-1+deb12u1
sysvinit-utils 3.06-4
tar 1.34+dfsg-1.2+deb12u1
tzdata 2026f-0+deb12u1
usr-is-merged 37~deb12u1
util-linux 2.38.1-5+deb12u3
util-linux-extra 2.38.1-5+deb12u3
zlib1g:amd64 1:1.2.13.dfsg-1
zlib1g-dev:amd64 1:1.2.13.dfsg-1