Připínání

Jak soubory přetrvávají v síti IPFS a proč je připínání důležité.

Problém sběru odpadu

IPFS uzly mají omezené úložiště. Pro správu diskového prostoru periodicky spouštějí sběr odpadu — proces, který odstraňuje data z mezipaměti, která nebyla explicitně označena jako důležitá. Bez zásahu by soubor, který jste nahráli, mohl být ze sítě odstraněn během hodin.

Připínání říká IPFS uzlu: "zachovej tento soubor trvale — neodstraňuj ho." Připnutý soubor zůstává v úložišti uzlu neomezeně, čímž zajišťuje jeho dostupnost v síti.

Lokální připínání vs. vzdálené připínání

Lokální připínání znamená provozování vlastního IPFS uzlu a připínání souborů k němu. Jste zodpovědní za dobu provozu, úložiště a síťové připojení. Pokud váš uzel přejde do offline režimu, vaše soubory se stanou nedostupnými.

Vzdálené připínání (co poskytuje IPFS.NINJA) znamená, že spravovaná služba připíná vaše soubory na infrastruktuře, která je stále online. Získáte trvalost připínání bez provozování vlastního uzlu.

TIP

Každý soubor nahraný přes IPFS.NINJA je automaticky připnut k našemu IPFS clusteru. Žádné další kroky nejsou potřeba — vaše soubory jsou trvalé od okamžiku nahrání.

Co se stane, když odpnete

Pokud smažete soubor z vašeho účtu IPFS.NINJA, odpneme ho z našich uzlů. Soubor může být stále přístupný, pokud:

• Jiné IPFS uzly mají nebo připínají stejný CID
• IPFS gateway má soubor ve své mezipaměti
• Jiný uživatel nahrál stejný obsah (stejný CID = stejný soubor)

Postupem času, bez jakéhokoli uzlu připínajícího CID, bude soubor ze sítě zcela odstraněn sběrem odpadu.

Nejlepší postupy pro připínání

• Připínejte brzy — Nahrajte a připněte svůj obsah před referencováním CID v chytrých kontraktech, NFT metadatech nebo externích systémech.
• Nespoléhejte na mezipaměť — Mezipaměti IPFS gateway jsou dočasné. Pouze připnutý obsah má zaručenou trvalost.
• Udržujte svůj účet aktivní — Soubory zůstávají připnuté, dokud je váš účet IPFS.NINJA aktivní, i na bezplatné úrovni.

Připínání existujícího obsahu

Nemusíte nahrávat soubor přes IPFS.NINJA, abyste ho mohli připnout. Pokud obsah již existuje v síti IPFS — nahrán někým jiným nebo vámi přes jinou službu — můžete ho připnout k svému účtu poskytnutím jeho CID.

Když připnete existující CID, náš cluster:

1. Prohledá síť IPFS na uzly, které mají obsah
2. Stáhne obsah z nejbližšího dostupného uzlu
3. Připne ho lokálně na naší infrastruktuře
4. Zpřístupní ho přes váš účet a gateway

To je užitečné pro:

• Zachování NFT aktiv — připněte metadata a obrázky z existujících kolekcí
• Zálohování obsahu — zajistěte, aby důležité CID zůstaly dostupné, i když původní připínač přejde do offline režimu
• Migrace z jiné služby — připněte své existující CID bez opětovného nahrávání souborů

Podrobnosti o endpointech naleznete v dokumentaci Pinning API.