UKK

Usein kysytyt kysymykset IPFS Ninjasta.

Yleistä

Mikä on IPFS Ninja?

IPFS Ninja on hallittu IPFS-kiinnityspalvelu. Lataat minkä tahansa tiedoston yksinkertaisen REST API:n kautta tai kiinnität olemassa olevia CID:itä IPFS-verkosta. Jokainen tiedosto saa pysyvän sisältötunnisteen (CID) ja on saatavilla gatewaymme kautta osoitteessa ipfs.ninja/ipfs/<CID>.

Palveleeko ipfs.ninja/ipfs/<CID> mitä tahansa IPFS-verkon CID-tunnistetta?

Ei. Apex-gateway palvelee vain CID-tunnisteita, jotka IPFS Ninja -käyttäjä on ladannut tai kiinnittänyt. Tuntemattomille CID-tunnisteille palautetaan HTTP 410 Gone viittauksella julkisiin IPFS-gatewayhin (ipfs.io, dweb.link). Palvellaksesi kolmannen osapuolen CID-tunnistetta gatewaymme kautta, suorita ensin POST /pin tilillesi — kiinnityksen jälkeen CID-tunniste on käytettävissä sekä apex- että dedikoidun gatewaysi URL-osoitteessa.

Mikä on apex-gatewayn ja dedikoidun gatewayn ero?

Näkökulma	Apex ipfs.ninja/ipfs/<CID>	Dedikoitu <slug>.gw.ipfs.ninja/ipfs/<CID>
Kattavuus	Jaettu kaikkien käyttäjien kesken	Vain omat CID-tunnisteesi
Tunnistautuminen	Ei mitään	Valinnainen token / IP-sallittu lista / origin-sallittu lista
SLA	Parhaan yrityksen periaate	Täysi SLA
Suositellaan	Satunnaisiin linkkeihin	Tuotantoupotukseen (NFT, video, sivustot)
Nopeusrajat	Jaettu IP-kohtaisesti + CID-kohtaisesti	Suunnitelmakohtainen, määritettävissä

Molemmat palvelevat samaa sisältöä. Tuotantoliikenteeseen käytä dedikoitua gatewaya.

Mitä tiedostotyyppejä tuetaan?

Kaikkia tiedostotyyppejä tuetaan. JSON-objektit ja taulukot voidaan lähettää suoraan. Kaikki muut tiedostot (kuvat, PDF, HTML, video, ääni, binäärit) lähetetään base64-koodattuna sisältönä.

Onko tiedostokokorajoitusta?

Yksittäisiä latauksia rajoittaa suunnitelmasi tallennuskiintiö. Yksittäiselle tiedostolle ei ole kokorajoitusta käytettävissä olevan tallennustilan lisäksi.

Voinko kiinnittää sisältöä, joka on jo IPFS:ssä?

Kyllä. Käytä POST /pin millä tahansa kelvollisella CID:llä. Klusterimme hakee sisällön IPFS-verkosta ja kiinnittää sen tilillesi. Katso Kiinnitys-API:n dokumentaatio lisätiedoille.

Kuinka kauan kiinnitys kestää?

Se riippuu tiedostokoosta ja siitä, kuinka monella IPFS-solmulla on sisältö. Pienet, hyvin jaellut tiedostot kiinnittyvät sekunneissa. Suuret tai harvoin kiinnitetyt sisällöt voivat viedä muutaman minuutin. Kiinnityspäätepiste palauttaa välittömästi tilalla pinning — kysy GET /pin/:cid tarkistaaksesi edistymisen.

Mitä tapahtuu, jos CID:tä ei löydy?

Tila muuttuu tilaan failed. Tämä tarkoittaa, että CID on joko virheellinen tai sisältö ei ole enää saatavilla millään tavoitettavissa olevalla IPFS-solmulla.

Onko IPFS:ään ladattu data julkista?

Kyllä. Kaikki IPFS:ään kiinnitetty sisältö on julkisesti saatavilla sen CID:n kautta minkä tahansa IPFS-gatewayn kautta. Jos tarvitset yksityistä pääsyä, käytä dedikoitua gatewaya token-vaatimustilassa — tämä rajoittaa pääsyä gatewaysi kautta, vaikka sisältö pysyy saatavilla laajemmassa IPFS-verkossa.

Miksi uudet CID-tunnisteeni muuttuivat muodosta Qm... muotoon bafy...?

Uudet lataukset ja kiinnitykset palauttavat nykyaikaisen CIDv1-tunnisteen (bafk… pienelle yksilohkoiselle sisällölle, bafy… suuremmille tiedostoille ja hakemistoille) IPIP-0499 unixfs-v1-2025 -profiilin mukaisesti: CIDv1 base32-koodaus, 1 MiB:n lohkot, raakalehdet. Tämä vastaa sitä, mitä nykyaikaiset työkalut (Helia, uusin Kubo, ipfs-car) tuottavat samasta sisällöstä, joten meidän kauttamme ladattu tiedosto saa saman CID:n, jonka mikä tahansa nykyaikainen asiakasohjelma laskisi samoista tavuista.

Aiempien latausten vanhat Qm…-CID:t pysyvät täysin ratkaistavissa — gateway, POST /pin, GET /file, IPNS ja jokainen muu päätepiste hyväksyy molempia muotoja toistaiseksi. Mikään, mitä sinulla jo on, ei lakkaa toimimasta.

Miten kiinnitän sisältöä, joka sijaitsee yksityisellä / ei-DHT-solmulla?

POST /pin hyväksyy valinnaisen multiaddresses[]-parametrin (enintään 5). Jos se annetaan, klusterimme suorittaa ipfs swarm connect <multiaddr> -komennon jokaiselle vihjeelle ennen kiinnityksen suorittamista, joten sisältö vertaisilla, jotka eivät mainosta itseään julkisen DHT:n kautta (yksityiset solmut, valmisteluympäristöt, VPN-paikalliset koneet), on tavoitettavissa. Katso Kiinnitys yksityisestä IPFS-solmusta -opas.

Pysyvätkö tiedostoni IPFS:ssä, jos peruutan tilini?

Poistamme tiedostojesi kiinnityksen solmuiltamme, kun peruutat. Jos muut IPFS-solmut ovat välimuistittaneet sisältösi, se voi pysyä saatavilla. Mutta ilman aktiivista kiinnitystä tiedostot poistetaan lopulta roskienkeruussa verkon laajuisesti.

Todennus & API

Miten todennan API-pyynnöt?

Lähetä API-avaimesi X-Api-Key-otsakkeen kautta. Generoi avaimia hallintapaneelisi API-avaimet-sivulta.

Onko API-nopeusrajoituksia?

Ei. IPFS Ninja ei aseta nopeusrajoituksia API-pyynnöille. Voit tehdä niin monta pyyntöä kuin tarvitset millä tahansa suunnitelmalla.

Vanhenevatko API-avaimet?

Eivät. API-avaimet ovat voimassa, kunnes poistat ne. Voit luoda useita avaimia ja peruuttaa ne yksitellen.

Mikä on ero API-avainten ja gateway-tokenien välillä?

API-avaimilla (bws_) on täysi pääsy — lataa, poista, listaa tiedostoja. Gateway-tokenit (gwt_) ovat vain luku -käyttöön ja voivat käyttää tiedostoja vain dedikoidun gatewaysi kautta. Gateway-tokenit ovat turvallisia upotettaviksi frontend-sovelluksiin.

Dedikoidut gatewayt

Mikä on dedikoitu gateway?

Yksityinen IPFS-gateway omalla aliverkkotunnuksellasi (esim. abc123.gw.ipfs.ninja), joka palvelee vain tilillesi kiinnitettyjä tiedostoja. Toisin kuin julkinen gateway, se ei ratkaise muiden käyttäjien CID:itä.

Mitkä suunnitelmat sisältävät dedikoidun gatewayn?

Dedikoidut gatewayt ovat saatavilla kaikissa maksullisissa suunnitelmissa (Bodhi 5 $/kk, Karma 19 $/kk, Nirvana 59 $/kk). Jokaisen suunnitelman kuukausittainen kaistanleveyskiintiö kattaa liikenteen sekä apex- että dedikoidusta gatewaysta. Katso suunnitelmakohtaiset kiintiöt kohdasta "Onko kaistanleveysmaksuja?" alla.

Voinko rajoittaa, kuka pääsee gatewaylleni?

Kyllä. Voit ottaa käyttöön token-vaatimustilan (vaatii gwt_-tokenin jokaiseen pyyntöön) ja/tai asettaa IP-sallittujen listan (enintään 100 osoitetta).

Voinko rajoittaa gatewaytani alkuperän/verkkotunnuksen mukaan?

Kyllä. Määritä allowedOrigins gateway-asetuksissasi HTTPS-alkuperien listalla. Vain selainpyynnöt näistä alkuperistä sallitaan. Muut kuin selainpyynnöt (ilman Origin-otsaketta) pääsevät läpi. Tyhjä lista sallii kaikki alkuperät.

Mitä ovat allekirjoitetut lataustokenit?

Allekirjoitetut lataustokenit ovat aikamääräisiä tunnistetietoja asiakaspuolen latauksiin. Generoit ne palvelimellasi käyttäen POST /upload/signed-url ja välität ne selaimille tai mobiilisovelluksille. Asiakas todentaa Authorization: Signed <token> -otsakkeella API-avaimen paljastamisen sijaan. Jokainen token seuraa käyttöä ja vanhenee automaattisesti. Katso allekirjoitettujen tokenien dokumentaatio lisätiedoille.

Voinko optimoida IPFS:stä palveltuja kuvia?

Kyllä. Käytä GET /image/:cid kyselyparametreilla kuten w, h, format ja quality muuttaaksesi kokoa, muuntaaksesi ja pakataksesi kuvia lennossa. Vastaukset välimuistitetaan sisältöosoitteistetun CID:n perusteella. Tämä toimii kaikilla suunnitelmilla. Katso Kuvan optimointi.

Voinko liittää metatietoja tiedostoihin?

Kyllä. Sisällytä metadata-objekti enintään 10 avain-arvo-parilla ladatessasi POST /upload/new kautta tai kiinnittäessäsi POST /pin kautta. Metatiedot palautetaan tiedostolistauksissa ja tiedoston yksityiskohtien päätepisteessä. Katso Tiedostot ja Kiinnitys -dokumentaatio.

Laskutus & Suunnitelmat

Onko ilmainen suunnitelma?

Kyllä. Dharma-suunnitelma on ilmainen ikuisesti — 1 GB tallennustilaa, rajattomat API-pyynnöt, luottokorttia ei vaadita.

Onko kaistanleveysmaksuja?

Ei mitatuja kaistanleveysmaksuja millään suunnitelmalla. Jokainen suunnitelma sisältää kuukausittaisen gateway-kaistanleveyskiintiön, joka on kova yläraja — sisältösi lakkaa palvelemasta apex- ja dedikoiduissa gatewayissa, kun kiintiö saavutetaan, ja jatkuu seuraavan kuukauden 1. päivänä tai päivityksen jälkeen:

Suunnitelma	Kuukausittainen kaistanleveys
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Saat varoitussähköposteja 80 % ja 100 % kiintiöstäsi kohdalla.

Nollautuuko tallennustila?

Tallennustila ei nollaudu. Suunnitelmasi sisältää kokonaistallennuskiintiön (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Vapauttaaksesi tilaa, poista tiedostoja, joita et enää tarvitse. Suunnitelman päivittäminen kasvattaa kokonaiskiintiötäsi.

Voinko peruuttaa milloin tahansa?

Kyllä. Peruuta tilauksesi laskutusportaalin kautta — ei sidontaa. Tilisi palautuu ilmaiselle tasolle, ja olemassa olevat kiinnitetyt tiedostot pysyvät saatavilla.

Mitä tiedostoilleni tapahtuu, jos alennan suunnitelmaani?

Tiedostosi pysyvät kiinnitettyinä IPFS:ään, mutta et voi ladata lisää, jos nykyinen käyttösi ylittää uuden suunnitelman tallennusrajan. Poista tiedostoja päästäksesi rajan alle.

Turvallisuus

Onko datani salattu?

Kaikki data on salattu siirron aikana TLS/HTTPS:n kautta. Todennus käyttää JWT-tokeneita (Cognito) ja turvallisesti tallennettuja API-avaimia. Tiedostosisältö IPFS:ssä ei ole salattu levossa — IPFS on suunniteltu julkiseksi verkoksi.

Onko turvallista käyttää API-avaimia palvelinkoodissani?

Kyllä. API-avaimet on suunniteltu palvelinpuolen käyttöön. Älä koskaan paljasta niitä asiakaspuolen koodissa. Asiakaspuolen tiedostojen käyttöön käytä gateway-tokeneita (gwt_), jotka ovat vain luku -käyttöön.

Tuki

Miten saan apua?

Lähetä sähköpostia osoitteeseen info@ipfs.ninja tai tarkista API-viite-dokumentaatio.

Onko SLA:ta?

Pyrimme korkeaan saatavuuteen, mutta emme tarjoa tällä hetkellä muodollista SLA:ta. Palvelu tarjotaan "sellaisenaan" -periaatteella.