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,而不是一直读取本机副本。记录节点身份、盘和机房信息,使副本数来自真实位置和恢复证据。

可运营Pinning方案的完整闭环

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

完成运营与回退验收表

清单应包含业务根、可信摘要、到期规则、负责人、副本位置与最近恢复时间。容量设置维护预留与增长告警,监控要能发现采样未知、根覆盖缺口和恢复证据过期。失败任务先查节点事实,避免重试覆盖已经成功的保留记录。

发布后保留旧版本回退窗口,迁移时先暂停写入并盘点增量,整仓同身份副本禁止同时在线。批准清理之前确认独立恢复来源与业务引用,维护后再抽查重要根。这样新增、保留、验证、恢复和到期处理才形成闭环。

交付报告应分别标记本机数据流、独立副本、备份恢复、在线切换和硬件故障的验收范围,未做项保持待办。参考完整 CAR 导出、导入保留实现和官方持久化说明,一套方案的完成条件是证据与业务目标一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成一套可恢复的 Pinning 方案

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

登录哪都通