P2P 与分布式存储 / 系统课时
把本地内容加入节点存储
把本地内容加入节点存储
把文件加入节点时,导入选项决定内容结构,Pin 默认值决定保留关系。本节在独立仓库完成一次明确记录选项的导入,让后续迁移和恢复能对照同一根 CID,而不是依赖记忆重新生成。
学习目标
- 导入一份有明确字节内容的文件并记录根 CID。
- 核对默认递归 Pin 与原件的独立备份。
准备独立练习空间
操作环境为 Bash、已安装的 Kubo 0.43.1 和可写临时目录,无需启动 daemon。本节未执行真实 Kubo,命令属于读者验收。不要将 IPFS_PATH 指向正在使用的生产仓库,临时原文件目录也应与仓库分开保存。
文本换行和编码都会改变内容。使用 printf 创建固定 UTF-8 ASCII 字节,避免编辑器自动改换行;本例文件带一个结尾换行。对业务文件应记录实际摘要,不应因为终端显示相同就认为字节一致。
明确导入参数
set -euo pipefail
export IPFS_PATH="$(mktemp -d)"
work="$(mktemp -d)"
ipfs init > /dev/null
printf 'pinning-demo\n' > "$work/demo.txt"
# 固定导入方式;-Q 只返回最终根CID,便于可靠记录。
cid="$(ipfs --offline add --cid-version=1 --raw-leaves=true --chunker=size-262144 -Q "$work/demo.txt")"
printf '%s\n' "$cid" > "$work/root.cid"
ipfs --offline pin ls --type=recursive "$cid"
ipfs --offline cat "$cid" > "$work/check.txt"
cmp "$work/demo.txt" "$work/check.txt"
printf 'import verified\n'预期结果:
<CID> recursive
import verified动态 CID 保存于 root.cid,参数或输入字节变化可能产生另一值。命令默认 Pin 新增内容,所以清单显示 recursive;不要再把“调用 add”与“随后另行 Pin”混成两个必然存在的阶段。显式使用 --pin=false 时才是在改变这一默认行为。
记录足以重现的清单
建议将文件名、根 CID、字节数、普通文件摘要、Kubo 版本和导入参数放入业务清单,保留原件或可恢复的独立备份。小文件可能只有一个 raw 块,大文件则有内部节点和许多叶块;两者不能只凭体积推断保护状态。
新增目录时根 CID 对应整个目录,目录内容和文件名变化都会影响根。若使用 --wrap-with-directory,得到的是包裹目录的根而非裸文件的根。选择业务入口后保持一致,否则验收人员可能拿目录根去运行 cat 并误判为数据丢失。
选择摘要算法时,应把算法名和字节数一起保存,避免不同工具默认算法不一致。对大目录,普通文件摘要清单可以帮助定位具体缺失文件,根 CID 则用于约束整个结构;这两层证据服务不同问题。
导入失败如何收束
遇到权限或磁盘不足,先保存标准错误和退出码,检查临时目录是否位于预期卷。部分写入的块不是成功导入承诺;在命令成功、根 CID 已记录并且恢复比对通过之前,不要对外公布这个版本。也不要为了腾空间直接删除仓库块目录。
如果用了 --only-hash,它只计算 CID 而不将内容存储进去,更不能形成存储副本。导入的可信完成条件是实际块存在、保留状态正确以及恢复内容一致,而非“有一串看起来像地址的输出”。
练习将原文件的一行改成两行后重新导入,比较新旧清单并解释为何旧根仍保留旧版本。参数依据见Kubo add 源码。完成练习后保留临时目录和清单用于后续核验,不需要清理生产数据。