IPFS Ninja

Muat naik imej, PDF dan fail JSON ke IPFS dengan mudah dan dapatkan pengecam kandungan kekal (CID) dengan akses gateway serta-merta.

Apa itu IPFS?

InterPlanetary File System (IPFS) ialah protokol penyimpanan terdesentralisasi, peer-to-peer. IPFS memecahkan fail kepada bahagian yang lebih kecil, mengedarkannya merentasi rangkaian, dan memberikan pengecam kandungan (CID) unik kepada setiap fail berdasarkan kandungannya.

Ini bermakna:

• Penyimpanan teragih — fail anda disimpan merentasi pelbagai nod untuk kebolehpercayaan yang lebih baik.
• Pengalamatan kandungan — CID diperoleh daripada kandungan fail itu sendiri, memastikan ketidakbolehubahan.
• Kebolehcapaian seluruh rangkaian — sesiapa yang mempunyai CID boleh mendapatkan fail dari mana-mana nod IPFS.

Apa yang IPFS Ninja lakukan

IPFS Ninja ialah perkhidmatan terurus yang membolehkan anda memuat naik fail dan menyemat kandungan sedia ada di IPFS melalui REST API yang mudah. Tidak perlu menjalankan nod IPFS anda sendiri.

• Muat naik fail baharu — hantar sebarang fail melalui POST /upload/new dan dapatkan CID kekal
• Semat CID sedia ada — sudah mempunyai kandungan di IPFS? Semat ke kluster kami melalui POST /pin untuk memastikan ia kekal tersedia
• Akses melalui gateway — semua kandungan yang disemat boleh diakses di ipfs.ninja/ipfs/<CID> (gateway apex hanya menyajikan CID dalam akaun anda atau dalam akaun IPFS Ninja lain — lihat Akses gateway di bawah)
• Metadata tersuai — lampirkan pasangan kunci-nilai pada muat naik dan sematan untuk organisasi dan penapisan
• Token muat naik bertandatangan — jana token terhad masa untuk muat naik sisi klien tanpa mendedahkan API key anda
• IPNS nama boleh ubah — cipta nama stabil yang menunjuk ke CID yang berubah melalui IPNS API, dengan sehingga 10 nama setiap akaun
• Pengoptimuman imej — ubah saiz, tukar dan mampatkan imej secara on-the-fly melalui parameter URL gateway

Papan Pemuka

Jejak muat naik, penyimpanan dan lebar jalur gateway dari papan pemuka peribadi anda. Papan pemuka juga membolehkan anda memacu sebahagian besar API tanpa menulis kod:

• Muat naik drag-and-drop — fail, folder (dibungkus menjadi direktori UnixFS dalam pelayar anda), atau arkib .car
• Namakan semula fail selepas dimuat naik; penerangan diisi automatik daripada nama fail semasa dipilih
• Snapshot folder untuk mendapatkan satu CID direktori bagi segalanya di dalamnya
• Konfigurasikan S3 CORS setiap bucket melalui editor berasaskan borang (untuk integrasi SDK pelayar)
• Urus API key, gateway token, nama IPNS, dan tetapan gateway khusus

Akses Gateway

Setiap fail yang dimuat naik boleh diakses melalui IPFS Ninja gateway, yang bertindak sebagai jambatan antara rangkaian IPFS terdesentralisasi dan pelayar web tradisional.

URL gateway mengikut corak ini:

https://ipfs.ninja/ipfs/<CID>

Skop gateway apex

Gateway apex di https://ipfs.ninja/ipfs/<CID> hanya menyajikan CID yang telah dimuat naik atau disematkan oleh pengguna IPFS Ninja berdaftar. Permintaan untuk CID lain mengembalikan HTTP 410 Gone dengan penunjuk ke gateway IPFS awam seperti ipfs.io atau dweb.link. Untuk menyajikan CID pihak ketiga melalui gateway kami, daftar percuma dan lakukan POST /pin ke akaun anda terlebih dahulu.

TIP

Fail anda juga boleh diakses dari mana-mana gateway IPFS awam (cth. dweb.link, w3s.link) menggunakan CID yang sama — rangkaian IPFS adalah terdesentralisasi.

Semua pelan berbayar mendapat gateway khusus di subdomain mereka sendiri (<slug>.gw.ipfs.ninja) yang hanya menyajikan fail yang disemat ke akaun mereka — dengan kawalan akses berasaskan token pilihan dan sekatan asal. Gateway khusus adalah URL yang disyorkan untuk pembenaman pengeluaran (video, penonton NFT, tapak web).

Jenis fail yang disokong

Jenis	Format	Input
JSON	Sebarang objek atau tatasusunan JSON yang sah	string / object
Imej	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Dokumen PDF standard	base64
HTML	Dokumen HTML	base64
Lain-lain	Sebarang fail (binary, text, video, dll.)	base64

Semua jenis fail diterima. Jenis fail dikesan secara automatik dan direkodkan untuk rujukan anda.

Keselamatan

Respons gateway termasuk header keselamatan (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) yang menghalang pelayar daripada melaksanakan skrip dalam kandungan yang disajikan.