内容标识符 (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 等）
自描述	否	是（包含编解码器 + 哈希信息）