35 行
2.1 KiB
Markdown
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;本机账号需独立配置。
|