DUK

Dažnai užduodami klausimai apie IPFS Ninja.

Bendra informacija

Kas yra IPFS Ninja?

IPFS Ninja yra valdoma IPFS prisegimo paslauga. Įkeliate bet kokį failą per paprastą REST API arba prisegate esamus CID iš IPFS tinklo. Kiekvienas failas gauna nuolatinį turinio identifikatorių (CID) ir yra pasiekiamas per mūsų gateway adresu ipfs.ninja/ipfs/<CID>.

Ar ipfs.ninja/ipfs/<CID> aptarnauja bet kurį CID IPFS tinkle?

Ne. Apex gateway aptarnauja tik CID, kuriuos įkėlė ar prisegė IPFS Ninja vartotojas. Užklausos nežinomiems CID grąžina HTTP 410 Gone su nuoroda į viešus IPFS gateway (ipfs.io, dweb.link). Norėdami aptarnauti trečiosios šalies CID per mūsų gateway, pirma atlikite POST /pin į savo paskyrą — kai prisegta, CID tampa pasiekiamas tiek apex, tiek jūsų dedikuoto gateway URL.

Kuo skiriasi apex gateway ir dedikuotas gateway?

Aspektas	Apex ipfs.ninja/ipfs/<CID>	Dedikuotas <slug>.gw.ipfs.ninja/ipfs/<CID>
Apimtis	Bendrai naudojama visų vartotojų	Tik jūsų CID
Autentifikavimas	Nėra	Pasirenkamas tokenas / IP sąrašas / kilmės sąrašas
SLA	Geriausių pastangų principu	Pilnas SLA
Rekomenduojama	Atsitiktinėms nuorodoms	Produkciniam įterpimui (NFT, vaizdo įrašai, svetainės)
Greičio limitai	Bendri pagal IP + pagal CID	Pagal planą, konfigūruojama

Abu aptarnauja identišką turinį. Produkciniam srautui naudokite dedikuotą gateway.

Kokie failų tipai palaikomi?

Visi failų tipai palaikomi. JSON objektus ir masyvus galima siųsti tiesiogiai. Visi kiti failai (vaizdai, PDF, HTML, vaizdo įrašai, garso įrašai, dvejetainiai) siunčiami kaip base64 koduotas turinys.

Ar yra failo dydžio apribojimas?

Atskirus įkėlimus riboja jūsų plano saugyklos kvota. Atskiram failui nėra dydžio apribojimo, išskyrus jūsų turimą saugyklą.

Ar galiu prisegti turinį, kuris jau yra IPFS?

Taip. Naudokite POST /pin su bet kokiu galiojančiu CID. Mūsų klasteris gaus turinį iš IPFS tinklo ir prisegs jį prie jūsų paskyros. Žiūrėkite Prisegimo API dokumentaciją daugiau informacijos.

Kiek laiko užtrunka prisegimas?

Tai priklauso nuo failo dydžio ir to, kiek IPFS mazgų turi turinį. Maži, gerai paskirstyti failai prisegami per sekundes. Didelis ar retai prisegtas turinys gali užtrukti kelias minutes. Prisegimo galinis taškas grąžina iš karto su būsena pinning — apklauskite GET /pin/:cid norėdami patikrinti eigą.

Kas nutinka, jei CID nerandamas?

Būsena pasikeičia į failed. Tai reiškia, kad CID yra neteisingas arba turinys nebepasiekiamas jokiame pasiekiamame IPFS mazge.

Ar į IPFS įkelti duomenys yra vieši?

Taip. Visas IPFS prisegtas turinys yra viešai pasiekiamas per jo CID bet kuriame IPFS gateway. Jei reikia privačios prieigos, naudokite dedikuotą gateway su tokeno reikalavimo režimu — tai apriboja prieigą per jūsų gateway, nors turinys lieka pasiekiamas platesniame IPFS tinkle.

Kodėl mano nauji CID pasikeitė iš Qm... į bafy...?

Nauji įkėlimai ir prisegimai grąžina modernų CIDv1 (bafk… mažam vienbloko turiniui, bafy… didesniems failams ir katalogams) pagal IPIP-0499 unixfs-v1-2025 profilį: CIDv1 base32 kodavimas, 1 MiB gabalai, raw lapai. Tai atitinka tai, ką sukuria moderni įrankinė (Helia, naujausias Kubo, ipfs-car) tam pačiam turiniui, todėl per mus įkeltas failas gauna tą patį CID, kokį apskaičiuotų bet kuris modernus klientas iš tų pačių baitų.

Ankstesnių įkėlimų senesni Qm… CID lieka visiškai išsprendžiami — gateway, POST /pin, GET /file, IPNS ir kiekvienas kitas galinis taškas priima abu formatus neribotą laiką. Niekas, ką jau turite, nustoja veikti.

Kaip prisegti turinį, esantį privačiame / ne-DHT mazge?

POST /pin priima pasirenkamą multiaddresses[] (iki 5). Jei pateikta, mūsų klasteris kiekvienai užuominai atlieka ipfs swarm connect <multiaddr> prieš prisegimą, todėl turinys mazguose, kurie neskelbiami per viešą DHT (privatūs mazgai, etapinės (staging) aplinkos, VPN vietiniai kompiuteriai), tampa pasiekiamas. Žiūrėkite vadovą Prisegimas iš privataus IPFS mazgo.

Ar mano failai liks IPFS, jei atšauksiu paskyrą?

Mes atsegame jūsų failus iš mūsų mazgų, kai atšaukiate. Jei kiti IPFS mazgai yra išsaugoję jūsų turinį podėlyje, jis gali likti pasiekiamas. Tačiau be aktyvaus prisegimo failai galiausiai bus pašalinti šiukšlių surinkimo metu visame tinkle.

Autentifikacija ir API

Kaip autentifikuoti API užklausas?

Perduokite savo API raktą per X-Api-Key antraštę. Generuokite raktus iš API raktai puslapio savo prietaisų skydelyje.

Ar yra API greičio apribojimai?

Ne. IPFS Ninja netaiko greičio apribojimų API užklausoms. Galite atlikti tiek užklausų, kiek reikia, bet kuriame plane.

Ar API raktai baigia galioti?

Ne. API raktai galioja, kol juos ištrinsite. Galite sukurti kelis raktus ir atšaukti juos atskirai.

Koks skirtumas tarp API raktų ir gateway tokenų?

API raktai (bws_) turi pilną prieigą — įkelti, ištrinti, pateikti failų sąrašą. Gateway tokenai (gwt_) yra tik skaitymui ir gali pasiekti failus tik per jūsų dedikuotą gateway. Gateway tokenus saugu naudoti frontend programose.

Dedikuoti gateway

Kas yra dedikuotas gateway?

Privatus IPFS gateway jūsų paties poddomenyje (pvz., abc123.gw.ipfs.ninja), kuris aptarnauja tik prie jūsų paskyros prisegtus failus. Skirtingai nei viešasis gateway, jis neišspręs kitų naudotojų CID.

Kurie planai apima dedikuotą gateway?

Dedikuoti gateway prieinami visuose mokamuose planuose (Bodhi 5 $/mėn., Karma 19 $/mėn., Nirvana 59 $/mėn.). Kiekvieno plano mėnesinė pralaidumo kvota apima srautą tiek iš apex, tiek iš dedikuoto gateway. Žiūrėkite „Ar yra pralaidumo mokesčiai?“ žemiau dėl kvotų pagal planą.

Ar galiu apriboti, kas pasiekia mano gateway?

Taip. Galite įjungti tokeno reikalavimo režimą (reikalauja gwt_ tokeno kiekvienai užklausai) ir/arba nustatyti IP adresų baltąjį sąrašą (iki 100 adresų).

Ar galiu apriboti savo gateway pagal kilmę/domeną?

Taip. Konfigūruokite allowedOrigins savo gateway nustatymuose su HTTPS kilmių sąrašu. Leidžiamos tik naršyklės užklausos iš tų kilmių. Nenaršyklės užklausos (be Origin antraštės) praleidžiamos. Tuščias sąrašas leidžia visas kilmes.

Kas yra pasirašyti įkėlimo tokenai?

Pasirašyti įkėlimo tokenai yra riboto laiko kredencialai kliento pusės įkėlimams. Generuojate juos savo serveryje naudodami POST /upload/signed-url ir perduodate naršyklėms ar mobiliosioms programoms. Klientas autentifikuojasi Authorization: Signed <token> vietoj API rakto atskleidimo. Kiekvienas tokenas seka naudojimą ir baigia galioti automatiškai. Žiūrėkite pasirašytų tokenų dokumentaciją daugiau informacijos.

Ar galiu optimizuoti vaizdus, pateikiamus iš IPFS?

Taip. Naudokite GET /image/:cid su užklausos parametrais kaip w, h, format ir quality, kad pakeistumėte dydį, konvertuotumėte ir suspaustumėte vaizdus iš karto. Atsakymai talpinami podėlyje pagal turinio adresuotą CID. Tai veikia visuose planuose. Žiūrėkite Vaizdo optimizavimas.

Ar galiu pridėti metaduomenis prie failų?

Taip. Įtraukite metadata objektą su iki 10 rakto-reikšmės porų įkeliant per POST /upload/new arba prisegant per POST /pin. Metaduomenys grąžinami failų sąrašuose ir failo detalių galiniame taške. Žiūrėkite Failai ir Prisegimas dokumentaciją.

Atsiskaitymas ir planai

Ar yra nemokamas planas?

Taip. Dharma planas yra nemokamas amžinai — 1 GB saugyklos, neribotos API užklausos, kredito kortelė nereikalinga.

Ar yra pralaidumo mokesčiai?

Jokiame plane nėra matuojamo pralaidumo mokesčių. Kiekvienas planas apima mėnesinę gateway pralaidumo kvotą, kuri yra griežta riba — jūsų turinio aptarnavimas apex ir dedikuotame gateway sustoja pasiekus kvotą ir atsinaujina kito mėnesio 1 dieną arba po plano atnaujinimo:

Planas	Mėnesinis pralaidumas
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Gausite įspėjamuosius el. laiškus pasiekus 80 % ir 100 % savo kvotos.

Ar saugykla atsinaujina?

Saugykla neatsinaujina. Jūsų planas apima bendrą saugyklos kvotą (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Norint atlaisvinti vietą, ištrinkite failus, kurių jums nebereikia. Plano atnaujinimas padidina jūsų bendrą kvotą.

Ar galiu atšaukti bet kada?

Taip. Atšaukite prenumeratą per atsiskaitymo portalą — jokio įsipareigojimo. Jūsų paskyra grįš į nemokamą lygį, o esami prisegti failai liks pasiekiami.

Kas nutinka su mano failais, jei sumažinu planą?

Jūsų failai lieka prisegti prie IPFS, bet negalite įkelti daugiau, jei jūsų dabartinis naudojimas viršija naujo plano saugyklos ribą. Ištrinkite failus, kad grįžtumėte žemiau ribos.

Saugumas

Ar mano duomenys šifruojami?

Visi duomenys šifruojami perdavimo metu per TLS/HTTPS. Autentifikacija naudoja JWT tokenus (Cognito) ir saugiai saugomus API raktus. Failo turinys IPFS nėra šifruojamas ramybės būsenoje — IPFS yra viešas tinklas pagal dizainą.

Ar saugu naudoti API raktus mano serverio kode?

Taip. API raktai skirti serverio pusės naudojimui. Niekada neatskleiskite jų kliento pusės kode. Kliento pusės failų prieigai naudokite gateway tokenus (gwt_), kurie yra tik skaitymui.

Pagalba

Kaip gauti pagalbą?

Siųskite el. laišką adresu info@ipfs.ninja arba žiūrėkite API nuorodą.

Ar yra SLA?

Siekiame aukšto prieinamumo, bet šiuo metu nesiūlome formalaus SLA. Paslauga teikiama „tokia, kokia yra“ pagrindu.