P2P 与分布式存储 / 系统课时

使用 MFS 更新文件路径

使用 MFS 更新文件路径

本课使用 Kubo 的 Mutable File System(MFS)创建目录、复制已有 CID 对应的文件,并通过覆盖同一路径观察目录根 CID 的变化。完成后,你将拥有一套可重复执行的文件更新流程,并能分清 MFS 路径、不可变 CID 与操作系统目录之间的关系。

学习目标

  • 使用 ipfs files mkdir、cp、write、read 和 ls 管理 MFS 文件。
  • 比较更新前后的 MFS 根 CID,解释路径不变而内容标识变化的原因。
  • 区分 MFS 与操作系统文件系统,掌握更新后的验证和持久化边界。

理解 MFS 路径与 CID 的关系

IPFS 使用 CID 标识内容。文件字节或 UnixFS DAG 结构变化后,相关 CID 通常随之变化。如果应用直接保存 /ipfs/<CID>,每次更新文件都需要替换引用。

MFS 提供节点本地的可变目录树,例如 /docs/readme.txt。它允许应用按路径管理文件,而不必手动维护每次更新产生的新根 CID。

MFS 的路径是 Kubo 节点内部的逻辑路径,不是操作系统中的真实目录。执行 ipfs files mkdir /docs 不会在当前工作目录创建 docs 文件夹。

MFS路径与不可变CID的关系

需要注意,MFS 的可变性发生在目录引用层。已经生成的内容块不会因为路径覆盖而被原地修改。更新 MFS 也不会自动让其他节点上的同名路径同步变化。

创建目录并复制已有内容

以下操作适用于提供 ipfs files 命令的 Kubo CLI。先确保本机已经初始化仓库并启动 Kubo 守护进程;如果尚未初始化,在首次使用时执行 ipfs init,随后在单独终端运行 ipfs daemon。

在 Bash 终端中执行下面的完整示例。它先在操作系统临时目录创建源文件,再导入 IPFS,最后复制到 MFS。

bash
set -eu
# 创建可重复使用的示例源文件
printf 'version=1\n' > /tmp/mfs-demo-source.txt
SOURCE_CID=$(ipfs add -Q --cid-version=1 /tmp/mfs-demo-source.txt)
# 清理旧演示目录,避免重复执行时产生冲突
ipfs files rm -r /mfs-demo 2>/dev/null || true
ipfs files mkdir -p /mfs-demo/docs
ipfs files cp "/ipfs/$SOURCE_CID" /mfs-demo/docs/readme.txt
ipfs files ls /mfs-demo/docs
ipfs files read /mfs-demo/docs/readme.txt

预期输出:

text
readme.txt
version=1

ipfs add -Q 只输出导入结果的 CID,--cid-version=1 指定 CIDv1。变量 SOURCE_CID 保存实际导入得到的标识,不需要预先猜测哈希值。

ipfs files cp 在 MFS 目标路径建立对已有 IPFS 内容的引用,不等同于把源文件复制到操作系统目录。ipfs files ls 检查目录项,ipfs files read 检查文件字节,两项都成功才说明目标路径可以正常读取。

覆盖文件并观察根 CID 变化

现在将 version=1 更新为 version=2。这里使用 ipfs files write 直接修改 MFS 文件,不需要先删除旧路径。

bash
set -eu
# 记录更新前的MFS根CID
ROOT_BEFORE=$(ipfs files stat --hash /)
printf 'version=2\n' | ipfs files write --truncate /mfs-demo/docs/readme.txt
ROOT_AFTER=$(ipfs files stat --hash /)
printf 'root_changed=%s\n' "$([ "$ROOT_BEFORE" != "$ROOT_AFTER" ] && echo true || echo false)"
ipfs files read /mfs-demo/docs/readme.txt

预期输出:

text
root_changed=true
version=2

--truncate 表示写入时截断原有文件内容。若没有截断,较短的新内容可能无法清除原文件末尾的旧字节。这里通过标准输入传递新内容,因此不需要使用 --create,因为目标文件已经存在。

ipfs files stat --hash / 获取 MFS 根目录对应的 CID。更新文件后,其内容节点以及引用它的上级目录节点发生变化,最终导致根 CID 改变。

MFS文件更新引起的根CID变化

这里比较的是整个 MFS 根 /,因此其他进程若同时修改 MFS,也可能导致根 CID 改变。要严格验证本次文件更新,还应比较目标文件自身的 CID,并确认读取内容符合预期。

验证文件 CID 与持久化行为

MFS 路径可以保持不变,但它当前指向的内容 CID 可以改变。使用 stat 分别检查文件 CID 与根 CID,并读取文件内容。

bash
set -eu
FILE_CID=$(ipfs files stat --hash /mfs-demo/docs/readme.txt)
ROOT_CID=$(ipfs files stat --hash /)
printf 'file_cid=%s\n' "$FILE_CID"
printf 'root_cid=%s\n' "$ROOT_CID"
ipfs files read /mfs-demo/docs/readme.txt

预期输出示意:

text
file_cid=<CID>
root_cid=<CID>
version=2

其中 <CID> 代表实际生成的内容标识,两行不要求相同。CID 的具体文本受 UnixFS 编码和导入参数影响,不能把示意值当作固定输出。

MFS 的当前根引用由 Kubo 仓库管理。正常关闭并重新启动同一个仓库的节点后,MFS 路径应继续存在。需要注意以下区别:

对象 更新行为 使用范围
MFS 路径 可覆盖、移动或删除 当前 Kubo 仓库的命名空间
/ipfs/<CID> CID 对应内容不可原地修改 知道 CID 且能够取得内容的节点
操作系统路径 由本机文件系统管理 本机或挂载的文件系统

MFS 中的当前文件和目录树会受到仓库垃圾回收保护,但旧版本如果已经不再被 MFS 或其他保留引用保护,可能在垃圾回收后失去本地副本。需要长期保留历史版本时,应显式固定相应 CID,例如 ipfs pin add <CID>。

清理演示数据与检查边界

完成实验后,可以删除演示目录。删除 MFS 路径并不等于立即删除对应内容块,也不会自动撤销通过其他方式建立的固定引用。

bash
set -eu
ipfs files rm -r /mfs-demo
if ipfs files ls /mfs-demo >/dev/null 2>&1; then
  echo 'directory_still_exists'
else
  echo 'directory_removed'
fi

预期输出:

text
directory_removed

如果删除后仍能通过原 CID 读取内容,可能是块仍在本地仓库、存在固定引用,或者节点从网络重新取得了内容。这不能证明 MFS 删除失败。

实际项目中,适合用 MFS 维护正在编辑的站点目录、文档集合或资源清单。每次更新后,先读取目标路径验证字节,再记录新的根 CID;需要跨节点分发时发布该 CID,而不要把节点本地 MFS 路径当成公开下载地址。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 MFS 更新文件路径

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通