P2P 与分布式存储 / 系统课时
取消 Pin 后数据何时可回收
取消 Pin 后数据何时可回收
取消 Pin 后文件还可以打开,通常不是命令无效。本节区分撤销保留关系、GC 扫除与再次联网获取,用独立离线仓库观察生命周期,避免把一次读取成功误当成内容仍受保护。
学习目标
- 解释取消 Pin 为什么不立即删除块。
- 在备份与引用盘点之后安全观察 GC 结果。
撤销保留与删除是两件事
pin rm 撤销指定 Pin,块通常仍在仓库中。它只有在不受其他递归根、直接 Pin、MFS 等保留机制保护时,才具备被 GC 清理的条件。GC 清的是可回收块,不是按文件名逐个删除文件,因此共享后代不一定随某个根一起消失。
在线 cat 可能在本地缺块后重新从网络取回,网关也可能命中缓存。要观察本地清理行为,需要关闭这些替代来源。本节使用离线命令和独立仓库,不借助删块目录来制造故障。

仅在练习仓库运行清理
环境为 Bash 与 Kubo 0.43.1,命令未在本节真实执行。原文件保留在仓库外,这就是本例的恢复来源;不要把下面的 repo gc 挪到未备份的生产仓库。
bash
set -euo pipefail
export IPFS_PATH="$(mktemp -d)"
work="$(mktemp -d)"
ipfs init > /dev/null
printf 'gc-lifecycle-unique\n' > "$work/original.txt"
cid="$(ipfs --offline add -Q "$work/original.txt")"
ipfs --offline pin rm "$cid"
# 清理前确认仍能读,再执行这个练习仓库的GC。
ipfs --offline cat "$cid" > "$work/before.txt"
cmp "$work/original.txt" "$work/before.txt"
ipfs --offline repo gc
if ipfs --offline cat "$cid" > "$work/after.txt" 2> "$work/after.err"; then
printf 'still locally readable: inspect shared retention\n'
else
printf 'not locally readable after gc\n'
fi预期结果:
text
unpinned <CID>
removed <BLOCK_CID>
not locally readable after gcGC 可能输出多行 removed 或没有回收项,块 CID 与根 CID也不必相同。在这个独立案例、无其他引用的条件下应出现本地读取失败;若仍成功,应盘点引用和命令实际连接目标,不能为了符合预期继续强删块。
如果计划取消目录根,先保存该根与业务版本的对应关系,并验证另一来源能恢复整个目录。只确认远端有根块会漏掉后代缺失;本地一旦清理,原本可用的缺块来源可能就不存在了。
实验后需要恢复时,应重新从仓库外原文件导入并核对导入方式,再检查保留清单。不是把 GC 输出中的每一个块逐个重新 Pin,因为那会混淆业务根和存储块,且无法自动重建业务目录。
清理还应与自动任务串行安排。新的导入、MFS 写入和人工取消保留可能改变引用集合,运维人员要记录维护窗口内的变更,避免前后容量差来自其他任务却被计入本次释放量。
回收失败与磁盘释放分别观察
按自己的节奏,确认真正理解。