P2P 与分布式存储 / 系统课时
备份后如何恢复 Pin 状态
备份后如何恢复 Pin 状态
备份文件存在,不代表恢复后 Pin 状态正确。本节比较整仓恢复与 CAR 内容恢复,并在新仓库导入一份完整内容,检查保留关系、逐根报告和文件恢复结果,避免恢复了块却忘记保留。
学习目标
- 根据备份类型判断哪些状态需要重新建立。
- 检查导入逐根错误、递归 Pin 与完整内容恢复。
备份类型决定恢复语义
停机一致的整仓备份应包含块、Pin 元数据和相关配置,恢复时先使用兼容 Kubo 版本,原位置保持停机。只有块目录或根清单的备份不够;前者可能缺少关系元数据,后者根本没有数据。对两者都不能直接宣称可以完整恢复。
完整 CAR 携带 DAG 块和声明根,导入新仓库可对根建立递归 Pin,但不保存原节点身份、Pin 名称、MFS 路径或业务到期规则。恢复服务前仍需根据业务清单补齐这些关系。损坏或不完整 CAR 可能在导入部分块后失败,不是事务回滚。
导入与恢复形成同一验收
下面 Bash 操作需 Kubo 0.43.1、全新临时目录,无 daemon。本节未实际运行 Kubo。示例先准备一个完整 CAR,再用新仓库恢复,原件在仓库外一直保留。
set -euo pipefail
work="$(mktemp -d)"
export IPFS_PATH="$work/backup-source"
ipfs init > /dev/null
printf 'restore-pins\n' > "$work/original.txt"
cid="$(ipfs --offline add -Q "$work/original.txt")"
ipfs --offline dag export "$cid" > "$work/backup.car"
export IPFS_PATH="$work/restore-target"
ipfs init > /dev/null
# 默认会尝试保留根;显式写出便于审查意图。
ipfs --offline dag import --pin-roots=true "$work/backup.car"
ipfs --offline pin ls --type=recursive "$cid"
ipfs --offline pin verify --verbose
ipfs --offline cat "$cid" > "$work/restored.txt"
cmp "$work/original.txt" "$work/restored.txt"
printf 'restore and retention passed\n'预期结果:
dag import输出实际根CID及其Pin结果
<CID> recursive
<CID> ok
restore and retention passed必须审查每个根的导入报告,出现 Pin 错误不能登记完成;pin verify 的 broken 或 error 同样阻断验收,不能只看退出码。恢复清单要与业务清单逐项对应,不应把初始化内容当成业务根,也不应漏掉 CAR 未覆盖的根。
不完整备份不能靠声明补齐
只保存根 CID 时,重新 Pin 会依赖外部节点仍保有全部块。若外部副本也丢失,地址无法生成文件。dag export --local-only 是尽力导出模式,可以跳过缺块及其子树,其输出不应当作已经完整的业务备份。
如果只能抢救到部分 CAR,应明确标成部分恢复材料,在隔离目标上导入并核对缺失范围。修复必须保留原故障副本,不能先清理它来“释放空间”。成功从网络补齐后还要重新进行离线恢复,以证明目标已经完整。
CAR 也需要保存文件大小和普通摘要,传输后先确认材料没有截断或被替换。摘要只验证这份归档的字节一致,归档是否覆盖全部业务根仍由恢复清单与实际导入决定;这两个检查应分开记录。