commit 08e7da7f237c1a21aedad17b7a259726b8182060 Author: mac Date: Wed Nov 11 22:04:23 2026 +0800 Initialize read-only APFS validation baseline diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..fe846f7 --- /dev/null +++ b/.gitignore @@ -0,0 +1,9 @@ +.DS_Store +__pycache__/ +*.pyc +build/ +dist/ +private/ +.env +*.fpk +*.tar.gz diff --git a/HANDOFF.md b/HANDOFF.md new file mode 100644 index 0000000..88ff043 --- /dev/null +++ b/HANDOFF.md @@ -0,0 +1,32 @@ +# 交接:飞牛 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;待创建并核验首个基线。 +- 不使用当前聊天原工作目录“大鱼调色”,不修改 NAS 网站生产源。 +- 凭据在用户指定的本机安全位置,不进入工程。 + +## 待完成 + +1. 保存并核验远程工程基线。 +2. 固定上游源码,在隔离的 Debian 12 容器内构建 Release 只读驱动。 +3. 核验设备身份及驱动只读实现,测试列目录、读取与复制内容校验;不写源卡。 +4. 清理临时挂载与容器,更新证据和远程检查点。 +5. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现。 diff --git a/README.md b/README.md new file mode 100644 index 0000000..32c1542 --- /dev/null +++ b/README.md @@ -0,0 +1,24 @@ +# 飞牛 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 实现;后续记录固定源码版本及许可证。 + +## 恢复 + +目标远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 `main`。 + +克隆后查看交接及固定驱动版本。凭据、磁盘数据、编译输出和容器镜像不纳入 Git;本机账号需独立配置。