P2P 与分布式存储 / 系统课时

备份后如何恢复 Pin 状态

备份后如何恢复 Pin 状态

备份文件存在,不代表恢复后 Pin 状态正确。本节比较整仓恢复与 CAR 内容恢复,并在新仓库导入一份完整内容,检查保留关系、逐根报告和文件恢复结果,避免恢复了块却忘记保留。

学习目标

  • 根据备份类型判断哪些状态需要重新建立。
  • 检查导入逐根错误、递归 Pin 与完整内容恢复。

备份类型决定恢复语义

停机一致的整仓备份应包含块、Pin 元数据和相关配置,恢复时先使用兼容 Kubo 版本,原位置保持停机。只有块目录或根清单的备份不够;前者可能缺少关系元数据,后者根本没有数据。对两者都不能直接宣称可以完整恢复。

完整 CAR 携带 DAG 块和声明根,导入新仓库可对根建立递归 Pin,但不保存原节点身份、Pin 名称、MFS 路径或业务到期规则。恢复服务前仍需根据业务清单补齐这些关系。损坏或不完整 CAR 可能在导入部分块后失败,不是事务回滚。

导入与恢复形成同一验收

下面 Bash 操作需 Kubo 0.43.1、全新临时目录,无 daemon。本节未实际运行 Kubo。示例先准备一个完整 CAR,再用新仓库恢复,原件在仓库外一直保留。

bash
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'

预期结果:

text
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 也需要保存文件大小和普通摘要,传输后先确认材料没有截断或被替换。摘要只验证这份归档的字节一致,归档是否覆盖全部业务根仍由恢复清单与实际导入决定;这两个检查应分开记录。

把恢复关系纳入报告

报告包含备份时间、内容根、目标身份、根保留类型、完整读取及业务映射恢复情况。练习比较整仓与 CAR 恢复后哪些材料相同,哪些需要补建;真实灾备与发布密钥恢复本节未执行。

参见CAR 导入实现及完整与尽力导出实现。备份合格的最终证据,是能够在受控目标恢复业务数据及其应有保留关系。

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

目录与阅读设置

阅读设置

17

记录一个想法

备份后如何恢复 Pin 状态

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

登录哪都通