P2P 与分布式存储 / 系统课时
导入文件并按 CID 读取内容
导入文件并按 CID 读取内容
本课使用 Kubo 命令行完成一次本地内容寻址实验:创建文本文件,将其导入 IPFS,记录返回的 CID,再通过 CID 读取和导出内容。最后删除原始文件并验证结果,确认读取过程不依赖最初的文件路径。
学习目标
- 使用
ipfs add导入文件,识别返回的内容标识 CID。 - 使用
ipfs cat和ipfs get按 CID 读取、导出内容。 - 通过内容对比和修改实验,验证 CID 与文件路径、文件内容之间的关系。
检查本地 Kubo 节点
本实验适用于已安装 Kubo、完成 ipfs init 的环境。使用 Bash 终端执行以下命令,Windows 用户可使用 Git Bash。实验中的文件保存在当前工作目录,不需要修改 Kubo 仓库配置。
# 检查 Kubo 命令是否可用
ipfs version
# 检查本地仓库是否已初始化
ipfs config show预期结果:第一条命令显示 ipfs version 及已安装版本号;第二条命令输出包含 Identity、Datastore 等字段的 JSON 配置。具体版本和配置值取决于本机环境。
ipfs version <VERSION>如果出现 command not found,应先安装 Kubo 并确认可执行文件位于 PATH 中。如果提示仓库尚未初始化,可在首次使用时执行 ipfs init。已有仓库不要重复初始化。
ipfs add、ipfs cat 和 ipfs get 可以直接使用本地仓库,不要求守护进程一直运行。需要通过 IPFS 网络发现和获取其他节点的内容时,再单独启动 ipfs daemon。
创建文件并获取 CID
首先创建一个可重复验证的测试文件。使用 printf 固定文件内容和换行符,避免不同编辑器的编码与换行设置影响哈希结果。
# 创建独立实验目录并写入 UTF-8 文本
mkdir -p ipfs-cid-lab
cd ipfs-cid-lab
printf 'Hello IPFS\n' > hello.txt
# 导入文件并指定 CIDv1,避免依赖默认 CID 版本
ipfs add --cid-version=1 hello.txt预期输出格式如下,实际 CID 由导入内容和相关编码参数决定,应以终端返回值为准。
added <CID> hello.txt其中 <CID> 代表真实返回的内容标识,不是需要输入的固定字符串。CID 通常包含内容所用的多哈希信息以及内容寻址所需的编码信息;CIDv1 还显式包含版本和内容类型编解码标识。
CID 不是文件名,也不是服务器地址。hello.txt 是本地输入路径,而返回的 CID 可用于在 IPFS 中定位对应的数据对象。同样的文件内容,在导入选项和数据组织方式一致时,通常得到相同 CID;不同的分块、包装或编解码方式可能产生不同 CID。
使用 CID 读取与导出内容
把上一条命令返回的 CID 保存到 Shell 变量。下面使用 ipfs add -Q 重新取得同一文件的 CID,避免手工复制出错;-Q 表示仅输出最终 CID。
# 使用与首次导入一致的参数
CID=$(ipfs add -Q --cid-version=1 hello.txt)
printf 'CID=%s\n' "$CID"
# 通过 CID 直接读取文件字节
ipfs cat "$CID"
# 将 CID 对应的内容导出到指定路径
ipfs get "$CID" -o recovered.txt预期结果:第一行输出 CID=<CID>,第二个读取操作输出文件内容,ipfs get 将内容写入 recovered.txt。下载进度信息可能随 Kubo 版本和终端环境不同而变化。
CID=<CID>
Hello IPFSipfs cat 将文件内容写到标准输出,适合查看文本或通过 Shell 重定向保存。对于二进制文件,不应直接把字节打印到终端。
ipfs get 则将指定 CID 对应的文件或目录导出到本地文件系统。这里的 -o recovered.txt 明确指定输出位置;如果 CID 对应目录,导出结果也会保留相应的目录结构。

删除原始文件并验证导出结果
导入完成后,Kubo 已将数据写入自己的本地仓库。删除工作目录中的原始文件,不等于删除 Kubo 仓库里的内容。可以利用这一点验证按 CID 读取与原始路径解耦。
# 先验证导出文件与原始文件完全一致
cmp hello.txt recovered.txt
# 删除原始文件,再通过CID重新读取
rm hello.txt
ipfs cat "$CID" > restored.txt
cmp recovered.txt restored.txt
printf 'CID retrieval verified\n'预期输出如下。cmp 在文件完全相同时不输出内容并返回退出状态 0;若比较失败,使用 && 连接的检查会更适合自动化脚本。
CID retrieval verified此时工作目录中已没有原始 hello.txt,但仍能从本地 Kubo 仓库恢复相同内容。这证明在当前实验条件下,数据读取不依赖原始文件路径。
修改内容并比较 CID
内容寻址的另一项重要性质是:修改文件字节后,通常会得到新的内容标识。使用与首次导入相同的参数,仅改变一个字符进行比较。
# 创建不同内容并重新导入
printf 'Hello IPFS!\n' > changed.txt
NEW_CID=$(ipfs add -Q --cid-version=1 changed.txt)
if [ "$CID" != "$NEW_CID" ]; then
printf 'CID changed after content modification\n'
else
printf 'CID unchanged\n'
fi预期输出:
CID changed after content modification这次修改增加了一个感叹号,因此输入字节与原文件不同,得到不同 CID。原来的 CID 仍指向先前导入的内容,新 CID 则对应修改后的内容;IPFS 不会因为文件名相似而自动覆盖旧对象。
需要注意,CID 相同只能说明它们引用同一个内容寻址对象,不能据此证明内容发布者可信,也不能保证数据会永久保存。实际项目中需要长期保留内容时,应配置固定保存(Pin)及可靠的存储副本。
完成实验后,可以运行 ipfs pin ls --type=recursive 检查本地递归固定的对象。Kubo 的常规 ipfs add 默认会固定添加的内容,但具体固定行为仍应以所用命令选项和本地仓库状态为准。
通过本次实验,可以确认三个可复现的结果:文件导入后返回 CID,删除原始路径后仍可通过 CID 从本地仓库恢复内容,修改文件字节后产生新的 CID。这些结果构成后续跨节点文件分发实验的基础。