Alternativa k Filebase: Jednodušší IPFS pinning bez S3

Rychlé srovnání: Filebase vs IPFS Ninja

Závěr: pokud již stejně zapojujete AWS SDK klienty, Filebase se přirozeně hodí. Pokud chcete odeslat soubor na IPFS jedním příkazem curl, IPFS Ninja vyhrává svou jednoduchostí.

Nahrajte soubor na IPFS za 30 sekund

Toto je postup nahrávání v IPFS Ninja. Žádné SDK, žádné XML, žádný krok vytváření bucketu:

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"
  }'

Odpověď:

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

Hotovo. Tento CID je připnutý, dostupný přes IPFS a okamžitě dosažitelný přes veřejnou bránu.

Nyní porovnejme ekvivalentní postup v Filebase:

1. Vytvořte účet a bucket v konzoli Filebase.
2. Vygenerujte pár přístupového klíče a tajného klíče.
3. Nakonfigurujte S3 klienta s endpointem https://s3.filebase.com, regionem us-east-1 a svými přihlašovacími údaji.
4. Zavolejte putObject s tělem souboru.
5. Dotazujte se na metadata objektu, abyste získali IPFS CID (objeví se jako hlavička x-amz-meta-cid poté, co jej Filebase připne).

To není špatně — je to jen více pohyblivých částí, než většina projektů s nativním REST potřebuje.

Proč vývojáři narážejí na tření se S3 v Filebase

S3 kompatibilita Filebase je skutečně užitečná, pokud:

• Máte existující infrastrukturu komunikující přes S3 (Lambda funkce, Terraform moduly, zálohovací agenti).
• Ukládáte velké soubory a chcete multipart upload sémantiku, kterou již znáte.
• Váš tým je zdatný v AWS a S3 SDK je již závislostí.

Mnozí vývojáři ale budují IPFS do webové aplikace, dApp nebo CI pipeline a z tohoto světa nepocházejí. Narážejí na:

XML chybové odpovědi. S3 vrací XML. Váš JavaScript fetch dostane zpět <?xml version="1.0" ...><Error><Code>InvalidAccessKeyId</Code> a musíte přidat XML parser, abyste to mohli ladit.

Správu přihlašovacích údajů. S3 autentizace (přístupový klíč + tajný klíč + HMAC-SHA256 podepisování požadavků) není triviální implementovat od nuly v prohlížeči nebo edge funkci. Pre-signed URL pomáhají, ale jejich generování na straně serveru přidává round trip.

CID jako dodatečná myšlenka. CID je metadata S3 objektu, nikoli primární odpověď. Buď parsujete hlavičky odpovědi, nebo voláte samostatný endpoint metadat.

Žádné nativní podepsané upload tokeny. Pokud chcete, aby uživatelé nahrávali přímo z prohlížeče bez odhalení serverových přihlašovacích údajů, Filebase vyžaduje, abyste si sami vybudovali endpoint pro generování pre-signed URL.

Podepsané upload tokeny IPFS Ninja zvládají tento vzor nativně: vygenerujte časově omezený token na serveru jednou, vložte jej do frontendu a nechte uživatele odesílat POST přímo na api.ipfs.ninja, dokud token nevyprší nebo jej nezrušíte.

Cenové plány vedle sebe

Pro malé až středně velké projekty je přechod z bezplatného na první placený plán $5/mo u IPFS Ninja oproti zhruba $20/mo u Filebase. Pokud budujete vedlejší projekt nebo MVP startupu, tento rozdíl hraje roli.

Srovnání funkcí brány

Obě služby nabízejí dedikované IPFS brány (subdomény, které servírují váš připnutý obsah přes HTTPS). Kde se liší:

Filebase poskytuje dedikovanou bránu na placených plánech. Servíruje obsah vašeho bucketu a integruje se s jejich S3 jmenným prostorem.

IPFS Ninja brány na https://{slug}.gw.ipfs.ninja podporují:

• Režimy přístupu: omezený (vyžaduje token), otevřený (veřejný) nebo složkový (výpis adresáře).
• IP whitelisting: zamkněte bránu na známé serverové IP adresy.
• Omezení origin: omezte na konkrétní HTTP originy, užitečné pro scénáře CORS pouze v prohlížeči.
• Optimalizace obrázků: endpoint /image/{cid} umožňuje změnu velikosti, ořez a konverzi formátu za chodu — není potřeba žádné samostatné image CDN.

Pokud je vaším případem použití servírování assetů do webového frontendu, omezení CORS origin a zabudované endpointy pro optimalizaci obrázků vám ušetří integraci samostatné služby.

Pinování existujícího CID

Máte již CID z jiného uzlu nebo služby? Obě platformy vám umožňují jej připnout bez opětovného nahrávání. V 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"
  }'

V Filebase pinujete přes PUT do vašeho bucketu s CID jako hlavičkou vlastních metadat, pak Filebase obsah načte a připne. Workflow orientovaný na CID v IPFS Ninja je přímočařejší, pokud přicházíte z IPFS-nativního myšlení, nikoli S3-nativního.

Podrobnější vysvětlení toho, proč pinování záleží a co se stane, když obsah není připnutý, najdete v článku co je IPFS pinning.

Nahrávání ze strany klienta bez odhalení přihlašovacích údajů

Toto je běžná architektonická otázka: jak nechat prohlížeč nahrávat na IPFS bez odeslání API klíče klientovi?

Přístup Filebase: vygenerujte pre-signed S3 PUT URL na serveru, vraťte ji klientovi, klient provede PUT přímo. Standardní S3 pre-sign vzor, funguje dobře, ale musíte implementovat serverový podepisovací endpoint.

Přístup IPFS Ninja: zavolejte /token/upload/new (nebo vygenerujte přes dashboard) pro vytvoření podepsaného upload tokenu. Vložte tento token do frontendu. Klient odesílá POST na api.ipfs.ninja s Authorization: Signed {token}. Token může být nastaven na vypršení po určité době nebo okamžitě zrušen z dashboardu.

// 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);

Podrobnější průvodce vzory nahrávání najdete v článku jak nahrát soubory na IPFS.

Kdy přesto zvolit Filebase

Tento článek má být upřímný, nikoli jednostranný.

Zvolte Filebase, pokud:

• Váš kód již používá AWS SDK v3 nebo Boto3 a nechcete žádné další závislosti.
• Migrujete z S3 na IPFS a chcete vyměnit endpointy místo přepisování logiky nahrávání.
• Ukládáte velmi velké soubory a potřebujete spolehlivý multipart upload se S3 sémantikou (i když IPFS Ninja také má API pro velké uploady).
• Váš tým má hluboké znalosti AWS a považuje S3 autentizaci za familiárnější než REST hlavičky.

Zvolte IPFS Ninja, pokud:

• Chcete jediný POST /upload/new, který vrátí CID bez mezikroků.
• Budujete aplikaci orientovanou na frontend a potřebujete bezpečné upload tokeny pro klienty bez budování pre-sign infrastruktury.
• Chcete optimalizaci obrázků a brány s řízeným přístupem bez přidávání další služby.
• Záleží vám na ceně a vstupní bod $5/mo je pro vaše stadium projektu důležitý.

Shrnutí

Filebase je solidní produkt pro týmy, které již žijí v ekosystému AWS. Jeho S3 kompatibilita je skutečnou výhodou, pokud je to váš kontext. Ale pro vývojáře, kteří chtějí jednoduše připnout soubory na IPFS přes čisté REST API — a okamžitě dostat zpět CID — přidává vrstva S3 ceremoniál bez užitku.

IPFS Ninja udržuje povrch API minimální: nahrát, připnout, načíst. Brána, optimalizace obrázků a funkce upload tokenů jsou dostupné, když je potřebujete, nikoli vyžadované hned na začátku.

Pro širší přehled toho, jak IPFS Ninja srovnává s dalšími službami, navštivte nejlepší IPFS pinning služby.

Připraveni začít pinovat? Vytvořte bezplatný účet — 500 souborů, 1 GB úložiště, bez platební karty.

O tomto článku: Tento článek byl vypracován AI asistentem pomocí workflow pro generování obsahu IPFS.NINJA, poté zkontrolován a schválen Nachem Collem. Všechny příklady kódu byly ověřeny oproti živému IPFS.NINJA API. Pokud zjistíte nepřesnost, otevřete prosím issue na https://github.com/ipfs-ninja/feedback. Přečtěte si více o tom, jak používáme AI v našem obsahu a seznamte se s lidmi za IPFS.NINJA.