IPFS Ninja

輕鬆將圖片、PDF 和 JSON 檔案上傳至 IPFS，取得永久內容識別碼 (CID)，並即時透過閘道存取。

什麼是 IPFS？

星際檔案系統 (IPFS) 是一種去中心化的點對點儲存協定。IPFS 將檔案分割成較小的區塊，在網路中分發，並根據檔案內容為每個檔案指派唯一的內容識別碼 (CID)。

這意味著：

• 分散式儲存 — 您的檔案儲存在多個節點上，提升了可靠性。
• 內容定址 — CID 由檔案內容本身衍生，確保不可竄改。
• 全網可存取 — 任何擁有 CID 的人都可以從任何 IPFS 節點擷取該檔案。

IPFS Ninja 的功能

IPFS Ninja 是一項代管服務，讓您透過簡單的 REST API 上傳檔案並固定 IPFS 上的現有內容。無需執行自己的 IPFS 節點。

• 上傳新檔案 — 透過 POST /upload/new 傳送任意檔案，取得永久 CID
• 固定現有 CID — 已有 IPFS 上的內容？透過 POST /pin 將其固定到我們的叢集，確保持續可用
• 透過閘道存取 — 所有固定內容均可透過 ipfs.ninja/ipfs/<CID> 存取
• 自訂中繼資料 — 為上傳和固定的內容附加鍵值對，方便組織和篩選
• 簽章上傳權杖 — 產生限時權杖用於用戶端上傳，無需暴露您的 API 金鑰
• IPNS 可變名稱 — 透過 IPNS API 建立指向變動 CID 的穩定名稱，每個帳戶最多 10 個名稱
• 圖片最佳化 — 透過閘道 URL 參數即時調整大小、轉換和壓縮圖片

儀表板

從您的個人儀表板追蹤上傳、儲存和閘道頻寬使用情況。

閘道存取

每個上傳的檔案都可以透過 IPFS Ninja 閘道存取，該閘道充當去中心化 IPFS 網路與傳統網頁瀏覽器之間的橋樑。

閘道 URL 遵循以下格式：

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

TIP

您的檔案也可以透過任何公共 IPFS 閘道（例如 dweb.link、w3s.link）使用相同的 CID 存取 — IPFS 網路是去中心化的。

Nirvana 方案使用者可取得一個專屬閘道，位於自己的子網域（<slug>.gw.ipfs.ninja），僅提供固定到其帳戶的檔案 — 可選的權杖存取控制和來源限制。

支援的檔案類型

類型	格式	輸入
JSON	任何有效的 JSON 物件或陣列	string / object
圖片	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	標準 PDF 文件	base64
HTML	HTML 文件	base64
任意	任何檔案（二進位、文字、影片等）	base64

所有檔案類型均可接受。類型會被自動偵測並記錄，供您參考。

安全性

閘道回應包含安全標頭（Content-Security-Policy: sandbox、X-Content-Type-Options: nosniff、X-Frame-Options: DENY），防止瀏覽器執行所提供內容中的指令碼。

大小限制

限制	值
每次請求最大酬載	6 MB（API Gateway 限制）
總儲存空間（Dharma）	1 GB
總儲存空間（Bodhi）	10 GB
總儲存空間（Nirvana）	100 GB

使用情境

NFT 中繼資料與資產

使用永久、不可變的 CID 儲存 NFT 中繼資料 JSON 和相關圖片。

靜態資源託管

為 Web 和行動應用程式託管圖片、文件和資料檔案。

可驗證的資料分享

透過內容定址的來源證明分享資料 — 接收者可以驗證資料未被竄改。