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。重建后业务找不到内容时,应先检查根映射与保留关系,避免误认为所有文件必须按新身份重新生成地址。
修复与再验收
按自己的节奏,确认真正理解。