Soalan Lazim

Soalan lazim tentang IPFS Ninja.

Umum

Apa itu IPFS Ninja?

IPFS Ninja ialah perkhidmatan IPFS pinning terurus. Anda memuat naik sebarang fail melalui REST API yang mudah, atau menyemat CID sedia ada dari rangkaian IPFS. Setiap fail mendapat pengecam kandungan kekal (CID) dan boleh diakses melalui gateway kami di ipfs.ninja/ipfs/<CID>.

Adakah ipfs.ninja/ipfs/<CID> menyajikan mana-mana CID pada rangkaian IPFS?

Tidak. Gateway apex hanya menyajikan CID yang telah dimuat naik atau disematkan oleh pengguna IPFS Ninja. Permintaan untuk CID yang tidak diketahui mengembalikan HTTP 410 Gone dengan penunjuk ke gateway IPFS awam (ipfs.io, dweb.link). Untuk menyajikan CID pihak ketiga melalui gateway kami, lakukan POST /pin ke akaun anda terlebih dahulu — setelah disematkan, CID boleh diakses pada kedua-dua URL apex dan URL gateway khusus anda.

Apakah perbezaan antara gateway apex dan gateway khusus?

Aspek	Apex ipfs.ninja/ipfs/<CID>	Khusus <slug>.gw.ipfs.ninja/ipfs/<CID>
Skop	Dikongsi antara semua pengguna	Hanya CID anda
Pengesahan	Tiada	Token pilihan / IP allowlist / origin allowlist
SLA	Best-effort	SLA penuh
Disyorkan untuk	Pautan biasa	Pembenaman pengeluaran (NFT, video, tapak)
Had kadar	Dikongsi per IP + per CID	Per pelan, boleh dikonfigurasi

Kedua-duanya menyajikan kandungan yang sama. Untuk trafik pengeluaran, gunakan gateway khusus.

Apakah jenis fail yang disokong?

Semua jenis fail disokong. Objek dan tatasusunan JSON boleh dihantar secara langsung. Semua fail lain (imej, PDF, HTML, video, audio, binari) dihantar sebagai kandungan berkod base64.

Adakah terdapat had saiz fail?

Muat naik individu dihadkan oleh peruntukan storan pelan anda. Tiada had saiz per fail selain daripada storan yang tersedia.

Bolehkah saya menyemat kandungan yang sudah wujud di IPFS?

Ya. Gunakan POST /pin dengan mana-mana CID yang sah. Kluster kami akan mendapatkan kandungan dari rangkaian IPFS dan menyematkannya ke akaun anda. Lihat dokumentasi Pinning API untuk butiran.

Berapa lama masa penyematan?

Bergantung pada saiz fail dan berapa banyak nod IPFS yang mempunyai kandungan tersebut. Fail kecil yang teragih dengan baik disemat dalam beberapa saat. Kandungan besar atau jarang disemat mungkin mengambil beberapa minit. Endpoint pin mengembalikan segera dengan status pinning — poll GET /pin/:cid untuk menyemak kemajuan.

Apa yang berlaku jika CID tidak dapat dijumpai?

Status berubah kepada failed. Ini bermakna CID sama ada tidak sah atau kandungan tidak lagi tersedia pada mana-mana nod IPFS yang boleh dicapai.

Adakah data yang dimuat naik ke IPFS bersifat awam?

Ya. Semua kandungan yang disemat ke IPFS boleh diakses secara awam melalui CID-nya melalui mana-mana IPFS gateway. Jika anda memerlukan akses peribadi, gunakan gateway khusus dengan mod memerlukan token — ini mengehadkan akses melalui gateway anda, walaupun kandungan kekal tersedia di rangkaian IPFS yang lebih luas.

Mengapa CID baharu saya bertukar daripada Qm... kepada bafy...?

Muat naik dan sematan baharu mengembalikan CIDv1 moden (bafk… untuk kandungan blok tunggal yang kecil, bafy… untuk fail dan direktori yang lebih besar) mengikut profil IPIP-0499 unixfs-v1-2025: pengekodan base32 CIDv1, cebisan 1 MiB, raw leaves. Ini sepadan dengan apa yang dihasilkan oleh peralatan moden (Helia, Kubo terkini, ipfs-car) untuk kandungan yang sama, jadi fail yang dimuat naik melalui kami mendapat CID yang sama seperti yang dikira oleh mana-mana klien moden untuk bait yang sama.

CID Qm… lama daripada muat naik terdahulu kekal boleh diselesaikan sepenuhnya — gateway, POST /pin, GET /file, IPNS, dan setiap endpoint lain menerima kedua-dua format buat selama-lamanya. Tiada apa yang anda sudah ada berhenti berfungsi.

Bagaimana saya menyemat kandungan yang berada pada nod peribadi / bukan-DHT?

POST /pin menerima multiaddresses[] pilihan (sehingga 5). Jika diberikan, kluster kami melakukan ipfs swarm connect <multiaddr> untuk setiap petunjuk sebelum sematan dijalankan, jadi kandungan pada peer yang tidak mengiklankan diri melalui DHT awam (nod peribadi, persekitaran staging, mesin VPN-tempatan) boleh dicapai. Lihat panduan Semat dari nod IPFS peribadi.

Adakah fail saya akan kekal di IPFS jika saya membatalkan akaun?

Kami menyahsemat fail anda dari nod kami apabila anda membatalkan. Jika nod IPFS lain telah meng-cache kandungan anda, ia mungkin masih boleh diakses. Walau bagaimanapun, tanpa penyematan aktif, fail akan akhirnya dikeluarkan oleh garbage collection di seluruh rangkaian.

Pengesahan & API

Bagaimana saya mengesahkan permintaan API?

Hantar API key anda melalui header X-Api-Key. Jana kunci dari halaman API Keys di papan pemuka anda.

Adakah terdapat had kadar API?

Tidak. IPFS Ninja tidak mengenakan had kadar pada permintaan API. Anda boleh membuat seberapa banyak permintaan yang anda perlukan pada mana-mana pelan.

Adakah API key luput?

Tidak. API key sah sehingga anda memadamkannya. Anda boleh mencipta berbilang kunci dan membatalkannya secara individu.

Apakah perbezaan antara API key dan gateway token?

API key (bws_) mempunyai akses penuh — muat naik, padam, senaraikan fail. Gateway token (gwt_) adalah baca sahaja dan hanya boleh mengakses fail melalui gateway khusus anda. Gateway token selamat untuk disematkan dalam aplikasi frontend.

Gateway Khusus

Apa itu gateway khusus?

Gateway IPFS peribadi di subdomain anda sendiri (cth. abc123.gw.ipfs.ninja) yang hanya menyajikan fail yang disemat ke akaun anda. Tidak seperti gateway awam, ia tidak akan menyelesaikan CID daripada pengguna lain.

Pelan manakah yang termasuk gateway khusus?

Gateway khusus tersedia pada semua pelan berbayar (Bodhi $5/bulan, Karma $19/bulan, Nirvana $59/bulan). Kuota lebar jalur bulanan setiap pelan meliputi trafik daripada kedua-dua gateway apex dan gateway khusus. Lihat "Adakah terdapat bayaran lebar jalur?" di bawah untuk kuota setiap pelan.

Bolehkah saya mengehadkan siapa yang mengakses gateway saya?

Ya. Anda boleh mendayakan mod memerlukan token (memerlukan token gwt_ pada setiap permintaan) dan/atau menetapkan IP whitelist (sehingga 100 alamat).

Bolehkah saya mengehadkan gateway saya mengikut origin/domain?

Ya. Konfigurasikan allowedOrigins dalam tetapan gateway anda dengan senarai origin HTTPS. Hanya permintaan pelayar dari origin tersebut akan dibenarkan. Permintaan bukan pelayar (tanpa header Origin) melepasi tanpa sekatan. Senarai kosong membenarkan semua origin.

Apakah token muat naik bertandatangan?

Token muat naik bertandatangan ialah kelayakan terhad masa untuk muat naik sisi klien. Anda menjananya pada pelayan anda menggunakan POST /upload/signed-url dan menyerahkannya kepada pelayar atau aplikasi mudah alih. Klien mengesahkan dengan Authorization: Signed <token> dan bukannya mendedahkan API key anda. Setiap token menjejak penggunaan dan luput secara automatik. Lihat dokumentasi Signed Tokens untuk butiran.

Bolehkah saya mengoptimumkan imej yang disajikan dari IPFS?

Ya. Gunakan GET /image/:cid dengan parameter kueri seperti w, h, format, dan quality untuk mengubah saiz, menukar dan memampatkan imej secara on-the-fly. Respons di-cache berdasarkan CID beralamat kandungan. Ini berfungsi pada semua pelan. Lihat Pengoptimuman Imej.

Bolehkah saya melampirkan metadata pada fail?

Ya. Sertakan objek metadata dengan sehingga 10 pasangan kunci-nilai semasa memuat naik melalui POST /upload/new atau menyemat melalui POST /pin. Metadata dikembalikan dalam senarai fail dan endpoint perincian fail. Lihat dokumentasi Fail dan Penyematan.

Bil & Pelan

Adakah terdapat pelan percuma?

Ya. Pelan Dharma adalah percuma selamanya — 1 GB storan, permintaan API tanpa had, tiada kad kredit diperlukan.

Adakah terdapat bayaran lebar jalur?

Tiada bayaran lebar jalur bermeter pada mana-mana pelan. Setiap pelan termasuk kuota lebar jalur gateway bulanan yang merupakan had keras — kandungan anda berhenti disajikan pada gateway apex dan gateway khusus sebaik sahaja kuota dicapai, dan menyambung semula pada 1hb bulan berikutnya atau selepas naik taraf:

Pelan	Lebar jalur bulanan
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Anda akan menerima e-mel amaran pada 80% dan 100% kuota anda.

Adakah storan direset?

Storan tidak direset. Pelan anda termasuk jumlah peruntukan storan (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Untuk membebaskan ruang, padamkan fail yang tidak lagi anda perlukan. Menaik taraf pelan anda meningkatkan jumlah peruntukan anda.

Bolehkah saya membatalkan pada bila-bila masa?

Ya. Batalkan langganan anda melalui portal pengebilan — tiada ikatan. Akaun anda kembali ke peringkat percuma, dan fail yang disemat sedia ada kekal boleh diakses.

Apa yang berlaku kepada fail saya jika saya menurunkan taraf?

Fail anda kekal disemat ke IPFS, tetapi anda tidak boleh memuat naik lagi jika penggunaan semasa anda melebihi had storan pelan baharu. Padamkan fail untuk kembali di bawah had.

Keselamatan

Adakah data saya disulitkan?

Semua data disulitkan dalam transit melalui TLS/HTTPS. Pengesahan menggunakan JWT token (Cognito) dan API key yang disimpan dengan selamat. Kandungan fail di IPFS tidak disulitkan pada rehat — IPFS ialah rangkaian awam secara reka bentuk.

Adakah selamat menggunakan API key dalam kod sisi pelayan saya?

Ya. API key direka untuk kegunaan sisi pelayan. Jangan sekali-kali mendedahkannya dalam kod sisi klien. Untuk akses fail sisi klien, gunakan gateway token (gwt_) yang baca sahaja.

Sokongan

Bagaimana saya mendapatkan bantuan?

E-mel info@ipfs.ninja atau semak dokumentasi Rujukan API.

Adakah terdapat SLA?

Kami berusaha untuk ketersediaan tinggi tetapi tidak menawarkan SLA rasmi pada masa ini. Perkhidmatan ini disediakan atas dasar "seadanya".