內容識別碼 (CID)

每個 IPFS 檔案獲得的唯一指紋。

什麼是 CID？

內容識別碼 (CID) 是一個自描述標籤，用於唯一標識 IPFS 上的一段資料。它由檔案內容的加密雜湊結合所使用的雜湊演算法和編碼格式的中繼資料衍生而來。

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

以 Qm 開頭的 CID 使用 CIDv0（base58 編碼的 SHA-256）。較新的 CIDv1 識別碼以 bafy 開頭，支援多種雜湊函數和編碼。

關鍵屬性

• 確定性 — 相同的檔案總是產生相同的 CID。兩次上傳同一張圖片，您會得到相同的識別碼。
• 唯一性 — 即使一個位元組的變更也會產生完全不同的 CID。這使 CID 具有防竄改性。
• 自驗證 — 收到檔案的任何人都可以重新計算雜湊並確認它與請求的 CID 相符。
• 不可變 — CID 始終指向相同的內容。您無法變更 CID 解析到的內容。

IPFS.NINJA 中的 CID

您上傳的每個檔案都會在 API 回應中傳回一個 CID。使用它來：

• 透過閘道存取檔案：ipfs.ninja/ipfs/<CID>
• 擷取檔案中繼資料：GET /file/<CID>
• 在鏈上參照內容（NFT、智慧合約）
• 與任何人分享 — 他們可以驗證內容是否相符

CIDv0 與 CIDv1

屬性	CIDv0	CIDv1
前綴	Qm...	bafy...
雜湊函數	僅 SHA-256	多種（SHA-256、Blake2b 等）
編碼	Base58	Multibase（base32、base58 等）
自描述	否	是（包含編解碼器 + 雜湊資訊）