Preserve existing file timestamps while validating copied contents

这个提交包含在:
mac 于 2026-11-11 23:26:28 +08:00 提交
1 父节点 1827628a93
当前提交 ae3ed9c3d7
3 个文件已更改
+31 -26

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

+27 -24
查看文件
@@ -1,38 +1,41 @@
# 飞牛 APFS 只读访问验证
# 大鱼硬盘拷贝
目标:将 APFS 移动存储直接连接 fnOS,在 NAS 本机读取并导入文件,绕过千兆网络。
飞牛 fnOS 原生桌面应用,在 NAS 本机读取 APFS / NTFS 外接硬盘并复制目录,不经过电脑或 SMB 中转。
当前阶段为只读驱动兼容性验证,尚未制作飞牛应用安装包,也未集成系统“外接存储”界面。
## 使用
2026-11-11 实机结果:APFS SD 卡只读挂载成功,三个系统隐藏文件复制校验通过,APFS 分区写计数为零。普通素材导入与大文件速度待测试;详见交接及 `verification/`。
支持已测试的 fnOS 1.2.0701 x86_64。手动安装 FPK 后,在飞牛桌面打开“大鱼硬盘拷贝”,或访问 `/app/dayu-diskcopy`。使用管理员登录态,不增加独立网络端口。
## 安全边界
1. 选择外接硬盘,勾选同一层级中的源目录。
2. 选择自己的 NAS 存储空间和目标目录,可新建文件夹。
3. 开始拷贝,在任务中查看进度和校验结果。关闭窗口不会终止任务。
- 只对核实身份的 USB APFS 测试分区执行只读访问;不格式化、不修复、不写源盘。
- 不安装内核模块,不改飞牛存储服务、启动配置、系统软件包或现有 Docker 服务。
- 编译与测试使用独立目录及容器;不使用 NAS 网站生产目录。
- 账号密码只从用户指定的本机文件读取到内存,不进入源码、参数或记录。
- 默认不启用 apfs-fuse 的 lax 模式,不记录加密调试数据。
源盘不格式化、不修复;新挂载的卷使用只读挂载。已被飞牛挂载的 NTFS 优先复用,应用只读取文件,不修改系统挂载方式。已存在的文件先保留并校验,不同版本不自动覆盖。失败或中断的应用任务可重试,已完成文件会复用,部分文件可继续传输。
## 工程入口
普通文件保留名称、时间和链接;APFS 原始扩展属性另外保存到目标中的隐藏存档,不盲目应用机器相关安全属性。存档可能含私人元数据,不上传源码仓库。首版不承诺所有 APFS 特性或加密卷兼容,不改写剪辑工程内部引用。
- [HANDOFF.md](HANDOFF.md):当前状态与下一步。
- 驱动来源:[sgan81/apfs-fuse](https://github.com/sgan81/apfs-fuse),只读 FUSE 实现;固定源码版本及许可证见下文。
## 验证
## 构建与验证
- APFS:真实 4 TB USB 盘两目录本机复制,新增约 501 GB,既有 64 个文件校验一致,源分区写计数为零;见 `verification/2026-11-11-competition-copy.json`。
- NTFS:只读镜像挂载和复制 SHA-256 比对通过,尚无实体 NTFS USB 盘验证;见 `verification/2026-11-11-ntfs-image.json`。
- 网关身份、页面私有校验、跨站请求、路径/链接边界及文件系统识别测试见 `tests/`。
- 最终实机交付状态以 [HANDOFF.md](HANDOFF.md) 为准。
完整驱动快照及 LZFSE 源码位于 `vendor/`,版本见 `UPSTREAM.json`,许可证保留在各自目录内;不需要从上游重新下载源码。
## 开发与构建
在 x86_64 Linux + Docker 中,于工程根执行 `bash scripts/build-driver.sh`。仅容器内安装编译依赖;输出 `build/bin/apfs-fuse`、`apfsutil` 及依赖版本清单。NAS 本机需有 libfuse3、libstdc++、zlib、libbz2 的运行库。
- `application/`:界面、降权 Web 服务、受限设备服务、生命周期控制。
- `packaging/fpk/`:固定 appname `dayu-diskcopy` 的安装定义。
- `scripts/copy-directories.py`:后台复制、内容核验与挂载回收。
- `scripts/save-xattrs.py`:私有扩展属性存档。
- `vendor/apfs-fuse/`:包含 LZFSE 的完整源码快照及许可证,版本见 `UPSTREAM.json`,FPK 内也附对应源码。
验证入口为 `scripts/validate-card.py --partuuid <APFS分区PARTUUID> --serial <USB设备序列号> --workdir <工程根目录>`,需管理员运行。它会暂时挂载、读取最多三个 512 MiB 以内样本、将副本写入工程测试目录并比对 SHA-256,然后删除副本及卸载。不会尝试写 APFS 源盘。结果保存在工作目录 `result.json`。
Linux + Docker 中执行 `bash scripts/build-driver.sh` 构建 Release 驱动。验证后将两个可执行文件放入 `build/linux-bin/`。打包脚本核对本轮已验证驱动的固定 SHA-256;工具链变化后的二进制需重新验证,不能盲目绕过检查。
SD 卡只适合验证基本功能,不能代表外置 SSD 的吞吐;隐藏索引文件的读取也不能当作素材导入测试。
```sh
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests -v
python3 scripts/build-fpk.py /path/to/official/fnpack
```
## 恢复
使用官方 fnpack 1.2.3,产物位于 `dist/`,不保存为 Git 对象或 LFS。更新通过网页应用中心“手动安装”;当前设备的 CLI install-fpk 对已安装应用只提示 installed,不能据此宣称更新成功。
目标远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 `main`。
克隆后查看交接及固定驱动版本。凭据、磁盘数据、编译输出和容器镜像不纳入 Git;本机账号需独立配置。
完整恢复入口见 [RECOVERY.md](RECOVERY.md)。
恢复入口见 [RECOVERY.md](RECOVERY.md),最新状态见交接。凭据、真实文件名清单、源文件内容和私有日志不进入 Git。
+1 -1
查看文件
@@ -1,5 +1,5 @@
appname=dayu-diskcopy
version=0.1.2
version=0.1.3
display_name=大鱼硬盘拷贝
desc=直接读取 APFS、NTFS 外接硬盘,在飞牛 NAS 本机后台拷贝目录、查看进度和校验结果。
source=thirdparty
+3 -1
查看文件
@@ -94,7 +94,9 @@ def main():
mismatch_log=str(job / 'existing-check.log'))
return
save('verifying_tree')
result = run_to_log(['rsync', '-rltHni', '--out-format=%i %n%L', '--protect-args',
# Existing files keep their original metadata. Their contents were fully
# checksum-checked above, so a different mtime alone is not a copy failure.
result = run_to_log(['rsync', '-rlHni', '--size-only', '--out-format=%i %n%L', '--protect-args',
*source_args, str(destination) + '/'], 'tree-check.log')
if result or (job / 'tree-check.log').read_text().strip():
raise RuntimeError('Final directory comparison found differences; see tree-check.log.')