BUJ

Bieži uzdotie jautājumi par IPFS Ninja.

Vispārīgi

Kas ir IPFS Ninja?

IPFS Ninja ir pārvaldīts IPFS piespraušanas pakalpojums. Jūs augšupielādējat jebkuru failu caur vienkāršu REST API vai piespraužat esošus CID no IPFS tīkla. Katrs fails saņem pastāvīgu satura identifikatoru (CID) un ir pieejams caur mūsu gateway ipfs.ninja/ipfs/<CID>.

Vai ipfs.ninja/ipfs/<CID> apkalpo jebkuru CID IPFS tīklā?

Nē. Apex gateway apkalpo tikai CID, kurus ir augšupielādējis vai piesprauda IPFS Ninja lietotājs. Pieprasījumi nezināmiem CID atgriež HTTP 410 Gone ar norādi uz publiskām IPFS vārtejām (ipfs.io, dweb.link). Lai apkalpotu trešās puses CID caur mūsu gateway, vispirms izpildiet POST /pin uz sava konta — kad piesprausts, CID kļūst pieejams gan apex, gan jūsu veltītā gateway URL.

Kāda ir atšķirība starp apex gateway un veltīto gateway?

Aspekts	Apex ipfs.ninja/ipfs/<CID>	Veltīts <slug>.gw.ipfs.ninja/ipfs/<CID>
Joma	Koplietota starp visiem lietotājiem	Tikai jūsu CID
Autentifikācija	Nav	Izvēles tokens / IP saraksts / izcelsmes saraksts
SLA	Best-effort	Pilns SLA
Ieteicams	Gadījuma saitēm	Produkcijas iegulšanai (NFT, video, tīmekļa vietnes)
Ātruma ierobežojumi	Koplietots pēc IP + pēc CID	Pēc plāna, konfigurējams

Abi apkalpo identisku saturu. Produkcijas trafikam izmantojiet veltīto gateway.

Kādi failu tipi tiek atbalstīti?

Visi failu tipi tiek atbalstīti. JSON objektus un masīvus var nosūtīt tieši. Visi citi faili (attēli, PDF, HTML, video, audio, binārie) tiek nosūtīti kā base64 kodēts saturs.

Vai ir faila izmēra ierobežojums?

Individuālās augšupielādes ierobežo jūsu plāna glabāšanas kvota. Nav atsevišķa faila izmēra ierobežojuma papildus jūsu pieejamajai glabātuvei.

Vai es varu piespraust saturu, kas jau pastāv IPFS?

Jā. Izmantojiet POST /pin ar jebkuru derīgu CID. Mūsu klasteris iegūst saturu no IPFS tīkla un piespauž to jūsu kontam. Skatiet Piespraušanas API dokumentāciju detaļām.

Cik ilgi aizņem piespraušana?

Tas ir atkarīgs no faila izmēra un tā, cik daudziem IPFS mezgliem ir saturs. Mazi, labi izplatīti faili tiek piesprausti sekundēs. Liels vai reti piesprausts saturs var aizņemt dažas minūtes. Piespraušanas galapunkts atgriežas nekavējoties ar statusu pinning — aptaujājiet GET /pin/:cid, lai pārbaudītu progresu.

Kas notiek, ja CID nevar atrast?

Statuss mainās uz failed. Tas nozīmē, ka CID ir nederīgs vai saturs vairs nav pieejams nevienā sasniedzamā IPFS mezglā.

Vai uz IPFS augšupielādētie dati ir publiski?

Jā. Viss IPFS piespraustais saturs ir publiski pieejams caur tā CID jebkurā IPFS gateway. Ja jums nepieciešama privāta piekļuve, izmantojiet veltītu gateway ar tokenu nepieciešamības režīmu — tas ierobežo piekļuvi caur jūsu gateway, lai gan saturs paliek pieejams plašākā IPFS tīklā.

Kāpēc mani jaunie CID mainījās no Qm... uz bafy...?

Jaunas augšupielādes un piespraušanas atgriež modernu CIDv1 (bafk… maza, viena bloka satura, bafy… lielākiem failiem un direktorijām) saskaņā ar IPIP-0499 unixfs-v1-2025 profilu: CIDv1 base32 kodējums, 1 MiB gabali, raw leaves. Tas atbilst tam, ko rada mūsdienīgi rīki (Helia, jaunākais Kubo, ipfs-car) tam pašam saturam, tāpēc caur mums augšupielādēts fails iegūst to pašu CID, ko jebkurš mūsdienīgs klients aprēķinātu tiem pašiem baitiem.

Vecmodīgie Qm… CID no iepriekšējām augšupielādēm joprojām pilnībā atrisinās — gateway, POST /pin, GET /file, IPNS un katrs cits galapunkts pieņem abus formātus bezgalīgi. Nekas, kas jums jau ir, nepārstāj darboties.

Kā piespraust saturu, kas atrodas uz privāta / ne-DHT mezgla?

POST /pin pieņem neobligātu multiaddresses[] (līdz 5). Ja norādīts, mūsu klasteris izpilda ipfs swarm connect <multiaddr> katrai norādei pirms piespraušanas sākuma, tāpēc saturs uz mezgliem, kas nereklamējas caur publisko DHT (privāti mezgli, staging vides, VPN lokālas mašīnas), ir sasniedzams. Skatiet rokasgrāmatu Piespraušana no privāta IPFS mezgla.

Vai mani faili paliks IPFS, ja es atcelšu savu kontu?

Mēs atceļam jūsu failu piespraušanu no mūsu mezgliem, kad jūs atceļat. Ja citi IPFS mezgli ir kešojuši jūsu saturu, tas var palikt pieejams. Tomēr bez aktīvas piespraušanas faili galu galā tiks noņemti ar atkritumu savākšanu visā tīklā.

Autentifikācija & API

Kā autentificēt API pieprasījumus?

Nosūtiet savu API atslēgu caur X-Api-Key galveni. Ģenerējiet atslēgas no API atslēgu lapas savā informācijas panelī.

Vai ir API ātruma ierobežojumi?

Nē. IPFS Ninja neuzliek ātruma ierobežojumus API pieprasījumiem. Jūs varat veikt tik daudz pieprasījumu, cik nepieciešams, jebkurā plānā.

Vai API atslēgas beidzas?

Nē. API atslēgas ir derīgas, līdz tās izdzēšat. Varat izveidot vairākas atslēgas un atsaukt tās atsevišķi.

Kāda ir atšķirība starp API atslēgām un gateway tokeniem?

API atslēgām (bws_) ir pilna piekļuve — augšupielādēt, dzēst, uzskaitīt failus. Gateway tokeni (gwt_) ir tikai lasīšanai un var piekļūt failiem tikai caur jūsu veltīto gateway. Gateway tokenus ir droši iekļaut frontend lietotnēs.

Veltīti gateway

Kas ir veltīts gateway?

Privāts IPFS gateway jūsu apakšdomēnā (piemēram, abc123.gw.ipfs.ninja), kas apkalpo tikai jūsu kontam piespraustos failus. Atšķirībā no publiskā gateway, tas neatrisinās CID no citiem lietotājiem.

Kuri plāni ietver veltītu gateway?

Veltīti gateway ir pieejami visos maksas plānos (Bodhi 5 $/mēn, Karma 19 $/mēn, Nirvana 59 $/mēn). Katra plāna mēneša joslas platuma kvota sedz trafiku gan no apex, gan veltītā gateway. Skatiet "Vai ir joslas platuma maksas?" zemāk katra plāna kvotām.

Vai es varu ierobežot, kas piekļūst manam gateway?

Jā. Varat iespējot tokenu nepieciešamības režīmu (nepieciešams gwt_ tokens katrā pieprasījumā) un/vai iestatīt IP balto sarakstu (līdz 100 adresēm).

Vai es varu ierobežot savu gateway pēc izcelsmes/domēna?

Jā. Konfigurējiet allowedOrigins savos gateway iestatījumos ar HTTPS izcelsmju sarakstu. Tiek atļauti tikai pārlūkprogrammas pieprasījumi no šīm izcelsmēm. Pieprasījumi bez pārlūkprogrammas (bez Origin galvenes) tiek izlaisti. Tukšs saraksts atļauj visas izcelsmes.

Kas ir parakstīti augšupielādes tokeni?

Parakstīti augšupielādes tokeni ir laika ierobežoti akreditācijas dati klienta puses augšupielādēm. Jūs tos ģenerējat savā serverī, izmantojot POST /upload/signed-url, un nododat tos pārlūkprogrammām vai mobilajām lietotnēm. Klients autentificējas ar Authorization: Signed <token>, nevis atklājot jūsu API atslēgu. Katrs tokens izseko lietošanu un beidzas automātiski. Skatiet parakstīto tokenu dokumentāciju detaļām.

Vai es varu optimizēt attēlus, kas tiek apkalpoti no IPFS?

Jā. Izmantojiet GET /image/:cid ar vaicājuma parametriem kā w, h, format un quality, lai mainītu izmēru, konvertētu un saspiestu attēlus lidojumā. Atbildes tiek kešotas, pamatojoties uz satura adresēto CID. Tas darbojas visos plānos. Skatiet Attēlu optimizācija.

Vai es varu pievienot metadatus failiem?

Jā. Iekļaujiet metadata objektu ar līdz 10 atslēgu-vērtību pāriem, augšupielādējot caur POST /upload/new vai piespraužot caur POST /pin. Metadati tiek atgriezti failu sarakstos un faila detaļu galapunktā. Skatiet Faili un Piespraušana dokumentāciju.

Norēķini & Plāni

Vai ir bezmaksas plāns?

Jā. Dharma plāns ir bezmaksas mūžīgi — 1 GB glabātuves, neierobežoti API pieprasījumi, kredītkarte nav nepieciešama.

Vai ir joslas platuma maksas?

Nav mērītu joslas platuma maksu nevienā plānā. Katrs plāns ietver mēneša gateway joslas platuma kvotu, kas ir stingrs limits — jūsu saturs pārstāj tikt apkalpots apex un veltītajos gateway, tiklīdz kvota ir sasniegta, un atsākas nākamā mēneša 1. datumā vai pēc jaunināšanas:

Plāns	Mēneša joslas platums
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Jūs saņemsiet brīdinājuma e-pastus pie 80% un 100% no jūsu kvotas.

Vai glabātuve atiestatās?

Glabātuve neatiestatās. Jūsu plāns ietver kopējo glabātuves kvotu (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Lai atbrīvotu vietu, dzēsiet failus, kas jums vairs nav nepieciešami. Plāna jaunināšana palielina jūsu kopējo kvotu.

Vai es varu atcelt jebkurā laikā?

Jā. Atceliet savu abonementu caur norēķinu portālu — bez saistībām. Jūsu konts atgriezīsies bezmaksas līmenī, un esošie piespraustie faili paliks pieejami.

Kas notiek ar maniem failiem, ja es pazeminu plānu?

Jūsu faili paliek piesprausti IPFS, bet jūs nevarat augšupielādēt vairāk, ja jūsu pašreizējā izmantošana pārsniedz jaunā plāna glabātuves limitu. Dzēsiet failus, lai atgrieztos zem limita.

Drošība

Vai mani dati ir šifrēti?

Visi dati ir šifrēti pārvadē caur TLS/HTTPS. Autentifikācija izmanto JWT tokenus (Cognito) un droši glabātas API atslēgas. Failu saturs IPFS nav šifrēts miera stāvoklī — IPFS ir publisks tīkls pēc dizaina.

Vai ir droši izmantot API atslēgas manā servera kodā?

Jā. API atslēgas ir paredzētas servera puses lietošanai. Nekad neatklājiet tās klienta puses kodā. Klienta puses failu piekļuvei izmantojiet gateway tokenus (gwt_), kas ir tikai lasīšanai.

Atbalsts

Kā es varu saņemt palīdzību?

Sūtiet e-pastu uz info@ipfs.ninja vai skatiet API atsauci.

Vai ir SLA?

Mēs cenšamies nodrošināt augstu pieejamību, bet pašlaik nepiedāvājam formālu SLA. Pakalpojums tiek sniegts "kāds ir" pamatā.