Fästning

Hur filer bevaras på IPFS-nätverket och varför fästning är viktigt.

Problemet med skräpinsamling

IPFS-noder har begränsat lagringsutrymme. För att hantera diskutrymme kör de regelbundet skräpinsamling — en process som tar bort cachad data som inte uttryckligen har markerats som viktig. Utan åtgärd kan en fil du laddade upp rensas från nätverket inom timmar.

Fästning säger till en IPFS-nod: "behåll denna fil permanent — samla inte in den som skräp." En fäst fil stannar kvar i nodens lagring på obestämd tid, vilket säkerställer att den förblir tillgänglig på nätverket.

Lokal fästning vs. fjärrfästning

Lokal fästning innebär att köra din egen IPFS-nod och fästa filer till den. Du ansvarar för drifttid, lagring och nätverksanslutning. Om din nod går offline blir dina filer otillgängliga.

Fjärrfästning (det IPFS.NINJA tillhandahåller) innebär att en hanterad tjänst fäster dina filer på infrastruktur som alltid är online. Du får fästningens beständighet utan att köra din egen nod.

TIP

Varje fil som laddas upp via IPFS.NINJA fästs automatiskt till vårt IPFS-kluster. Inga ytterligare steg behövs — dina filer är beständiga från uppladdningsögonblicket.

Vad händer när du tar bort fästningen

Om du tar bort en fil från ditt IPFS.NINJA-konto tar vi bort fästningen från våra noder. Filen kan fortfarande vara åtkomlig om:

• Andra IPFS-noder har cachat eller fäst samma CID
• En IPFS-gateway har filen i sin cache
• En annan användare laddade upp samma innehåll (samma CID = samma fil)

Med tiden, utan att någon nod fäster CID:n, kommer filen att skräpsamlas från nätverket helt.

Bästa praxis för fästning

• Fäst tidigt — Ladda upp och fäst ditt innehåll innan du refererar till CID:n i smarta kontrakt, NFT-metadata eller externa system.
• Lita inte på cachen — IPFS-gateway-cachar är tillfälliga. Bara fäst innehåll garanteras bestå.
• Håll ditt konto aktivt — Filer förblir fästa så länge ditt IPFS.NINJA-konto är aktivt, även på den gratis nivån.

Fästa befintligt innehåll

Du behöver inte ladda upp en fil via IPFS.NINJA för att fästa den. Om innehåll redan finns på IPFS-nätverket — uppladdat av någon annan, eller av dig via en annan tjänst — kan du fästa det till ditt konto genom att ange dess CID.

När du fäster en befintlig CID:

1. Söker vårt kluster i IPFS-nätverket efter noder som har innehållet
2. Laddar ner innehållet från den närmaste tillgängliga noden
3. Fäster det lokalt på vår infrastruktur
4. Gör det åtkomligt via ditt konto och gateway

Detta är användbart för:

• Bevara NFT-tillgångar — fäst metadata och bilder från befintliga samlingar
• Säkerhetskopiera innehåll — säkerställ att viktiga CID:er förblir tillgängliga även om den ursprungliga fästaren går offline
• Migrera från en annan tjänst — fäst dina befintliga CID:er utan att ladda upp filerna igen

Se Pinning API-dokumentationen för endpointdetaljer.