Wat is IPFS-pinning? Alles wat je moet weten in 2026

Als je tijd hebt besteed aan het verkennen van gedecentraliseerde opslag, heb je waarschijnlijk gehoord van IPFS --- het InterPlanetary File System. Het belooft een web waar bestanden worden geadresseerd op basis van hun inhoud in plaats van hun locatie, waardoor data draagbaar, verifieerbaar en censuurbestendig wordt. Maar er is een valkuil die bijna elke nieuwkomer overvalt: als niemand je bestand expliciet bewaart, verdwijnt het.

Daar komt pinning om de hoek kijken. Deze gids legt uit wat IPFS-pinning is, waarom het belangrijk is, hoe het onder de motorkap werkt en hoe je vandaag nog je eerste bestand kunt pinnen.

Pin je eerste bestand in 60 seconden#

IPFS is een peer-to-peer protocol voor het opslaan en delen van bestanden. In plaats van een bestand op te halen van een specifieke server (zoals https://example.com/photo.jpg), vraag je het aan op basis van zijn Content Identifier (CID) --- een cryptografische hash van de inhoud van het bestand. Elk knooppunt in het netwerk dat een kopie heeft, kan het aan je leveren.

Dit model heeft krachtige eigenschappen:

• Deduplicatie --- identieke bestanden delen dezelfde CID, dus het netwerk slaat nooit twee kopieën van dezelfde inhoud op.
• Integriteit --- de hash garandeert dat het bestand niet is gewijzigd.
• Decentralisatie --- geen enkele server heeft controle over de toegang.

Maar IPFS-knooppunten hebben beperkte schijfruimte en hebben een manier nodig om te beslissen welke data ze bewaren en welke ze verwijderen. Dat mechanisme heet garbage collection, en het is de reden waarom je bestanden kunnen verdwijnen.

Het Garbage Collection Probleem#

Elk IPFS-knooppunt onderhoudt een lokale blokopslag. Wanneer het knooppunt inhoud ophaalt namens jou --- bijvoorbeeld als je een afbeelding bekijkt via een publieke gateway --- worden de blokken tijdelijk gecached. Na verloop van tijd voert het knooppunt garbage collection uit om ruimte vrij te maken, en alle blokken die niet expliciet als belangrijk zijn gemarkeerd, worden verwijderd.

Hier is het cruciale punt: een bestand toevoegen aan IPFS garandeert niet dat het daar blijft. Als het enige knooppunt dat je bestand had offline gaat, of als dat knooppunt de blokken opruimt via garbage collection, wordt de inhoud onbereikbaar. De CID bestaat nog steeds als adres, maar er is niemand thuis.

Dit is by design. IPFS is een protocol voor inhoudsadressering, geen garantie voor permanente opslag. Permanentie vereist een expliciete beslissing om data te bewaren. Die beslissing heet pinning.

Wat is Pinning?#

Pinning zegt tegen een IPFS-knooppunt: “Bewaar deze inhoud. Verwijder het niet via garbage collection, wat er ook gebeurt.” Zie het als een bladwijzer in een fysiek boek --- het boek raakt die pagina niet kwijt alleen omdat de plank wordt geherorganiseerd.

Wanneer je een CID pint, markeert het knooppunt elk blok dat bij die inhoud hoort als beschermd. Garbage collection slaat die blokken volledig over.

Er zijn twee soorten pinning:

Lokale Pinning#

Je draait je eigen IPFS-knooppunt (bijvoorbeeld met Kubo) en pint bestanden direct:

ipfs pin add QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG

De inhoud blijft op je machine zolang je knooppunt draait en de pin actief blijft.

Remote Pinning#

Je stuurt een pin-verzoek naar een externe dienst die IPFS-infrastructuur beheert namens jou. De knooppunten van de dienst pinnen de inhoud en houden het 24/7 beschikbaar, zelfs wanneer je eigen machine uit staat.

Waarom Remote Pinning-diensten Bestaan#

Lokale pinning werkt, maar brengt operationele overhead met zich mee die de meeste ontwikkelaars en teams niet willen beheren:

• Beschikbaarheid --- Je laptop is niet 24 uur per dag online. Als je knooppunt offline gaat, kan niemand je gepinde bestanden van je ophalen.
• Bandbreedte --- Populaire bestanden serveren via een thuisverbinding wordt snel een bottleneck.
• Onderhoud --- Een IPFS-knooppunt draaien betekent software up-to-date houden, schijfgebruik monitoren, peer-verbindingen beheren en netwerkconfiguratie afhandelen.
• Redundantie --- Een enkel knooppunt is een single point of failure. Professionele pinning-diensten repliceren data doorgaans over meerdere knooppunten in verschillende regio’s.

Remote pinning-diensten lossen al deze problemen op. Je uploadt of pint je inhoud via een API, en de dienst zorgt voor infrastructuur, replicatie en beschikbaarheid. Jij richt je op het bouwen van je applicatie.

Hoe IPFS-pinning Onder de Motorkap Werkt#

1. Inhoud wordt Opgesplitst in Blokken#

Wanneer je een bestand toevoegt aan IPFS, splitst het knooppunt het op in chunks (doorgaans elk 256 KB). Elk chunk wordt individueel gehasht, wat een CID oplevert voor elk blok.

2. Een DAG wordt Geconstrueerd#

De blokken worden georganiseerd in een Directed Acyclic Graph (DAG) met een datastructuur genaamd Merkle DAG.

3. De Pin Beschermt de Gehele DAG#

Wanneer je een root-CID pint, markeert het knooppunt recursief het rootblok en elk blok waarnaar het verwijst als gepind. Dit heet een recursieve pin en is het standaardgedrag.

4. Het Knooppunt Kondigt Beschikbaarheid Aan#

Het pinnende knooppunt publiceert provider-records naar de IPFS Distributed Hash Table (DHT).

5. Garbage Collection Slaat Gepinde Blokken Over#

Gepinde blokken en hun afstammelingen worden bewaard. Al het andere komt in aanmerking voor verwijdering.

Pinning vs. Hosting#

Pinning betekent dat een IPFS-knooppunt de blokken bewaart en deelneemt aan het peer-to-peer netwerk om ze te serveren aan andere IPFS-knooppunten.

Hosting (via een gateway) betekent het bieden van een HTTP-eindpunt dat een CID vertaalt naar een standaard web-URL:

https://your-gateway.example.com/ipfs/QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco

Voor de prestatie-impact van pinning, zie IPFS-bestandsophaling versnellen.

Pinning-dienst Opties in 2026#

Voor een gedetailleerde vergelijking, zie Beste IPFS-pinning-diensten 2026.

Hoe een Bestand te Pinnen#

Upload en Pin met curl#

# Upload a JSON file --- the service pins it automatically
curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": {"name": "Alice", "score": 42}}'

Upload met JavaScript#

const response = await fetch("https://api.ipfs.ninja/upload/new", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: { name: "Alice", score: 42 },
  }),
});

const result = await response.json();
console.log("CID:", result.cid);

Voer dit soort uploads nooit uit met een ruwe API-sleutel in browsercode; onze gids over veilig gebruik van IPFS upload-tokens laat zien hoe u kortlevende, ondertekende tokens gebruikt in plaats daarvan.

Een Bestaande CID Pinnen#

curl -X POST https://api.ipfs.ninja/pin \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cid": "QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG", "description": "Project metadata"}'

Wanneer IPFS-pinning Gebruiken#

NFT Metadata en Media#

NFT-marktplaatsen en makers hebben token-metadata en artwork nodig die onbeperkt toegankelijk blijven.

Gedecentraliseerde Applicatie (dApp) Assets#

dApps die frontends, configuratiebestanden of door gebruikers gegenereerde inhoud via IPFS serveren, hebben die assets betrouwbaar beschikbaar nodig.

Permanente Documentatie#

Regelgevende indieningen, juridische documenten, academische papers en audit trails profiteren van inhoudsgeadresseerde opslag.

Censuurbestendig Publiceren#

Journalisten, activisten en organisaties in restrictieve omgevingen gebruiken IPFS om inhoud te publiceren die niet kan worden verwijderd door een enkele server aan te vallen.

Verifieerbare Data Pipelines#

Supply chain data, wetenschappelijke datasets en financiële records kunnen worden gehasht en gepind om een onveranderlijke audit trail te creëren.

Veelgemaakte Fouten om te Vermijden#

Aannemen dat IPFS Permanent Betekent#

Een bestand toevoegen aan IPFS maakt het adresseerbaar, niet permanent. Zonder pinning is je bestand slechts één garbage collection cyclus verwijderd van verdwijning.

Denken dat Pinning gelijk is aan Encryptie#

Pinning houdt je data beschikbaar --- het maakt ze niet privé. Iedereen die de CID kent kan de inhoud ophalen. Als je vertrouwelijkheid nodig hebt, versleutel je bestanden voordat je ze uploadt naar IPFS.

CID Onveranderlijkheid Negeren#

Een CID is een hash van de inhoud. Als je zelfs maar één byte verandert, krijg je een compleet andere CID. Voor veranderlijke referenties, kijk naar IPNS. Sommige pinning-diensten, zoals IPFS Ninja, bieden ingebouwde IPNS-ondersteuning.

Afhankelijk zijn van een Enkele Pin#

Voor kritieke data, overweeg pinning bij meerdere diensten of het onderhouden van een lokale pin als backup.

Prestaties bij Grote Bestanden Vergeten#

IPFS presteert het best met bestanden onder een paar honderd megabyte. Zeer grote bestanden kunnen traag zijn om over te dragen en duur om te pinnen.

Conclusie#

IPFS-pinning is het mechanisme dat inhoudsadressering transformeert van een leuk idee naar een betrouwbare opslagstrategie. Zonder pinning leven je bestanden op geleende tijd. Met pinning krijg je verifieerbare, gedecentraliseerde en persistente databeschikbaarheid.

Als je het wilt uitproberen, kun je bij ipfs.ninja tot 500 bestanden en 1 GB data gratis pinnen met een dedicated gateway --- geen creditcard vereist.

Klaar om je eerste bestand te pinnen? Bekijk onze stap-voor-stap upload gids om in minder dan twee minuten van nul naar een gepinde CID te gaan.

Welke dienst je ook kiest, het belangrijkste is: pin je inhoud. Je CID’s zullen je dankbaar zijn.

NFT-makers vertrouwen op IPFS-pinning om token-metadata permanent toegankelijk te houden — zie onze gids voor NFT-metadata-opslag voor implementatiedetails.