P2P 与分布式存储 / 系统课时
查看当前节点 Pin 了什么
查看当前节点 Pin 了什么
Pin 清单很长时,把每一行都当成一个保留文件会严重误判。本节通过分类查询根与后代,建立可用的业务清单,并解释为什么直接 Pin、递归 Pin 和间接保护不应混合计数。
学习目标
- 使用类型筛选和安静输出生成根清单。
- 正确解释间接 Pin 与共享后代的查询结果。
查业务根与查所有块目的不同
递归根清单适合对照业务内容,直接 Pin 清单适合核对明确管理的单块。间接 Pin 是受递归祖先保护的后代,不能把它们计为额外文件或额外副本。一个根文件拆成很多块,可以出现很多受保护对象,但仍可能只有一处磁盘。
同一个后代被多个根引用时,它的保护来自可达关系。取消其中一个根后,它可能仍受其他根保护。全量间接查询需要遍历,仓库大时应先查递归根并针对少量对象调查,不应每分钟反复扫描全部 DAG。
从独立目录生成清单
以下 Bash 命令需 Kubo 0.43.1,使用新临时仓库并强制离线;本节未实际执行 Kubo。目录包含两份有明确内容的文件,导入的最终根就是查询对象。默认参数由本次 Kubo 版本决定,生产流程应另行记录。
set -euo pipefail
export IPFS_PATH="$(mktemp -d)"
work="$(mktemp -d)"
ipfs init > /dev/null
mkdir "$work/docs"
printf 'alpha\n' > "$work/docs/a.txt"
printf 'beta\n' > "$work/docs/b.txt"
root="$(ipfs --offline add -r -Q "$work/docs")"
ipfs --offline pin ls --type=recursive "$root"
# 根清单用于审计,不把所有间接块当作业务对象。
ipfs --offline pin ls --type=recursive --quiet > "$work/recursive-roots.txt"
ipfs --offline pin ls --type=direct
ipfs --offline pin ls --type=indirect预期结果:
<ROOT_CID> recursive
direct 查询在没有直接Pin时不输出条目
indirect 查询列出被递归根保护的后代CID,顺序不固定后两行是预期行为说明,不是终端真的打印这些中文。所有 CID 都是动态值,初始仓库可能还有初始化内容。检查 recursive-roots.txt 是否包含本例根,而不是断言文件恰好只有一行;查询结果的遍历顺序不作为业务排序。
给清单补上业务含义
节点清单只给保留关系,业务系统还需补充负责人、数据版本、到期时间和可恢复来源。把安静输出当根集合,与业务应保留集合做差:应有未有的项目优先报警,多出的项目进入生命周期审核,而不是马上自动取消。
对同一个 CID 使用不同文本编码时,比较前应统一表示,否则字符串不等可能只是表示不同。命名 Pin 有助于人工阅读,但名称不替代 CID,也不保证全局唯一业务身份;自动验收仍应以根内容和恢复证据为准。
不要直接用全量清单的行数估算容量。一万个共享后代可能只对应几个文件,两个大目录也可能共享很多块。清单比较负责业务覆盖,容量诊断应结合仓库实际占用和文件系统剩余空间。
空清单也可能查错地方
遇到清单突然变空,先核对当前 IPFS_PATH、API 连接目标和运行用户,避免把新空仓库误认为原仓库丢失。远端 Pin 服务的状态应使用 pin remote ls,它不在本地根清单中。
练习给根清单附上版本与负责人,并写出不能从该清单推断的两件事。依据见Kubo 清单查询实现。清单用于追踪保留声明,完整文件恢复用于证明声明对应的数据仍可读。