P2P 与分布式存储 / 系统课时
完成一套可恢复的 Pinning 方案
完成一套可恢复的 Pinning 方案
一套可恢复方案需要把内容根、副本、容量、备份与验收连成闭环。本节完成一个小文件的离线多仓库和备份恢复练习,再把它映射到真实故障域与运营清单,明确哪些证据已经具备、哪些还需要演练。
学习目标
- 将导入、第二副本、备份恢复和内容比对串成完整路径。
- 制定可操作的容量、监控与回滚验收表。
先写清楚业务目标
假设要保留不可重建的业务文档,业务接受短时间服务中断,但不接受已确认发布的版本丢失。方案需要至少两个在线独立故障域的完整副本,以及隔离保存的可恢复材料;具体副本数量与频率仍应依据业务风险决定。
本机多仓库练习只能证明数据流和恢复步骤,不能证明独立磁盘、机房或地域。每个节点使用独立初始化的身份;CAR 在仓库之外保存,整仓备份与 CAR 作用不同。原件摘要和业务根映射也必须有独立保管方式。
跑通一份内容的最小闭环
环境为 Bash、Kubo 0.43.1 和新临时目录,无 daemon。以下真实 Kubo 操作本节未执行,由读者验收。练习不使用 GC、删块或覆盖旧仓库,所有目录均为新建,失败时保留材料。
bash
set -euo pipefail
work="$(mktemp -d)"
export IPFS_PATH="$work/repo-a"
ipfs init > /dev/null
printf 'recoverable-pinning-plan\n' > "$work/original.txt"
cid="$(ipfs --offline add --cid-version=1 --raw-leaves=true -Q "$work/original.txt")"
printf '%s\n' "$cid" > "$work/root.cid"
# 完整CAR负责搬运内容,不复制节点身份。
ipfs --offline dag export "$cid" > "$work/backup.car"
for name in repo-b recovery-check; do
export IPFS_PATH="$work/$name"
ipfs init > /dev/null
ipfs --offline dag import --pin-roots=true "$work/backup.car" > "$work/$name-import.txt"
ipfs --offline pin ls --type=recursive "$cid" > "$work/$name-pin.txt"
ipfs --offline pin verify --verbose > "$work/$name-verify.txt"
ipfs --offline cat "$cid" > "$work/$name-restored.txt"
cmp "$work/original.txt" "$work/$name-restored.txt"
printf '%s file comparison passed\n' "$name"
done
printf 'inspect import and verify reports before acceptance\n'预期输出:
text
repo-b file comparison passed
recovery-check file comparison passed
inspect import and verify reports before acceptance输出只是字节比对信号。最终验收还必须打开导入报告确认目标根没有 Pin 错误,Pin 报告确认目标 recursive 与 ok;broken、error、缺失根或逐根失败都不能通过,即使进程退出码为零。这里的三个仓库都在同一临时卷,绝不能登记为独立灾备。
把练习结果放到真实基础设施
将内容和根清单通过可信通道送到另一主机,再在独立初始化仓库导入并离线恢复。备份存到另一故障域,验证从那里读取 CAR,而不是一直读取本机副本。记录节点身份、盘和机房信息,使副本数来自真实位置和恢复证据。

上线前还要验证停止主要节点后,干净请求方能从受控备用来源完整获取,再恢复服务。这个真实网络和故障切换范围本节未执行。不要用公共网关缓存命中替代它,也不要用条件判断程序替代真实进程或磁盘故障。
完成运营与回退验收表
按自己的节奏,确认真正理解。