IPFS CID（内容标识符）

什么是 IPFS CID？

IPFS CID（Content Identifier，内容标识符）是一种基于内容的唯一标签，用于标识通过 IPFS 存储或引用的文件、文件夹、数据块、元数据和其他数据。在加密货币和 Web3 领域，IPFS CID 常用于指向链下数据，例如 NFT 图片、NFT 元数据、去中心化应用文件、公开项目文档和代币相关媒体内容。

IPFS 官方文档说明，CID 并不描述内容存储在哪里，而是通过IPFS 内容寻址根据内容本身生成地址。

因此，IPFS CID 与普通网站 URL 不同：普通 URL 通常指向某个位置，而 CID 指向实际内容。如果使用相同设置将同一文件添加到 IPFS，生成的 CID 应相同。如果内容发生变化，即使只是轻微变化，CID 也应随之改变。这种设计对加密领域非常有用，因为用户通常需要验证智能合约、NFT 或去中心化应用是否引用了预期数据。IPFS CID 不是代币、钱包地址、智能合约地址或区块链交易哈希。它是一种可与区块链配合使用的内容标识符，但属于 IPFS 和内容寻址生态系统。

IPFS CID 对加密领域的重要性

IPFS CID 很重要，因为区块链并不是为高效存储大型文件而设计的。将每张图片、视频、网站文件或元数据记录都直接存储在链上，可能成本高、速度慢且技术效率低。许多加密项目会将大型数据存储在链下，并将 CID 或 IPFS URI 存储为引用，以此解决这一问题。例如，NFT 智能合约可能会存储或返回一个包含 IPFS CID 的代币 URI，指向 NFT 元数据。元数据随后可能指向另一个 CID，该 CID 包含实际图片、动画、音频文件或其他媒体资产。这种结构让区块链只需保留简洁的引用，而由 IPFS 负责检索内容。由此，区块链验证与去中心化文件分发得以兼顾。对于用户来说，CID 让他们更容易检查 NFT 或 dApp 是否仍指向最初发布的相同内容。对于开发者来说，CID 便于为静态文件创建可验证的引用，而不必只依赖中心化服务器路径。对于社区来说，CID 有助于以内容寻址的形式保存公开记录、治理文件、教育资源和项目公告。

IPFS CID 的工作原理

IPFS CID 通过使用加密哈希和自描述数据格式，为内容生成唯一标识符。将数据添加到 IPFS 时，系统会将数据处理为多个数据块，并根据这些数据块的内容生成标识符。加密哈希就像根据数据生成的数字指纹。数据发生变化，指纹也会随之变化。因此，CID 有助于发现 NFT 元数据、项目文件和去中心化网站资产是否发生变化。

CID 规范将 CID 描述为一种自描述的内容寻址标识符，使用 multihash、multicodec，有时也使用 multibase。

这些组成部分帮助软件理解 CID 所代表的内容、内容采用的哈希方式，以及标识符以文本形式编码的方式。简单来说，CID 会告知 IPFS 客户端要查找什么内容，以及如何验证检索到的内容是否与请求相符。这也是 IPFS 常被应用于重视公开验证的加密系统的原因之一。

IPFS CID 与传统 URL 的区别

传统 URL 通常会告诉浏览器去哪里查找数据。例如，普通网页链接可能指向域名、服务器路径和文件名。如果服务器替换了文件却保留原 URL，用户可能会在同一链接下看到不同内容。IPFS CID 的工作方式不同，它根据内容本身来标识内容。内容发生变化，CID 就会改变。这为用户提供了更可靠的方式来验证自己看到的是预期数据。在加密领域，这一区别很重要，因为投资者、收藏者、开发者和社区经常需要对确切文件进行稳定引用。普通 URL 采用位置寻址，而 IPFS CID 采用内容寻址。位置寻址关注文件在哪里。内容寻址关注文件是什么。这种转变是 IPFS 与 Web3 基础设施紧密相关的主要原因之一。

IPFS CID 的结构

IPFS CID 可以包含多个技术组成部分，使其具备自描述能力。主要部分通常包括版本、内容编解码器和 multihash。CID 版本会告诉软件使用的是哪种 CID 格式。内容编解码器会告诉软件所标识的数据结构类型。multihash 会告诉软件使用了哪种哈希函数，并包含哈希摘要。CID 以文本形式表示时，也可能使用 multibase，以便软件识别文本形式的编码方式。

Multiformats 项目提供了相应基础组件，帮助 CID 在不同格式和未来升级中保持灵活性。

这种灵活结构很重要，因为去中心化网络可能运行多年，并且随着时间推移可能需要支持新的哈希函数、编码和数据格式。如果没有自描述标识符，随着标准变化，旧链接可能会变得难以解析。借助 CID，标识符本身携带有用信息，帮助软件正确处理被引用的内容。

CIDv0 与 CIDv1

加密货币用户可能会遇到两种常见的 CID 版本，分别是 CIDv0 和 CIDv1。CIDv0 是较早的格式，通常以字母 Qm 开头，容易辨认。CIDv0 的格式有限，通常使用 base58btc 编码、DAG-PB 数据和 sha2-256 哈希函数。CIDv1 是较新的版本，灵活性更高。CIDv1 支持更多编解码器和文本编码，因此更适合现代 IPFS 使用场景。

IPFS 文档在CID 标识符格式指南中介绍了 CID 版本和格式转换行为。

许多 NFT 和 Web3 用户仍会在实际应用中同时遇到 CIDv0 和 CIDv1。项目可能会使用 CIDv0，因为它广为人知且容易识别。项目也可能会使用 CIDv1，因为它更适用于现代网关模式和更广泛的编码需求。用户不应仅仅因为 CID 的外观不同，就认定其中一个是伪造的。格式可能不同，是因为 CID 版本或编码方式不同。

IPFS CID 与 NFT 元数据

IPFS CID 在 NFT 元数据系统中十分常见。NFT 通常由智能合约控制，但实际图片、动画或元数据往往存储在区块链之外。智能合约可能会返回一个以 ipfs:// 开头、后接 CID 的 URI。该 CID 可能指向一个 JSON 元数据文件，其中包含 NFT 名称、描述、图片引用、属性及其他信息。元数据中的图片字段也可能包含另一个 IPFS CID。这种设置让 NFT 能够以可通过 CID 验证的方式引用内容。如果元数据文件发生变化，其 CID 应随之改变。如果图片文件发生变化，其 CID 也应随之改变。这有助于收藏者发现项目是否在铸造后更改了重要 NFT 内容。不过，用户仍应检查智能合约处理元数据更新的方式，因为某些合约允许授权账户更改代币 URI 或基础 URI。

IPFS CID 与去中心化应用

去中心化应用可以使用 IPFS CID 引用前端文件、公开配置数据、文档和静态网站。dApp 前端可以由一组静态文件组成，并添加到 IPFS。生成的 CID 可以标识该界面的确切版本。这样，用户便可以加载特定版本的前端，而不必相信普通 Web 服务器没有更改文件。开发者还可以在发布说明中附上 dApp 界面的官方 CID。社区成员可以将已发布的 CID 与自己使用的文件进行比对。这并不能消除所有安全风险，但能为用户提供更可靠的验证工具。对于加密项目来说，CID 可以提高透明度，因为内容引用与已发布的数据本身关联。

IPFS CID 与智能合约

智能合约可以直接存储 IPFS CID，也可以存储包含 IPFS URI 的字符串。智能合约存储成本可能很高，因此项目通常只存储 CID 或简短引用，而不是将完整文件存储在链上。这使 CID 成为连接链上逻辑和链下内容的桥梁。区块链可以存储引用，而 IPFS 则可以帮助分发被引用的内容。例如，合约可以存储治理提案详情、代币元数据文件、公开档案或去中心化网站构建版本的 CID。用户可以检索 CID，并验证返回的内容是否与标识符相符。这种模式不同于完全链上存储，因为相关内容仍需由 IPFS 节点或固定服务提供。不过，这种设计很常见，因为它可以降低成本，同时保留可验证的内容引用。

IPFS URI 格式

加密货币用户经常会在 IPFS URI 格式中看到 CID。一种常见格式是 ipfs://CID。另一种常见格式是 ipfs://CID/path/to/file。第一种格式指向由 CID 标识的根内容。第二种格式指向由该 CID 表示的目录中的某个文件或对象。一些网站和钱包会将 IPFS URI 转换为网关 URL，以便用户在普通网页浏览器中打开。

IPFS 官方文档在IPFS 网关指南中介绍了网关的工作方式。

网关 URL 可能与 ipfs:// URI 外观不同，但底层仍可能使用相同的 CID。验证内容时，用户应关注 CID 本身，而不应只信任网关域名。网关是访问内容的途径，而 CID 是内容标识符。

IPFS CID 与网关

IPFS 网关帮助普通网页浏览器检索 IPFS 内容。这很有用，因为许多浏览器默认无法直接加载 ipfs:// 链接。用户打开网关链接时，网关会请求 IPFS 内容，并通过 HTTP 或 HTTPS 提供内容。这让访问 IPFS 内容更加方便，但也可能造成误解。有些用户可能会因为浏览器地址栏中显示了网关域名，就认为网关拥有或控制相关内容。实际上，网关只是访问 CID 所标识内容的一种途径。如果某个网关不可用，只要内容仍可获取，其他网关或本地 IPFS 节点仍可能检索到相同 CID。对于加密货币用户来说，这意味着网关链接失效并不一定说明 CID 无效。也可能是网关不可用、遭到屏蔽、负载过高，或暂时找不到内容提供者。

IPFS CID 与固定内容

CID 可以标识内容，但不保证内容会永久可用。内容是否可用，取决于至少一个节点是否仍持有并提供该内容。固定内容是指告知 IPFS 节点保留特定内容。

IPFS 官方文档在其IPFS 固定内容指南中说明，固定内容会让 IPFS 在本地保留数据。

对于使用 IPFS CID 的加密项目来说，这是一个关键要点。NFT 图片可能拥有有效 CID，但如果没有节点托管内容，仍可能无法加载。dApp 界面可能拥有正确的 CID，但如果没有可靠固定，仍可能难以访问。公开文档可能拥有可信的 CID，但仍可能需要多个固定节点，才能保持易于检索。对于重要的加密资产，用户通常会结合使用本地固定、远程固定、备份和监控。

IPFS CID 的不可变性

人们经常说 IPFS CID 是不可变的，但应谨慎理解这一说法。CID 指向某个特定版本的内容，因此内容一旦更改，就会生成不同的 CID。因此，CID 本身是指向该确切内容的稳定引用。不过，这并不意味着项目永远无法更改网站、智能合约或元数据系统所指向的内容。如果智能合约所有者可以更新代币 URI，项目之后就可能把用户引向新的 CID。如果网站更改网关 URL 或设置重定向，用户看到的 CID 也可能不同。如果命名系统解析到新的 CID，名称可能保持不变，但底层内容已发生变化。因此，CID 最好理解为对其所标识内容不可变，而不是保证所有引用它的系统始终指向同一个 CID。

验证 IPFS CID

可验证性是 IPFS CID 最重要的优势之一。软件按 CID 检索内容时，可以检查内容是否与预期哈希相符。如果内容不匹配，就不应将其视为请求的内容。这有助于保护用户，避免文件在不知情的情况下被更改，并防范某些服务器端篡改。对于 NFT 收藏者来说，CID 验证有助于确认元数据文件或图片是否与已发布的引用相符。对于开发者来说，CID 验证有助于确认 dApp 构建版本是否与已知版本一致。对于社区来说，CID 验证有助于确认公开文件是否与已批准或公告的文件相同。这并不意味着所有 CID 都安全或可信。CID 既可以标识恶意内容，也可以标识合法内容。验证只能证明内容与标识符相符，不能证明内容无害或来自官方。

如何识别 IPFS CID

大多数用户不需要手动解码 CID 的每个部分。不过，了解不同的 CID 字符串外观可能差异很大，会有所帮助。以 Qm 开头的 CID 通常是 CIDv0。以 b 开头的 CID 通常是采用 base32 编码的 CIDv1。使用不同 multibase 编码时，也可能出现其他首字符。CID 较长并不代表一定更好，较短也不代表安全性一定较低。CID 的长度和外观取决于版本、编码方式、哈希函数和数据格式。用户应仔细复制 CID，因为一个字符出错就可能指向无效或不同的内容。对于重要的加密操作，用户应从项目官方来源复制 CID，并在与文件或元数据交互前进行核对。

IPFS CID 与区块链交易哈希

IPFS CID 和区块链交易哈希可能看起来相似，因为它们都可能是由字母和数字组成的长字符串。但两者并不相同。区块链交易哈希用于标识记录在区块链上的一笔交易。IPFS CID 用于标识通过 IPFS 寻址的内容。交易哈希可以帮助用户查找交易详情，例如发送方、接收方、智能合约交互、区块编号和状态。CID 可以帮助用户检索和验证文件、文件夹、元数据对象或其他内容。加密货币用户不应把 CID 粘贴到区块浏览器，并期待它像交易哈希一样发挥作用。用户应使用 IPFS 工具、网关、本地节点，或兼容的钱包和应用来访问 CID 内容。

IPFS CID 与钱包地址

IPFS CID 也不同于钱包地址。钱包地址表示区块链网络上的接收目的地或类似账户的标识符。CID 表示内容寻址系统中的内容。向 CID 发送加密资产，与向钱包地址发送资产不是一回事。除非某个特定协议创建了特殊映射，否则 CID 无法接收普通加密货币转账，用户不应想当然地认为它可以。这一差异很重要，因为新手可能会混淆较长的加密相关字符串。在将任何字符串复制并粘贴到钱包、dApp 或交易字段前，用户应确认它究竟是 CID、钱包地址、交易哈希、合约地址还是 URI。

IPFS CID 在加密领域的常见用途

一个常见用途是存储 NFT 元数据。另一个常见用途是存储 NFT 媒体内容。第三个用途是托管去中心化应用前端。第四个用途是为加密社区存储公开档案。第五个用途是存储治理提案文档。第六个用途是分发代币列表或资产信息。第七个用途是以内容寻址方式发布开源项目文件。第八个用途是为研究、审计、教育内容和公开公告创建可验证的引用。这些用途说明，CID 是学习 Web3 基础设施时必须了解的基本概念。

IPFS CID 的优势

IPFS CID 的第一项优势是可验证性。用户可以通过 CID 检查检索到的内容是否与预期内容相符。第二项优势是支持去中心化。不同 IPFS 节点都可以提供同一个 CID 所指向的内容，而不必只依赖单一服务器位置。第三项优势是数据完整性更好。由于 CID 根据内容生成，意外的内容变化应会产生不同的标识符。第四项优势是降低区块链存储成本。项目可以将简短引用存储在链上，同时将大型文件保留在链下。第五项优势是可移植性。同一个 CID 可用于支持 IPFS 的钱包、市场、网关、本地节点、dApp 和开发者工具。第六项优势是透明度。项目可以发布官方 CID，让用户独立检查重要文件。

IPFS CID 的局限与风险

IPFS CID 不保证内容永久存储。内容仍需由节点托管或固定。IPFS CID 不保证隐私。如果有人拥有 CID 且内容可用，其他人也可能检索到该内容。IPFS CID 不保证内容安全。CID 可能指向恶意软件、网络钓鱼文件、虚假元数据或误导性文档。IPFS CID 无法证明项目真实可信。用户仍需验证发布 CID 的来源。如果智能合约的设计允许更新，IPFS CID 无法阻止合约所有者更改元数据引用。IPFS CID 不能替代谨慎的钱包安全措施、交易审核或项目调研。

加密货币用户的最佳实践

始终从项目官方渠道、经过验证的文档或可信应用界面复制 CID。核查重要 NFT 元数据、dApp 发布版本或治理文件时，应比对完整 CID。如果内容无法从某个来源加载，可尝试其他网关或本地 IPFS 节点。请记住，网关出问题不一定意味着 CID 有问题。如果需要长期保存重要文件，请将其固定。将敏感文件添加到 IPFS 前应先加密，因为 CID 不应被当作私密密码。在 IPFS 之外备份重要文件。发布加密项目文件时，应清楚记录官方 CID。持续监控重要 CID，确认内容仍可检索。除非信任来源并了解相关风险，否则不要打开来自随机 CID 的未知文件。

加密货币开发者的最佳实践

使用稳定的构建流程，确保相同内容生成可预测的 CID。如果项目承诺元数据不可变，应在公开宣传前冻结 NFT 元数据。明确说明铸造后元数据是否可以更新。在便于用户验证的位置发布官方 CID。为兼容现代使用场景，可考虑采用 CIDv1，尤其是在使用子域名形式的网关时。在多个钱包、浏览器、网关和本地节点环境中测试 IPFS URI。根据内容的重要性选择相应的固定基础设施。备份原始文件和生成元数据所用的脚本。避免悄悄更改文件，因为即使细微改动也会生成新的 CID，并可能削弱用户信任。向用户说明项目如何使用 IPFS，让他们了解哪些内容在链上、哪些内容在链下，以及 CID 标识的是什么。

关于 IPFS CID 的常见误区

一个常见误区是认为 CID 会告诉用户文件存储在哪里。CID 标识的是内容，而不是某个特定存储位置。另一个误区是认为 CID 能保证内容始终可以加载。有效的 CID 仍需要可用的内容提供者。第三个误区是认为所有 IPFS 链接不经固定就能永久有效。内容能否持续可用，取决于托管、固定、备份和网络可用性。第四个误区是认为网关 URL 与 CID 相同。网关只是访问途径，而 CID 才是标识符。第五个误区是认为基于 CID 的内容总是安全的。用户仍应谨慎对待未知文件。

常见问题

IPFS CID 是什么意思？

IPFS CID 是 InterPlanetary File System Content Identifier（星际文件系统内容标识符）的缩写，是用于标识 IPFS 上数据的内容标签。

IPFS CID 与 URL 相同吗？

不同。IPFS CID 标识内容本身，而传统 URL 通常指向服务器和文件路径等位置。

IPFS CID 会改变吗？

在使用相同设置的情况下，同一内容对应的 CID 不应改变；但内容发生变化时，应生成不同的 CID。

IPFS CID 会将数据存储在链上吗？

不会，IPFS CID 本身不会将数据存储在链上，但区块链智能合约可以存储或引用 CID。

NFT 为什么使用 IPFS CID？

NFT 使用 IPFS CID，是因为它可以为链下元数据和媒体提供可验证的引用，而不必将大型文件直接存储在链上。

CID 能让 IPFS 内容永久保存吗？

不能。CID 负责标识内容，但内容仍需由可用的 IPFS 节点固定或托管，才能保持可访问。

IPFS CID 是私密的吗？

不是。CID 不应被视为私密信息，因为只要内容在 IPFS 上可用，拥有 CID 的人就可能检索到内容。

CIDv0 和 CIDv1 有什么区别？

CIDv0 是较早且限制较多的格式，而 CIDv1 较新，支持更灵活的编解码器和编码方式。

为什么有些 IPFS CID 以 Qm 开头？

许多以 Qm 开头的 CID 都是采用常见旧格式的 CIDv0 标识符。

两个不同文件会有相同的 CID 吗？

在通常的密码学假设下，如果采用相同哈希设置，两个不同文件不应生成相同的 CID。

如何打开 IPFS CID？

用户可以通过兼容的钱包、IPFS 网关、本地 IPFS 节点、IPFS Desktop 或其他支持 IPFS 内容检索的工具打开 CID。

智能合约可以更新 IPFS CID 吗？

只有当智能合约代码包含由授权账户或规则控制的更新机制时，合约才能更新 CID。

结语

IPFS CID 是加密货币和 Web3 去中心化存储的重要基础组成部分之一。它为文件、文件夹、元数据和应用资产提供基于内容的标识符，方便用户通过不同 IPFS 访问入口进行验证。对于 NFT，CID 有助于连接链上代币与链下媒体和元数据。对于 dApp，CID 有助于发布和验证静态前端文件及公开资源。对于社区，CID 有助于为文档、档案和项目资料创建透明的引用。核心概念很简单：CID 标识的是内容是什么，而不只是内容在哪里。这使 CID 在数据完整性和验证方面很有用，但用户仍需了解其局限。CID 不保证托管永久、内容私密、内容安全或项目可信。要正确使用 IPFS CID，加密货币用户应验证官方来源、固定重要内容、了解网关的工作方式、保护敏感数据，并记住内容能否访问取决于实际提供内容的节点。正确使用时，IPFS CID 能为加密应用提供一种实用方式，将区块链记录与去中心化、可验证且采用内容寻址的数据连接起来。