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

节点重建后如何验证数据完整

节点重建后如何验证数据完整

重建节点后,仓库检查正常仍可能漏掉业务本来应该有的根。本节把现有块校验、Pin 完整性和业务文件比对分开,帮助你区分索引或关系缺失与内容块缺失,并给恢复结果限定准确范围。

学习目标

  • 使用业务根清单约束恢复范围。
  • 结合块校验与完整读取判断缺失层级。

三种检查不互相代替

repo verify 不带修复参数时检查仓库现有块是否符合其 CID,却不能知道哪些业务块本来应在但没导入。pin verify 检查当前递归根的 DAG 是否完整,但清单里根本没有某个业务根时也不会替业务找回它。业务根清单必须独立保存。

对文件进行普通 SHA-256 比对能证明字节与可信原件一致;这不是把普通摘要当成 UnixFS 根 CID。恢复目录还要比较文件路径、数量和内容;业务需要的权限等元信息应另行定义,不应假设所有导入工具都会完整保留它们。

用恢复矩阵判断缺口

观测 能说明什么 下一步
根未在Pin清单但离线完整可读 保留关系可能漏建 对照业务清单补递归Pin
根在清单但检查broken DAG有缺失或不可读对象 保留证据并从可信来源修复
现有块校验通过但业务根不可读 校验范围未覆盖缺失内容 查备份覆盖范围与根映射

这张矩阵是定位线索,不是对所有错误的唯一判定。权限、编解码支持和路径指错也能导致读取失败,应先确认目标仓库与版本,再归因到丢失。

独立恢复后的完整读取

以下 Bash 片段需 Kubo 0.43.1、已停止 daemon 的练习恢复仓库、真实文件根和可信原件路径,均须替换。本节未执行真实 Kubo 恢复。此处不使用 --drop 或 --heal,保留原状态用于判断。

bash
set -euo pipefail
export IPFS_PATH='/absolute/path/to/restored-practice-repo'
cid='REPLACE_WITH_REAL_FILE_CID'
original='/absolute/path/to/trusted-original.txt'
audit="$(mktemp -d)"
ipfs --offline repo verify > "$audit/block-check.txt" 2> "$audit/block-check.err"
ipfs --offline pin ls --type=recursive "$cid" > "$audit/pin.txt"
ipfs --offline pin verify --verbose > "$audit/pin-check.txt"
# 完整读取到结束,避免只读根块或文件开头。
ipfs --offline cat "$cid" > "$audit/recovered.txt"
cmp "$original" "$audit/recovered.txt"
printf 'business file comparison passed\n'

预期输出:

text
business file comparison passed

同时审阅报告,目标根需 recursive 和 ok,任何 broken、error、缺失目标或校验失败都阻断验收。只看最后一行仍不充分;脚本非零退出也要保留已产生的错误报告。

节点身份改变本身不会改变已导入内容的 CID。重建后业务找不到内容时,应先检查根映射与保留关系,避免误认为所有文件必须按新身份重新生成地址。

修复与再验收

若保留关系缺失而内容完整,可在工作副本重新递归 Pin 后重复检查。若块缺失,从完整备份或确认可用的其他副本恢复,再做离线读取。线上补齐成功不能直接证明原备份完整,要在报告中标明实际使用了哪个来源。

恢复中也应核对业务版本映射,避免把旧的完整 CID 当成最新版本恢复。练习写出“块有效但业务不全”的一个场景,并规定它由哪份清单检测。参考仓库校验实现及Pin 验证实现,完整性结论必须对应业务范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

节点重建后如何验证数据完整

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

登录哪都通