文件
fnos-apfs/HANDOFF.md
T

2.4 KiB
原始文件 Blame 文件历史

交接:飞牛 APFS 只读访问

更新时间:2026-11-11(Asia/Shanghai)。

当前目标

在用户提供的 APFS SD 卡上验证 fnOS 本机只读挂载及文件读取,再确定应用封装方案。

已确认

  • SSH 已登录 192.168.31.21:22,管理员提权已验证;网页管理端口为 5668。
  • NAS:Intel i5-12400T / x86_64;Debian 12;内核 6.18.18.c1107-trim。
  • 有 /dev/fuse、FUSE 3.14、Docker;未检测到 apfs-fuse 或本机编译器。
  • 测试卡为约 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。
  • 读卡器以 USB 5000M 连接。飞牛图形界面显示“未知文件系统”,尚未挂载 APFS。
  • 本轮 SSH 曾返回 Exceeded MaxStartups,等待后恢复。未修改 SSH 服务。

工程与恢复

  • 本机:/Users/mac/Documents/dayu-git/repositories/fnos-apfs。
  • 私有远程:https://dayu.media/git/dayu/fnos-apfs.git,分支 main;首个基线 08e7da7f237c1a21aedad17b7a259726b8182060 已推送并回读核验。
  • 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 序列号核对设备,临时设置内核只读,测试后卸载并恢复原标志。
  • 验证程序检查挂载只读、样本复制 SHA-256、APFS 分区写计数和首 MiB 内容;这不是对整盘所有文件或全部 APFS 特性的兼容性保证。
  • 不使用当前聊天原工作目录“大鱼调色”,不修改 NAS 网站生产源。
  • 凭据在用户指定的本机安全位置,不进入工程。

待完成

  1. 首次恢复克隆核验。
  2. 在隔离的 Debian 12 容器内构建 Release 只读驱动。
  3. 核验设备身份及驱动只读实现,测试列目录、读取与复制内容校验;不写源卡。
  4. 清理临时挂载与容器,更新证据和远程检查点。
  5. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现。