文件
fnos-apfs/README.md
T

2.1 KiB

飞牛 APFS 只读访问验证

目标:将 APFS 移动存储直接连接 fnOS,在 NAS 本机读取并导入文件,绕过千兆网络。

当前阶段为只读驱动兼容性验证,尚未制作飞牛应用安装包,也未集成系统“外接存储”界面。

安全边界

  • 只对核实身份的 USB APFS 测试分区执行只读访问;不格式化、不修复、不写源盘。
  • 不安装内核模块,不改飞牛存储服务、启动配置、系统软件包或现有 Docker 服务。
  • 编译与测试使用独立目录及容器;不使用 NAS 网站生产目录。
  • 账号密码只从用户指定的本机文件读取到内存,不进入源码、参数或记录。
  • 默认不启用 apfs-fuse 的 lax 模式,不记录加密调试数据。

工程入口

  • HANDOFF.md:当前状态与下一步。
  • 驱动来源:sgan81/apfs-fuse,只读 FUSE 实现;固定源码版本及许可证见下文。

构建与验证

完整驱动快照及 LZFSE 源码位于 vendor/,版本见 UPSTREAM.json,许可证保留在各自目录内;不需要从上游重新下载源码。

在 x86_64 Linux + Docker 中,于工程根执行 bash scripts/build-driver.sh。仅容器内安装编译依赖;输出 build/bin/apfs-fuse、apfsutil 及依赖版本清单。NAS 本机需有 libfuse3、libstdc++、zlib、libbz2 的运行库。

验证入口为 scripts/validate-card.py --partuuid <APFS分区PARTUUID> --serial <USB设备序列号> --workdir <工程根目录>,需管理员运行。它会暂时挂载、读取最多三个 512 MiB 以内样本、将副本写入工程测试目录并比对 SHA-256,然后删除副本及卸载。不会尝试写 APFS 源盘。结果保存在工作目录 result.json。

SD 卡只适合验证基本功能,不能代表外置 SSD 的吞吐;隐藏索引文件的读取也不能当作素材导入测试。

恢复

目标远程:https://dayu.media/git/dayu/fnos-apfs.git,分支 main。

克隆后查看交接及固定驱动版本。凭据、磁盘数据、编译输出和容器镜像不纳入 Git;本机账号需独立配置。