Filebase Alternative: IPFS Pinning ohne S3-Komplexität

Schnellvergleich: Filebase vs. IPFS Ninja

Fazit: Wer ohnehin AWS-SDK-Clients einrichtet, integriert Filebase problemlos. Wer eine Datei mit einem einzigen curl-Befehl auf IPFS hochladen will, ist mit IPFS Ninja deutlich schneller am Ziel.

Eine Datei in 30 Sekunden auf IPFS hochladen

So sieht der Upload-Weg bei IPFS Ninja aus. Kein SDK, kein XML, kein Bucket-Setup:

curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from IPFS Ninja!",
    "description": "My first file"
  }'

Antwort:

{
  "cid": "bafkreib4mrow...",
  "sizeMB": 0.00002,
  "uris": {
    "ipfs": "ipfs://bafkreib4mrow...",
    "url": "https://ipfs.ninja/ipfs/bafkreib4mrow..."
  }
}

Fertig. Die CID ist gepinnt, über IPFS erreichbar und sofort über das öffentliche Gateway verfügbar.

Zum Vergleich der entsprechende Ablauf mit Filebase:

1. Konto anlegen und einen Bucket in der Filebase-Konsole erstellen.
2. Ein Access-Key-/Secret-Key-Paar generieren.
3. Einen S3-Client mit dem Endpunkt https://s3.filebase.com, Region us-east-1 und den eigenen Zugangsdaten konfigurieren.
4. putObject mit dem Dateiinhalt aufrufen.
5. Die Metadaten des Objekts abfragen, um die IPFS CID zu ermitteln — sie erscheint als x-amz-meta-cid-Header, nachdem Filebase den Pin gesetzt hat.

Das ist nicht falsch — es sind schlicht mehr bewegliche Teile, als die meisten REST-nativen Projekte brauchen.

Warum Entwickler bei Filebase auf S3-Reibung stoßen

Filebase’s S3-Kompatibilität ist genuinen Nutzen, wenn:

• Die bestehende Infrastruktur bereits mit S3 kommuniziert (Lambda-Funktionen, Terraform-Module, Backup-Agenten).
• Große Blobs gespeichert werden und Multipart-Upload-Semantik bereits bekannt ist.
• Das Team AWS-versiert ist und das S3-SDK bereits als Abhängigkeit vorhanden ist.

Viele Entwickler, die IPFS in eine Web-App, eine dApp oder eine CI-Pipeline einbauen, kommen jedoch nicht aus dieser Welt. Sie stoßen auf:

XML-Fehlerantworten. S3 liefert XML zurück. Ein JavaScript-fetch-Aufruf erhält <?xml version="1.0" ...><Error><Code>InvalidAccessKeyId</Code> — und man muss einen XML-Parser hinzufügen, um das zu debuggen.

Credential-Management. S3-Style-Auth (Access Key + Secret + HMAC-SHA256-Request-Signing) ist im Browser oder in einer Edge-Function nicht trivial von Grund auf zu implementieren. Pre-signed URLs helfen, aber deren serverseitige Generierung kostet einen zusätzlichen Round-Trip.

CID-Abfrage als Nachgedanke. Die CID ist Metadaten am S3-Objekt, nicht die primäre Antwort. Man muss entweder Response-Header parsen oder einen separaten Metadaten-Endpunkt aufrufen.

Keine nativen signierten Upload-Tokens. Sollen Nutzer direkt vom Browser hochladen, ohne Server-Credentials preiszugeben, muss bei Filebase ein eigener Endpunkt zur Pre-signed-URL-Generierung gebaut werden.

IPFS Ninjas signierte Upload-Tokens decken dieses Muster nativ ab: einmalig serverseitig ein zeitlich begrenztes Token erzeugen, ins Frontend einbetten und Nutzer direkt auf api.ipfs.ninja POSTen lassen — bis das Token abläuft oder widerrufen wird.

Preisvergleich

Bei kleinen bis mittelgroßen Projekten beträgt der Sprung vom Free-Tier zum ersten Bezahltarif $5/mo bei IPFS Ninja gegenüber rund $20/mo bei Filebase. Für Side-Projects oder Startup-MVPs ist dieser Unterschied relevant.

Gateway-Features im Vergleich

Beide Dienste bieten dedizierte IPFS-Gateways (Subdomains, die gepinnten Content per HTTPS ausliefern). Die Unterschiede:

Filebase stellt auf bezahlten Plänen ein dediziertes Gateway bereit. Es liefert den Bucket-Inhalt aus und ist in den S3-Namespace integriert.

IPFS Ninja-Gateways unter https://{slug}.gw.ipfs.ninja unterstützen:

• Zugriffsmodi: restricted (Token erforderlich), open (öffentlich) oder folder (Verzeichnislisting).
• IP-Whitelisting: Gateway auf bekannte Server-IPs beschränken.
• Origin-Einschränkungen: auf bestimmte HTTP-Origins begrenzen — nützlich für reine Browser-CORS-Szenarien.
• Bildoptimierung: Der Endpunkt /image/{cid} ermöglicht Größenänderung, Zuschnitt und Formatkonvertierung on the fly — kein separates Image-CDN nötig.

Für Use-Cases, bei denen Assets an ein Web-Frontend ausgeliefert werden, sparen die CORS-Origin-Einschränkung und die eingebauten Bildoptimierungs-Endpunkte eine zusätzliche Service-Integration.

Eine vorhandene CID pinnen

Bereits eine CID von einem anderen Node oder Dienst? Beide Plattformen ermöglichen das Pinnen ohne erneuten Upload. Bei IPFS Ninja:

curl -X POST https://api.ipfs.ninja/pin \
  -H "X-Api-Key: bws_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{
    "cid": "bafkreib4mrow...",
    "description": "Pinned from external source"
  }'

Bei Filebase wird per PUT in einen Bucket mit der CID als Custom-Metadata-Header gepinnt; Filebase holt den Content dann selbst und pinnt ihn. Der CID-first-Workflow bei IPFS Ninja ist direkter, wenn man aus einer IPFS-nativen statt einer S3-nativen Denkweise kommt.

Eine ausführlichere Erklärung, warum Pinning wichtig ist und was passiert, wenn Content nicht gepinnt ist, liefert what is IPFS pinning.

Client-seitige Uploads ohne Credential-Leak

Eine häufige Architekturfrage: Wie lässt man einen Browser auf IPFS hochladen, ohne den API-Key an den Client auszuliefern?

Filebase-Ansatz: Serverseitig eine Pre-signed S3 PUT URL generieren, an den Client zurückgeben, Client führt den PUT direkt durch. Klassisches S3-Pre-sign-Pattern, funktioniert — erfordert aber die Implementierung eines serverseitigen Signing-Endpunkts.

IPFS Ninja-Ansatz: /token/upload/new aufrufen (oder über das Dashboard generieren), um ein signiertes Upload-Token zu erstellen. Das Token ins Frontend einbetten. Der Client postet an api.ipfs.ninja mit Authorization: Signed {token}. Das Token kann so konfiguriert werden, dass es nach einer bestimmten Zeit abläuft, und lässt sich jederzeit aus dem Dashboard heraus widerrufen.

// Frontend code — token was fetched from your server
const token = 'your-signed-upload-token';

const response = await fetch('https://api.ipfs.ninja/upload/new', {
  method: 'POST',
  headers: {
    'Authorization': `Signed ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    content: btoa(fileContentAsArrayBuffer), // base64 for binary
    description: 'User uploaded file',
  }),
});

const { cid, uris } = await response.json();
console.log('Pinned at:', uris.url);

Eine ausführliche Beschreibung der Upload-Muster findet sich unter how to upload files to IPFS.

Wann Filebase die bessere Wahl ist

Dieser Artikel soll ehrlich sein, kein einseitiger Werbetext.

Filebase wählen, wenn:

• Die Codebasis bereits AWS SDK v3 oder Boto3 verwendet und keine zusätzlichen Abhängigkeiten gewünscht sind.
• Eine Migration von S3 zu IPFS ansteht und nur Endpunkte ausgetauscht statt Upload-Logik neu geschrieben werden soll.
• Sehr große Dateien gespeichert werden und zuverlässiger Multipart-Upload mit S3-Semantik benötigt wird (IPFS Ninja bietet allerdings ebenfalls eine Large-Upload-API).
• Das Team tiefe AWS-Expertise mitbringt und S3-Auth vertrauter ist als REST-Header.

IPFS Ninja wählen, wenn:

• Ein einziges POST /upload/new genügen soll, um sofort eine CID zu erhalten — ohne Zwischenschritte.
• Eine Frontend-first-App entwickelt wird und client-sichere Upload-Tokens ohne Pre-sign-Infrastruktur benötigt werden.
• Bildoptimierung und zugriffskontrollierte Gateways gewünscht sind, ohne einen weiteren Dienst hinzuzufügen.
• Der Preis eine Rolle spielt und der Einstiegspreis von $5/mo für die Projektphase relevant ist.

Zusammenfassung

Filebase ist ein solides Produkt für Teams, die bereits im AWS-Ökosystem zuhause sind. Die S3-Kompatibilität ist ein echter Vorteil — im richtigen Kontext. Für Entwickler, die Dateien einfach über eine saubere REST API auf IPFS pinnen und sofort eine CID zurückbekommen wollen, fügt die S3-Schicht nur Aufwand ohne Mehrwert hinzu.

IPFS Ninja hält die API-Oberfläche minimal: hochladen, pinnen, abrufen. Gateway, Bildoptimierung und Upload-Tokens sind verfügbar, wenn man sie braucht — nicht als Pflichtbestandteil.

Einen breiteren Vergleich von IPFS Ninja mit anderen Diensten bietet best IPFS pinning services.

Bereit zum Pinnen? Kostenloses Konto erstellen — 500 Dateien, 1 GB Speicher, keine Kreditkarte erforderlich.

Über diesen Artikel: Dieser Artikel wurde von einem KI-Assistenten auf Basis des Content-Generation-Workflows von IPFS.NINJA erstellt und anschließend von Nacho Coll geprüft und freigegeben. Alle Code-Beispiele wurden gegen die Live-API von IPFS.NINJA verifiziert. Bei Ungenauigkeiten bitte ein Issue unter https://github.com/ipfs-ninja/feedback eröffnen. Mehr darüber, wie wir KI in unseren Inhalten einsetzen, und ein Porträt der Menschen hinter IPFS.NINJA.