文件
fnos-apfs/README.md
T

35 行
2.1 KiB
Markdown

# 飞牛 APFS 只读访问验证
目标:将 APFS 移动存储直接连接 fnOS,在 NAS 本机读取并导入文件,绕过千兆网络。
当前阶段为只读驱动兼容性验证,尚未制作飞牛应用安装包,也未集成系统“外接存储”界面。
## 安全边界
- 只对核实身份的 USB APFS 测试分区执行只读访问;不格式化、不修复、不写源盘。
- 不安装内核模块,不改飞牛存储服务、启动配置、系统软件包或现有 Docker 服务。
- 编译与测试使用独立目录及容器;不使用 NAS 网站生产目录。
- 账号密码只从用户指定的本机文件读取到内存,不进入源码、参数或记录。
- 默认不启用 apfs-fuse 的 lax 模式,不记录加密调试数据。
## 工程入口
- [HANDOFF.md](HANDOFF.md):当前状态与下一步。
- 驱动来源:[sgan81/apfs-fuse](https://github.com/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;本机账号需独立配置。