GYIK

Gyakran ismételt kérdések az IPFS Ninja-ról.

Általános

Mi az IPFS Ninja?

Az IPFS Ninja egy menedzselt IPFS rögzítési szolgáltatás. Bármilyen fájlt feltölthet egy egyszerű REST API-n keresztül, vagy rögzíthet meglévő CID-eket az IPFS hálózatról. Minden fájl kap egy állandó tartalomazonosítót (CID), és elérhető a gateway-ünkön az ipfs.ninja/ipfs/<CID> címen.

Az ipfs.ninja/ipfs/<CID> az IPFS hálózat bármely CID-jét kiszolgálja?

Nem. Az apex átjáró csak azokat a CID-eket szolgálja ki, amelyeket egy IPFS Ninja felhasználó töltött fel vagy rögzített. Az ismeretlen CID-ek kérésére HTTP 410 Gone választ ad, és nyilvános IPFS átjárókra (ipfs.io, dweb.link) mutat. Harmadik féltől származó CID kiszolgálásához az átjárónkon keresztül először futtasson POST /pin-t a fiókjára — a rögzítés után a CID elérhető lesz mind az apex, mind a dedikált átjárója URL-jén.

Mi a különbség az apex átjáró és a dedikált átjáró között?

Szempont	Apex ipfs.ninja/ipfs/<CID>	Dedikált <slug>.gw.ipfs.ninja/ipfs/<CID>
Hatókör	Megosztott minden felhasználó között	Csak az Ön CID-jei
Hitelesítés	Nincs	Opcionális token / IP allowlist / origin allowlist
SLA	Best-effort	Teljes SLA
Ajánlott	Alkalmi linkekhez	Produkciós beágyazáshoz (NFT, videó, webhelyek)
Sebességkorlátok	Megosztva IP-nként + CID-nként	Csomagonként, konfigurálható

Mindkettő ugyanazt a tartalmat szolgálja ki. Produkciós forgalomhoz használja a dedikált átjárót.

Milyen fájltípusok támogatottak?

Minden fájltípus támogatott. JSON objektumok és tömbök közvetlenül küldhetők. Minden más fájl (képek, PDF-ek, HTML, videó, audió, bináris fájlok) base64-kódolt tartalomként küldhető.

Van fájlméret-korlát?

Az egyes feltöltéseket a csomagja tárolási kerete korlátozza. Nincs fájlonkénti méretkorlát az elérhető tárhelyen túl.

Rögzíthetek már létező IPFS tartalmat?

Igen. Használja a POST /pin végpontot bármilyen érvényes CID-del. A klaszterünk lekéri a tartalmat az IPFS hálózatról, és rögzíti a fiókjához. Részletekért lásd a Pinning API dokumentációt.

Mennyi ideig tart a rögzítés?

A fájl méretétől és attól függ, hány IPFS csomópont rendelkezik a tartalommal. Kis, jól elosztott fájlok másodpercek alatt rögzítésre kerülnek. Nagy vagy ritkán rögzített tartalom néhány percet vehet igénybe. A rögzítési végpont azonnal visszatér pinning állapottal — kérdezze le a GET /pin/:cid végpontot a folyamat ellenőrzéséhez.

Mi történik, ha egy CID nem található?

Az állapot failed-re változik. Ez azt jelenti, hogy a CID érvénytelen, vagy a tartalom már nem elérhető egyetlen elérhető IPFS csomóponton sem.

Nyilvánosak az IPFS-re feltöltött adatok?

Igen. Minden IPFS-re rögzített tartalom nyilvánosan elérhető a CID-jén keresztül bármely IPFS gateway-en. Ha privát hozzáférésre van szüksége, használjon dedikált gateway-t token-kötelező módban — ez korlátozza a hozzáférést a gateway-én keresztül, bár a tartalom továbbra is elérhető marad a tágabb IPFS hálózaton.

Miért változtak az új CID-jeim Qm...-ról bafy...-ra?

Az új feltöltések és rögzítések modern CIDv1-et adnak vissza (bafk… kis, egyblokkos tartalomhoz, bafy… nagyobb fájlokhoz és könyvtárakhoz) az IPIP-0499 unixfs-v1-2025 profil szerint: CIDv1 base32 kódolás, 1 MiB darabok, raw leaf-ek. Ez megegyezik azzal, amit a modern eszközök (Helia, legújabb Kubo, ipfs-car) ugyanahhoz a tartalomhoz előállítanak, így a nálunk feltöltött fájl ugyanazt a CID-et kapja, amit bármely modern kliens ugyanazokból a byte-okból számítana.

A korábbi feltöltésekből származó örökölt Qm… CID-ek mindenhol teljes mértékben feloldhatók maradnak — a gateway, a POST /pin, a GET /file, az IPNS és minden más végpont mindkét formátumot korlátlan ideig elfogadja. Semmi, amit már megszerzett, nem szűnik meg működni.

Hogyan rögzíthetek olyan tartalmat, amely egy privát / nem-DHT csomóponton él?

A POST /pin opcionális multiaddresses[] paramétert fogad (legfeljebb 5-öt). Ha megadja, a klaszterünk minden hint-hez futtat egy ipfs swarm connect <multiaddr>-t a rögzítés előtt, így az olyan peer-eken lévő tartalom, amelyek nem hirdetik magukat a nyilvános DHT-n (privát csomópontok, staging környezetek, VPN-lokális gépek), elérhetővé válik. Lásd a Rögzítés privát IPFS csomópontról útmutatót.

Megmaradnak a fájljaim az IPFS-en, ha megszüntetem a fiókomat?

A megszüntetéskor eltávolítjuk a fájljait a csomópontjainkról. Ha más IPFS csomópontok gyorsítótárazták a tartalmát, az továbbra is elérhető lehet. Aktív rögzítés nélkül azonban a fájlokat végül a hálózaton keresztül a szemétgyűjtés eltávolítja.

Hitelesítés és API

Hogyan hitelesítem az API kéréseket?

Adja meg API kulcsát az X-Api-Key fejlécen keresztül. Kulcsokat az irányítópult API kulcsok oldaláról generálhat.

Vannak API sebességkorlátok?

Nem. Az IPFS Ninja nem alkalmaz sebességkorlátokat az API kérésekre. Bármely csomagon annyi kérést küldhet, amennyit szükséges.

Lejárnak az API kulcsok?

Nem. Az API kulcsok mindaddig érvényesek, amíg nem törli őket. Több kulcsot is létrehozhat, és egyenként visszavonhatja őket.

Mi a különbség az API kulcsok és a gateway tokenek között?

Az API kulcsok (bws_) teljes hozzáféréssel rendelkeznek — feltöltés, törlés, fájlok listázása. A gateway tokenek (gwt_) csak olvasásra alkalmasak, és csak a dedikált gateway-én keresztül férhetnek hozzá a fájlokhoz. A gateway tokeneket biztonságosan beágyazhatja frontend alkalmazásokba.

Dedikált gateway-ek

Mi az a dedikált gateway?

Egy privát IPFS gateway a saját aldoménjén (pl. abc123.gw.ipfs.ninja), amely csak a fiókjához rögzített fájlokat szolgálja ki. A nyilvános gateway-vel ellentétben nem old fel más felhasználók CID-jeit.

Melyik csomagok tartalmazzák a dedikált gateway-t?

A dedikált gateway-ek minden fizetős csomagon elérhetők (Bodhi 5 $/hó, Karma 19 $/hó, Nirvana 59 $/hó). Minden csomag havi sávszélesség-kerete fedezi mind az apex, mind a dedikált gateway forgalmát. A csomagonkénti kereteket lásd lentebb, a „Vannak sávszélesség-díjak?" kérdésnél.

Korlátozhatom, ki fér hozzá a gateway-emhez?

Igen. Engedélyezheti a token-kötelező módot (minden kérésnél gwt_ token szükséges) és/vagy beállíthat IP fehérlistát (legfeljebb 100 cím).

Korlátozhatom a gateway-emet forrás/domain szerint?

Igen. Konfigurálja az allowedOrigins beállítást a gateway beállításokban HTTPS források listájával. Csak az adott forrásokból érkező böngészőkérések lesznek engedélyezve. A böngészőn kívüli kérések (Origin fejléc nélkül) korlátozás nélkül átmennek. Az üres lista minden forrást engedélyez.

Mik azok az aláírt feltöltési tokenek?

Az aláírt feltöltési tokenek időkorlátozott hitelesítő adatok kliensoldali feltöltésekhez. A szerverén generálja őket a POST /upload/signed-url segítségével, és átadja böngészőknek vagy mobilalkalmazásoknak. A kliens az Authorization: Signed <token> fejléccel hitelesít az API kulcs felfedése helyett. Minden token nyomon követi a használatot, és automatikusan lejár. Részletekért lásd az Aláírt tokenek dokumentációt.

Optimalizálhatom az IPFS-ről kiszolgált képeket?

Igen. Használja a GET /image/:cid végpontot w, h, format és quality lekérdezési paraméterekkel a képek átméretezéséhez, konvertálásához és tömörítéséhez menet közben. A válaszok a tartalom-alapú CID alapján gyorsítótárazásra kerülnek. Minden csomagon működik. Lásd Képoptimalizálás.

Csatolhatok metaadatokat a fájlokhoz?

Igen. Adjon meg egy metadata objektumot legfeljebb 10 kulcs-érték párral feltöltéskor a POST /upload/new vagy rögzítéskor a POST /pin végponton. A metaadatok a fájllistákban és a fájl részletező végponton kerülnek visszaadásra. Lásd a Fájlok és Rögzítés dokumentációt.

Számlázás és csomagok

Van ingyenes csomag?

Igen. A Dharma csomag örökre ingyenes — 1 GB tárhely, korlátlan API kérés, bankkártya nem szükséges.

Vannak sávszélesség-díjak?

Nincs mért sávszélesség-díj egyik csomagon sem. Minden csomag tartalmaz egy havi gateway sávszélesség-keretet, amely kemény korlát — a tartalma leáll az apex és a dedikált gateway-eken, amint eléri a keretet, és a következő hónap 1. napján vagy egy frissítés után folytatódik:

Csomag	Havi sávszélesség
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Figyelmeztető e-mailt kap a kerete 80%-ánál és 100%-ánál.

Megújul a tárhely?

A tárhely nem újul meg. A csomagja tartalmaz egy összesített tárhelykeretet (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Hely felszabadításához törölje a már nem szükséges fájlokat. A csomag frissítése növeli az összesített keretet.

Bármikor lemondhatom?

Igen. Mondja le előfizetését a számlázási portálon keresztül — nincs kötöttség. Fiókja visszaáll az ingyenes szintre, és a meglévő rögzített fájlok elérhetők maradnak.

Mi történik a fájljaimmal, ha visszalépek?

A fájljai rögzítve maradnak az IPFS-en, de nem tölthet fel többet, ha jelenlegi használata meghaladja az új csomag tárhelykorlátját. Töröljön fájlokat, hogy visszakerüljön a korlát alá.

Biztonság

Titkosítva vannak az adataim?

Minden adat titkosítva van átvitel közben TLS/HTTPS-en keresztül. A hitelesítés JWT tokeneket (Cognito) és biztonságosan tárolt API kulcsokat használ. Az IPFS-en lévő fájltartalom nincs titkosítva nyugalmi állapotban — az IPFS eleve nyilvános hálózat.

Biztonságos az API kulcsok használata a szerveroldali kódomban?

Igen. Az API kulcsok szerveroldali használatra készültek. Soha ne tegye ki őket kliensoldali kódban. A kliensoldali fájlhozzáféréshez használjon gateway tokeneket (gwt_), amelyek csak olvasásra alkalmasak.

Támogatás

Hogyan kaphatok segítséget?

Írjon az info@ipfs.ninja címre, vagy tekintse meg az API referencia dokumentációt.

Van SLA?

Törekszünk a magas rendelkezésre állásra, de jelenleg nem kínálunk formális SLA-t. A szolgáltatás „ahogy van" alapon kerül biztosításra.