ipfs|ipfs pin 详解 ipfspin详解

ipfs pin 简介 pin 在英文中是大头针、钉住的意思。在 ipfs 中, pin 表示将文件长期保存在本地，不被垃圾回收。
ipfs pin 原理每个文件块都有自己的 pin 状态，由 pin 管理器 Pinner 进行管理。
ipfs 在做 GC 等操作时，会根据每个文件块在 pin 状态，对其做出相应的处理。
文件块的 5 种 Pin 状态 Recursive 状态 【ipfs|ipfs pin 详解】文件块树被递归添加到 pin 中，根文件块的状态是 Recursive，非根文件块的状态是 Indirect
Direct 状态只有目标文件块添加到 pin 中, 子孙块不做处理，目标文件块的状态就是 Direct
Indirect 状态 文件块树被递归添加到 pin 中，根文件块的状态是 Recursive，非根文件块的状态是 Indirect
Internal 状态 ipfs 使用文件块来保存 pinner 状态，这些文件块的状态就是 Internal
NotPinned 状态文件块没有被 pin，在 GC 时会被删除
存储文件块 pin 状态的数据结构
文章图片
查询文件块的 pin 状态
文章图片
文件块的 pin 状态持久化
文章图片
根据 cid 列表长度的不同，会有两种情况。

情况1，如果 cid 列表的长度小等于 8192，仅会生成一个internal ipld node，该 node 的 links 记录 cid 列表的所有 cid。
情况2，如果 cid 列表的长度大于 8192，会对每个 cid 做 hash 后取模，放到 256 个桶中。遍历每个桶，如果桶不为空，则生成一个internal ipld node，并且该 node 的 links 记录桶内所有 cid。然后，会生成一个internal ipld node, 该 node 的 links 记录所有非空桶对应的internal ipld node。

在图中，direct cid 列表属于情况1，recurse cid 列表属于情况2。internal ipld node A 的 links 包含所有状态为 direct 的 cid，internal ipld node B 的 links 包含的都是状态为 internal 的 cid，这些internal ipld node包含所有状态为recurse的cid。root internal ipld node 的 links 包含internal ipld node A和internal ipld node B。
root internal ipld node的 cid 会被存储到 leveldb 中。
ipfs pin 使用展示列出所有被 pin 的块