ipfs pin 詳解

ipfs pin 簡(jiǎn)介

pin 在英文中是大頭針拉宗、釘住的意思逞度。在 ipfs 中, pin 表示將文件長(zhǎng)期保存在本地污筷,不被垃圾回收证薇。

ipfs pin 原理

每個(gè)文件塊都有自己的 pin 狀態(tài),由 pin 管理器 Pinner 進(jìn)行管理效拭。
ipfs 在做 GC 等操作時(shí)暂吉,會(huì)根據(jù)每個(gè)文件塊在 pin 狀態(tài)胖秒,對(duì)其做出相應(yīng)的處理。

文件塊 的 5 種 Pin 狀態(tài)

Recursive 狀態(tài)

文件塊樹(shù)被遞歸添加到 pin 中慕的,根文件塊的狀態(tài)是 Recursive扒怖,非根文件塊的狀態(tài)是 Indirect

Direct 狀態(tài)

只有目標(biāo)文件塊添加到 pin 中, 子孫塊不做處理,目標(biāo)文件塊的狀態(tài)就是 Direct

Indirect 狀態(tài)

文件塊樹(shù)被遞歸添加到 pin 中业稼,根文件塊的狀態(tài)是 Recursive盗痒,非根文件塊的狀態(tài)是 Indirect

Internal 狀態(tài)

ipfs 使用文件塊來(lái)保存 pinner 狀態(tài),這些文件塊的狀態(tài)就是 Internal

NotPinned 狀態(tài)

文件塊沒(méi)有被 pin低散,在 GC 時(shí)會(huì)被刪除

存儲(chǔ)文件塊 pin 狀態(tài)的數(shù)據(jù)結(jié)構(gòu)

查詢(xún)文件塊的 pin 狀態(tài)

文件塊的 pin 狀態(tài)持久化

根據(jù) cid 列表長(zhǎng)度的不同俯邓,會(huì)有兩種情況。

  • 情況1熔号,如果 cid 列表的長(zhǎng)度小等于 8192稽鞭,僅會(huì)生成一個(gè)internal ipld node,該 node 的 links 記錄 cid 列表的所有 cid引镊。
  • 情況2朦蕴,如果 cid 列表的長(zhǎng)度大于 8192,會(huì)對(duì)每個(gè) cid 做 hash 后取模弟头,放到 256 個(gè)桶中吩抓。遍歷每個(gè)桶,如果桶不為空赴恨,則生成一個(gè)internal ipld node疹娶,并且該 node 的 links 記錄桶內(nèi)所有 cid。然后伦连,會(huì)生成一個(gè)internal ipld node, 該 node 的 links 記錄所有非空桶對(duì)應(yīng)的internal ipld node雨饺。

在圖中,direct cid 列表屬于情況1惑淳,recurse cid 列表屬于情況2额港。internal ipld node A 的 links 包含所有狀態(tài)為 direct 的 cid,internal ipld node B 的 links 包含的都是狀態(tài)為 internal 的 cid歧焦,這些internal ipld node包含所有狀態(tài)為recurse的cid移斩。root internal ipld node 的 links 包含internal ipld node Ainternal ipld node B

root internal ipld node的 cid 會(huì)被存儲(chǔ)到 leveldb 中倚舀。

ipfs pin 使用

展示

列出所有被 pin 的塊

ipfs pin ls

列出 pin 為指定狀態(tài)的塊

ipfs pin ls -t direct
ipfs pin ls -t indirect
ipfs pin ls -t recursive

增加

遞歸 pin

ipfs pin add QmZ98HahPRKRcfoYoJchZNKzFxSHFWw6WxvQc1hpFEoFca

直接 pin(只 pin 指定 hash 的文件塊)

ipfs pin add --recursive=false QmZ98HahPRKRcfoYoJchZNKzFxSHFWw6WxvQc1hpFEoFca

移除

遞歸從 pin 中移除

ipfs pin rm QmZ98HahPRKRcfoYoJchZNKzFxSHFWw6WxvQc1hpFEoFca

直接從 pin 中移除

ipfs pin rm --recursive=false QmZ98HahPRKRcfoYoJchZNKzFxSHFWw6WxvQc1hpFEoFca

參考版本

ipfs 在快速演進(jìn)叹哭,所有使用方式和原理有可能會(huì)發(fā)生改變忍宋,在此標(biāo)注該文章對(duì)應(yīng)的 ipfs 版本號(hào)痕貌。

ipfs version 0.4.18-dev
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市糠排,隨后出現(xiàn)的幾起案子舵稠,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 212,383評(píng)論 6 493
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件哺徊,死亡現(xiàn)場(chǎng)離奇詭異室琢,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)落追,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,522評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門(mén)盈滴,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人轿钠,你說(shuō)我怎么就攤上這事巢钓。” “怎么了疗垛?”我有些...
    開(kāi)封第一講書(shū)人閱讀 157,852評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵症汹,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我贷腕,道長(zhǎng)背镇,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 56,621評(píng)論 1 284
  • 正文 為了忘掉前任泽裳,我火速辦了婚禮瞒斩,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘涮总。我一直安慰自己济瓢,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,741評(píng)論 6 386
  • 文/花漫 我一把揭開(kāi)白布妹卿。 她就那樣靜靜地躺著旺矾,像睡著了一般。 火紅的嫁衣襯著肌膚如雪夺克。 梳的紋絲不亂的頭發(fā)上箕宙,一...
    開(kāi)封第一講書(shū)人閱讀 49,929評(píng)論 1 290
  • 那天,我揣著相機(jī)與錄音铺纽,去河邊找鬼柬帕。 笑死,一個(gè)胖子當(dāng)著我的面吹牛狡门,可吹牛的內(nèi)容都是我干的陷寝。 我是一名探鬼主播,決...
    沈念sama閱讀 39,076評(píng)論 3 410
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼其馏,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼凤跑!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起叛复,我...
    開(kāi)封第一講書(shū)人閱讀 37,803評(píng)論 0 268
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤仔引,失蹤者是張志新(化名)和其女友劉穎扔仓,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體咖耘,經(jīng)...
    沈念sama閱讀 44,265評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡翘簇,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,582評(píng)論 2 327
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了儿倒。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片版保。...
    茶點(diǎn)故事閱讀 38,716評(píng)論 1 341
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖夫否,靈堂內(nèi)的尸體忽然破棺而出找筝,到底是詐尸還是另有隱情,我是刑警寧澤慷吊,帶...
    沈念sama閱讀 34,395評(píng)論 4 333
  • 正文 年R本政府宣布袖裕,位于F島的核電站,受9級(jí)特大地震影響溉瓶,放射性物質(zhì)發(fā)生泄漏急鳄。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 40,039評(píng)論 3 316
  • 文/蒙蒙 一堰酿、第九天 我趴在偏房一處隱蔽的房頂上張望疾宏。 院中可真熱鬧,春花似錦触创、人聲如沸坎藐。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,798評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)岩馍。三九已至,卻和暖如春抖韩,著一層夾襖步出監(jiān)牢的瞬間蛀恩,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 32,027評(píng)論 1 266
  • 我被黑心中介騙來(lái)泰國(guó)打工茂浮, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留双谆,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,488評(píng)論 2 361
  • 正文 我出身青樓席揽,卻偏偏與公主長(zhǎng)得像顽馋,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子幌羞,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,612評(píng)論 2 350

推薦閱讀更多精彩內(nèi)容

  • Global p2p merkle-dag filesystem.命令 參數(shù) 英文注釋 中文注釋 ...
    孔祥子看天下閱讀 4,269評(píng)論 2 4
  • API 參考文檔 本文檔基于 go-ipfs v0.4.11-dev 版本寸谜,發(fā)布于2017年8月23日。 這是一篇...
    湯辦閱讀 8,770評(píng)論 0 8
  • 摘要 星際文件系統(tǒng)是一種點(diǎn)對(duì)點(diǎn)的分布式文件系統(tǒng)新翎, 旨在連接所有有相同的文件系統(tǒng)的計(jì)算機(jī)設(shè)備程帕。在某些方面住练, IPFS...
    陌上塵飛123閱讀 2,866評(píng)論 0 0
  • 念 ...
    朗月疏星QS閱讀 334評(píng)論 0 1
  • 新生兒衣服準(zhǔn)備:(秋天出生的孩子) 長(zhǎng)袖包屁衣 2套 薄款和尚服 長(zhǎng)袖 2套 秋冬連體衣 長(zhǎng)袖 2套 秋冬上衣和褲...
    新手媽媽luke閱讀 189評(píng)論 0 0