Pinning

Wie Dateien im IPFS-Netzwerk bestehen bleiben und warum Pinning wichtig ist.

Das Garbage-Collection-Problem

IPFS-Knoten haben begrenzten Speicherplatz. Um den Festplattenspeicher zu verwalten, führen sie regelmäßig Garbage Collection durch — einen Prozess, der zwischengespeicherte Daten entfernt, die nicht explizit als wichtig markiert wurden. Ohne Eingriff könnte eine hochgeladene Datei innerhalb von Stunden aus dem Netzwerk entfernt werden.

Pinning teilt einem IPFS-Knoten mit: „Behalte diese Datei permanent — sammle sie nicht bei der Garbage Collection ein." Eine gepinnte Datei bleibt unbegrenzt im Speicher des Knotens und stellt sicher, dass sie im Netzwerk verfügbar bleibt.

Lokales Pinning vs. Remote-Pinning

Lokales Pinning bedeutet, einen eigenen IPFS-Knoten zu betreiben und Dateien darauf zu pinnen. Sie sind für Betriebszeit, Speicher und Netzwerkkonnektivität verantwortlich. Wenn Ihr Knoten offline geht, werden Ihre Dateien unverfügbar.

Remote-Pinning (was IPFS.NINJA bietet) bedeutet, dass ein verwalteter Dienst Ihre Dateien auf einer Infrastruktur pinnt, die immer online ist. Sie erhalten die Beständigkeit des Pinnings, ohne einen eigenen Knoten betreiben zu müssen.

TIP

Jede über IPFS.NINJA hochgeladene Datei wird automatisch an unseren IPFS-Cluster gepinnt. Keine zusätzlichen Schritte erforderlich — Ihre Dateien sind ab dem Moment des Uploads persistent.

Was passiert beim Entpinnen

Wenn Sie eine Datei aus Ihrem IPFS.NINJA-Konto löschen, lösen wir das Pinning von unseren Knoten. Die Datei kann weiterhin zugänglich sein, wenn:

• Andere IPFS-Knoten denselben CID zwischengespeichert oder gepinnt haben
• Ein IPFS-Gateway die Datei in seinem Cache hat
• Ein anderer Benutzer denselben Inhalt hochgeladen hat (gleicher CID = gleiche Datei)

Im Laufe der Zeit wird die Datei ohne aktives Pinning eines Knotens vollständig aus dem Netzwerk entfernt.

Pinning-Best-Practices

• Frühzeitig pinnen — Laden Sie Ihren Inhalt hoch und pinnen Sie ihn, bevor Sie den CID in Smart Contracts, NFT-Metadaten oder externen Systemen referenzieren.
• Verlassen Sie sich nicht auf Caching — IPFS-Gateway-Caches sind temporär. Nur gepinnter Inhalt bleibt garantiert bestehen.
• Halten Sie Ihr Konto aktiv — Dateien bleiben gepinnt, solange Ihr IPFS.NINJA-Konto aktiv ist, auch im kostenlosen Tarif.

Bestehende Inhalte pinnen

Sie müssen eine Datei nicht über IPFS.NINJA hochladen, um sie zu pinnen. Wenn Inhalte bereits im IPFS-Netzwerk existieren — von jemand anderem hochgeladen oder von Ihnen über einen anderen Dienst — können Sie sie an Ihr Konto pinnen, indem Sie den CID angeben.

Wenn Sie einen bestehenden CID pinnen, führt unser Cluster folgende Schritte aus:

1. Durchsucht das IPFS-Netzwerk nach Knoten, die den Inhalt haben
2. Lädt den Inhalt vom nächstgelegenen verfügbaren Knoten herunter
3. Pinnt ihn lokal auf unserer Infrastruktur
4. Macht ihn über Ihr Konto und Gateway zugänglich

Dies ist nützlich für:

• NFT-Assets bewahren — Pinnen Sie Metadaten und Bilder bestehender Sammlungen
• Inhalte sichern — Stellen Sie sicher, dass wichtige CIDs verfügbar bleiben, auch wenn der ursprüngliche Pinner offline geht
• Von einem anderen Dienst migrieren — Pinnen Sie Ihre bestehenden CIDs, ohne die Dateien erneut hochladen zu müssen

Siehe die Pinning-API-Dokumentation für Endpunkt-Details.