NFT 元数据与 IPFS

什么是 NFT 元数据 IPFS？

NFT 元数据 IPFS 是指使用星际文件系统（IPFS）存储或引用与非同质化代币相关的元数据和媒体文件。

在加密市场中，NFT 通常通过区块链智能合约证明所有权，而元数据则说明该代币代表什么。

这些元数据可以包括 NFT 名称、描述、图片、动画文件、属性、特征、稀有度详情、游戏数据、外部 URL，或钱包和 NFT 应用向用户展示的其他信息。

IPFS 常用于 NFT，因为它为项目提供了基于内容寻址的文件引用方式，而不只是依赖传统 Web 服务器。

官方 IPFS NFT 数据最佳实践建议使用 IPFS URI，将智能合约与存储在 IPFS 上的外部 NFT 数据链接起来。

例如，NFT 智能合约可能会返回一个 token URI，例如

。

该 JSON 文件随后可能会指向一张图片，例如

。

钱包、交易市场、游戏或投资组合应用读取 NFT 时，会沿着 URI 获取元数据，并向用户展示 NFT 内容。

IPFS 对 NFT 元数据为何重要

IPFS 对 NFT 元数据很重要，因为许多 NFT 文件过大，或存储成本过高，不适合直接放在链上。

区块链适合存储所有权记录、交易历史和智能合约逻辑。

但通常不适合存储大型图片、视频、音乐文件、3D 对象或详细的 JSON 数据。

IPFS 通过允许 NFT 项目将数据存储在链下，同时使用可验证的内容标识符引用数据，帮助解决这一问题。

与普通服务器链接相比，这种方式可以降低存储成本并提升透明度。

如果 NFT 只指向普通 HTTPS URL，服务器所有者可能无需更改 URL，就能更改该 URL 对应的内容。

IPFS 使用内容寻址，内容标识符与文件内容绑定，因此更改文件会生成不同的标识符。

因此，希望更有力地证明元数据和媒体未被悄然替换的 NFT 项目可以使用 IPFS。

NFT 元数据如何与 IPFS 配合

基本流程从创作者或开发者为每个 NFT 准备元数据 JSON 文件开始。

元数据文件包含用于描述代币的字段，例如

、、 和 。

然后，创作者将 JSON 文件和相关媒体文件上传到 IPFS。

IPFS 会为每个文件或文件夹生成内容标识符，通常简称 CID。

NFT 智能合约会存储或返回一个指向元数据 CID 的 URI。

NFT 应用需要展示代币时，会调用智能合约以获取 token URI，从 IPFS 检索 JSON 文件，并读取其中的元数据字段。

如果元数据文件指向 IPFS 图片 URI，应用还会从 IPFS 获取该图片。

这样就形成了一条引用链：从链上代币指向链下元数据，再指向链下媒体。

NFT 元数据中的 CID 是什么？

CID，即内容标识符，是 IPFS 用于引用特定内容的标识。

官方 IPFS 内容寻址文档说明，CID 根据内容本身指向内容，而不是根据服务器位置进行定位。

这是 IPFS 与普通 Web 托管服务的主要区别之一。

普通 URL 通常会告诉浏览器到哪里查找内容。

CID 则会告诉 IPFS 系统要查找什么内容。

如果使用相同设置将相同内容添加到 IPFS，生成的 CID 应当相同。

即使内容只有一小部分发生变化，CID 也会改变。

对于 NFT 元数据，这意味着 JSON 文件和图片文件都可以各自拥有基于内容的身份标识。

IPFS URI 与 HTTPS URL

IPFS URI 通常以

开头。

HTTPS URL 通常以

开头。

常见的 IPFS 元数据 URI 可能如下所示：

。

基于网关的 HTTPS 版本可能如下所示：

。

IPFS URI 通常更适合作为 NFT 元数据的规范引用，因为它能清楚保留内容地址，不依赖某个特定网关域名。

HTTPS 网关 URL 仍然很有用，因为许多浏览器和应用无法原生支持

链接。

官方 IPFS 网关文档说明，网关可以让普通 HTTP 客户端获取基于内容寻址的 IPFS 数据。

实际上，许多 NFT 应用会将

链接转换为网关 URL，以便用户通过熟悉的 Web 基础设施加载图片和元数据。

存储在 IPFS 上的 NFT 元数据示例

存储在 IPFS 上的简单 NFT 元数据文件可能如下所示：

字段为 NFT 提供易读的名称。

字段用于说明 NFT 代表什么。

字段指向存储在 IPFS 上的 NFT 图片。

字段存储钱包、NFT 工具和稀有度系统可能会展示的特征。

将 JSON 文件上传到 IPFS 后，NFT 智能合约可以通过 token URI 指向该文件。

如果之后更改元数据文件，更新后的文件会拥有不同的 CID。

ERC-721 元数据与 IPFS

ERC-721 是 Ethereum 兼容网络上独特代币的主要 NFT 标准之一。

官方 ERC-721 标准包含一个可选元数据扩展，其中设有

函数。

该函数会返回一个指向特定 NFT 元数据的 URI。

使用 IPFS 时，返回的 token URI 可能指向 IPFS CID，而不是中心化 Web 服务器。

例如，代币 ID 1 可能返回

。

代币 ID 2 可能返回

。

这种结构常用于每个代币都具有不同作品、特征和稀有度数据的 NFT 系列。

将 IPFS 与 ERC-721 配合使用，为项目提供了一种实用方式，将链上所有权与链下内容存储分开处理。

ERC-1155 元数据与 IPFS

ERC-1155 是一种多代币标准，可在一个智能合约中支持 NFT、半同质化代币和同质化代币类型。

官方 ERC-1155 标准使用

函数处理元数据。

ERC-1155 还支持

替换模式，由应用将 替换为特定十六进制格式的实际代币 ID。

这适用于游戏、徽章、限量版本和包含多种代币类型的系列。

例如，ERC-1155 合约可能会返回一个 IPFS URI，例如

。

钱包或游戏客户端可以将

替换为正确的代币 ID，并获取相应的元数据文件。

这让 IPFS 既适用于独一无二的 NFT，也适用于大型多代币系列。

NFT 系列的 IPFS 文件夹

许多 NFT 项目会将整个元数据文件夹上传到 IPFS，而不是逐个上传文件。

文件夹中可能包含

、、 等文件。

另一个文件夹可能包含相匹配的图片，例如

、 和 。

文件夹上传到 IPFS 后会获得一个 CID。

随后，NFT 合约可以将该文件夹 CID 用作基础 URI。

例如，基础 URI 可以是

。

合约可以将基础 URI 与代币 ID 组合，生成

。

这种方式可以让 NFT 元数据更易于整理、揭晓、验证和保存。

在 IPFS 上固定 NFT 元数据

将数据上传到 IPFS 并不自动保证数据会永久可用。

如果数据没有被固定或以其他方式保存，IPFS 节点可能会在垃圾回收时移除缓存数据。

官方 IPFS 持久化与固定文档说明，可以将数据固定到一个或多个 IPFS 节点，以帮助保持数据可用。

固定操作会告知 IPFS 节点保留特定 CID，而不是将其视为临时缓存数据。

对 NFT 项目而言，固定内容很重要，因为元数据缺失可能导致 NFT 显示异常。

完善的 NFT 存储方案可以采用多个固定服务提供方、自托管 IPFS 节点、备份和监控。

收藏者也可以自行固定元数据，为所持资产增加一层保存保障。

IPFS 改善了基于内容寻址的访问方式，但要保持数据持久可用，仍需主动规划存储。

NFT 元数据的 IPFS 网关

IPFS 网关让普通浏览器和应用可以通过 HTTP 访问 IPFS 内容。

这一点很重要，因为并非所有钱包、浏览器或移动应用都能直接加载

链接。

网关可以将 IPFS 引用转换为可通过 Web 访问的 URL。

例如，

可以通过使用相同 CID 的 HTTP 网关 URL 访问。

网关可以提升可访问性，但不应与底层内容身份混为一谈。

如果一个网关速度缓慢或离线，其他网关仍可能获取相同的 CID。

因此，许多 NFT 开发者更倾向于将规范元数据引用保存为

URI，而不是在智能合约中写死某个网关 URL。

CID 才是重要引用，网关只是访问路径。

IPFS 与 NFT 揭晓

许多 NFT 系列会在揭晓活动中使用 IPFS。

揭晓前，每个代币可能会指向带有隐藏图片的占位元数据。

揭晓后，项目会更新智能合约的基础 URI 或 token URI，使每个 NFT 都指向 IPFS 上的最终元数据。

这些最终元数据可能包含独特作品、特征和稀有度信息。

如果项目在上线前已经准备并测试好 IPFS 元数据文件夹，揭晓流程可能会很简单。

如果元数据文件缺失、编号错误、上传了错误的 CID，或未正确固定，揭晓就可能出现风险。

项目应在揭晓前核验每个 JSON 文件、图片链接和代币 ID 映射。

收藏者应了解，揭晓可能会将 NFT 的展示内容从占位信息改为最终内容，但这并不意味着所有者自动发生了变化。

不可变元数据与 IPFS

IPFS 常用于类似不可变的 NFT 元数据，因为内容寻址会让悄然修改内容变得更困难。

如果项目通过固定 IPFS CID 存储元数据，且智能合约无法更新 URI，那么更改 NFT 元数据的难度就会大得多。

这可以提升收藏者的信任，因为图片和特征之后被替换的可能性较低。

不可变元数据尤其适用于艺术 NFT、历史收藏品、证书，以及买家期望呈现形式稳定的资产。

不过，不可变也意味着错误可能永久保留。

如果 JSON 文件中存在拼写错误、图片链接失效、特征不正确或描述有误，修复可能需要生成新的 CID 并更新合约。

如果合约不允许更新 URI，错误可能会永久留在 NFT 中。

项目在锁定 IPFS 引用前应仔细测试元数据。

可变元数据与 IPFS

可变元数据是指与 NFT 相关的信息在铸造后仍可更改。

可变元数据系统仍可使用 IPFS，但每次修改文件通常都会生成新的 CID。

动态 NFT 可能会在资产发生变化时更新 token URI，使其指向新的 IPFS CID。

例如，游戏角色 NFT 可能会升级、获得新装备，并指向 IPFS 上更新后的元数据。

持有者达到新的等级后，会员 NFT 可能会更新徽章图片。

进化型艺术 NFT 可能会根据链上或链下事件随时间变化。

可变 IPFS 元数据功能强大，但用户应了解谁有权控制更新，以及哪些规则会限制更改。

如果缺乏明确规则，可变元数据可能引发信任问题，因为持有者可能担心作品、特征或效用会被不公平地更改。

ERC-4906 与 IPFS 元数据更新

ERC-4906 是 ERC-721 元数据更新扩展，可帮助应用了解 NFT 元数据何时发生变化。

官方 ERC-4906 标准定义了

和 事件。

这些事件可以提示单个代币或一段代币范围的 JSON 元数据已更新。

这对基于 IPFS 的 NFT 很有用，因为应用经常会缓存元数据。

如果 token URI 从一个 IPFS CID 更改为另一个 CID，钱包或索引器可能需要收到信号后才会刷新展示的图片和属性。

ERC-4906 不存储 IPFS 文件，也不决定元数据应包含什么内容。

它只是为智能合约提供一种标准方式，告知应用元数据已经发生变化。

这有助于减少 NFT 工具中图片过时、特征陈旧和需要手动刷新的问题。

使用 IPFS 存储 NFT 元数据的优势

第一项优势是内容寻址。

CID 为 NFT 数据提供基于内容的引用，而不是只依赖服务器位置。

第二项优势是透明度更高。

用户可以将 CID 与预期的元数据和媒体进行比较，检查内容是否相符。

第三项优势是可移植性更好。

同一个 CID 可以通过不同网关或 IPFS 节点访问。

第四项优势是减少对单个中心化托管方的依赖。

如果多个节点或服务都固定了内容，即使某个访问点发生故障，内容仍可能保持可访问。

第五项优势是更有利于长期保存。

创作者、收藏者、档案机构和社区都可以通过固定相同的 CID，协助保存重要 NFT 文件。

第六项优势是更符合 Web3 理念。

IPFS 支持开放、分布式地访问 NFT 数据，而不是让资产完全依赖单一私有服务器。

IPFS 用于 NFT 元数据的局限

IPFS 不会自动让 NFT 元数据永久保存。

仍然需要有人存储、固定并提供内容。

IPFS 也无法保证所有地区或所有应用都能快速加载内容。

性能可能取决于网关、固定服务质量、节点可用性、缓存和文件大小。

IPFS 无法证明项目拥有所上传媒体的版权。

它只帮助定位和获取内容。

IPFS 也无法保护用户免受元数据字段中网络钓鱼链接的影响。

用户和应用在打开外部 URL 时仍需进行安全检查。

IPFS 也不能自动修复不良的元数据设计。

如果项目上传了无效 JSON、不一致的特征、缺失的图片或令人困惑的属性，这些问题仍可能损害 NFT 体验。

IPFS 元数据与 NFT 稀有度

NFT 稀有度通常根据元数据属性计算。

如果特征存储在 IPFS JSON 文件中，稀有度工具可能会读取这些文件，并根据特征出现频率为代币排名。

因此，元数据准确性非常重要。

例如，

和 之间的拼写差异可能导致工具将同一特征识别为两个不同的值。

缺少某个属性可能会让一个代币看起来不如其他代币完整。

错误特征可能影响市场价格和收藏者预期。

项目应在将元数据上传到 IPFS 前统一属性名称、值和数据类型。

项目还应备份最终元数据文件夹，以便之后验证揭晓时的确切数据。

IPFS 元数据与 NFT 图片

image 字段是 NFT 元数据中最重要的部分之一，因为它通常决定用户最先看到的内容。

图片存储在 IPFS 上时，元数据 JSON 应通过 IPFS URI 指向该图片。

例如，image 字段可能使用

。

项目应确保图片文件命名正确、已固定并且链接无误。

项目还应选择合理的文件大小，因为过大的图片可能导致钱包和移动应用加载缓慢。

不同应用支持的媒体格式可能有所差异，因此项目应在上线前测试展示效果。

对于动态 NFT，元数据可能包含

字段，指向视频、音频、HTML 或其他丰富媒体文件。

项目应避免在媒体关联内容中使用不安全脚本或可疑重定向。

IPFS 元数据与链上 NFT

并非所有 NFT 都需要使用 IPFS，因为有些 NFT 会将元数据完全存储在链上。

完全链上的 NFT 可以直接通过智能合约生成元数据。

这可以提升透明度并减少对外部存储的依赖。

不过，链上存储成本可能很高，而且容量有限。

IPFS 通常是一种实用的折中方案：所有权保留在链上，而较大的元数据和媒体文件存储在链下。

有些项目会结合使用这两种方式。

例如，合约可能在链上存储重要属性，同时使用 IPFS 存储高分辨率媒体。

最合适的设计取决于 NFT 的用途、文件大小、更新需求和长期保存目标。

IPFS 元数据与中心化服务器

IPFS 元数据常常会与托管在普通服务器上的中心化元数据进行比较。

中心化服务器速度快、灵活且易于更新。

但它们也可能形成单点故障。

如果服务器离线，NFT 可能会失去可见的元数据。

如果服务器所有者更改同一 URL 下的文件，用户可能会看到不同内容，却无法从链上变化中明显察觉。

IPFS 通过将引用与内容本身绑定，减少了这一问题。

不过，IPFS 仍需依赖节点、固定服务和网关来保持内容可用。

优秀的 NFT 项目可能会将 IPFS 用作规范引用，同时使用网关和备份改善加载速度。

IPFS 上 NFT 元数据的安全风险

存储在 IPFS 上的 NFT 元数据仍可能带来安全风险。

元数据文件可能包含指向网络钓鱼网站的外部链接。

媒体文件可能包含不安全内容，应用不应不加检查地直接渲染。

虚假的 NFT 系列可能会复制正版作品并上传到 IPFS。

项目管理员可能更新可变 token URI，使其指向有害或误导性的元数据。

网关 URL 也可能遭到仿冒，诱使用户信任错误的网站。

用户应避免通过不明 NFT 元数据中的链接连接钱包。

项目应清理和校验元数据、避免危险文件行为、保护更新权限，并通过可信渠道公布官方 CID。

应用应将元数据视为不受信任的输入，并保护用户免受不安全渲染或可疑外部链接的影响。

使用 IPFS 的 NFT 项目最佳实践

将 NFT 数据存储在 IPFS 上时，项目应使用

URI 作为规范的元数据和媒体引用。

上传前，项目应验证每个 JSON 文件。

项目应检查图片、动画和外部链接是否均能正常访问。

项目应按照代币 ID 清晰整理元数据和媒体文件夹。

项目应通过可靠的基础设施固定元数据和媒体。

重要系列应采用不止一种固定或备份方式。

项目应在上线前测试元数据在钱包、区块链浏览器、游戏和索引器中的展示效果。

项目应在用户铸造前决定元数据将采用不可变、可变还是动态模式。

项目应向买家清楚说明元数据政策。

如果元数据发生变化后需要应用检测，项目应使用 ERC-4906 等元数据更新事件。

NFT 买家和收藏者的最佳实践

NFT 买家应检查 token URI 指向的是 IPFS、HTTPS、链上数据还是其他存储方式。

买家应了解，IPFS 改善了内容寻址，但不会自动保证内容永久可用。

收藏者应检查元数据和媒体是否已固定，或是否有可靠的存储方案加以保存。

如果采用中心化元数据的 NFT 项目没有说明相关存储风险，收藏者应保持谨慎。

收藏者应避免点击 NFT 元数据中的未知外部链接。

收藏者应为重要 NFT 保存 token URI 和 CID 记录。

如果希望更主动地保存重要 NFT 元数据，收藏者也可以选择自行固定。

买家还应记住，良好的 IPFS 存储并不能保证市场价值、流动性、版权或未来效用。

NFT 元数据 IPFS 设计中的常见错误

一个常见错误是将图片上传到 IPFS，却把元数据留在中心化服务器上。

另一个常见错误是使用网关 URL 作为永久合约引用，而不是使用规范的

URI。

第三个错误是上传后忘记固定元数据文件夹。

第四个错误是在揭晓后更改元数据，却不通知持有者。

第五个错误是文件命名不一致，例如一个文件夹中的代币 ID 从 0 开始，而另一个文件夹从 1 开始。

第六个错误是上传无效 JSON，导致某些应用无法解析。

第七个错误是使用过大的媒体文件，导致 NFT 加载缓慢。

第八个错误是认为 IPFS 会自动处理法律权利、许可或版权归属。

如何在 IPFS 上检查 NFT 元数据

用户可以通过读取智能合约中的 token URI 来检查 NFT 元数据。

可以使用区块链浏览器、合约读取函数、钱包工具或 NFT 分析应用来完成此操作。

如果 token URI 以

开头，用户就可以查看 CID 和文件路径。

如果用户想通过普通浏览器查看，可能需要将 IPFS URI 转换为网关 URL。

例如，

可以通过支持相同 CID 和路径的 IPFS 网关查看。

之后，用户可以检查 JSON 字段，并访问图片或动画 URI。

如果 image 字段也使用 IPFS，用户可以单独检查该媒体 CID。

这一流程有助于用户了解 NFT 依赖的是 IPFS、中心化服务器还是其他存储系统。

IPFS 元数据与版权

将 NFT 元数据存储在 IPFS 上并不能证明版权归属。

它只是通过 IPFS 存储或引用内容。

即使项目没有获得图片的适当使用权，也可以将图片上传到 IPFS。

购买带有 IPFS 元数据的 NFT，也不会自动使买家获得相关媒体的版权。

元数据可以描述资产，但法律权利取决于项目许可、条款和适用法律。

创作者只能上传自己拥有或已获授权使用的媒体。

买家在将 NFT 作品、音乐、视频或品牌资产用于商业用途前，应查看许可条款。

IPFS 有助于保存和验证内容引用，但其本身并不是法律权利管理系统。

常见问题

NFT 元数据 IPFS 是什么意思？

NFT 元数据 IPFS 是指 NFT 使用 IPFS 存储或引用其元数据、媒体文件，或两者兼有。

NFT 为什么使用 IPFS 存储元数据？

NFT 使用 IPFS，是因为 IPFS 提供基于内容寻址的引用方式，较少依赖单一传统服务器的位置。

NFT 元数据中的 CID 是什么？

CID 是内容标识符，会根据内容本身指向 IPFS 上的特定内容。

IPFS 元数据存储在链上吗？

不存储。IPFS 元数据保存在链下，NFT 智能合约通常会存储或返回一个指向 IPFS 内容的 URI。

IPFS 会让 NFT 元数据永久保存吗？

IPFS 不会自动让元数据永久保存，因为内容仍需由节点和存储服务提供方固定、托管或以其他方式保存。

ipfs:// 与 https:// 有什么区别？

URI 通过 CID 指向 IPFS 内容，而 URL 通常指向 Web 服务器或网关位置。

IPFS 上的 NFT 元数据可以更改吗？

特定 CID 对应的内容无法在不生成新 CID 的情况下更改；不过，如果智能合约的设计允许更新，合约可以更改 token URI，使其指向另一个 CID。

钱包如何展示 IPFS NFT 元数据？

钱包通常会读取 token URI，通过 IPFS 或网关获取元数据 JSON，然后展示名称、图片、描述和属性。

如果 IPFS 元数据没有被固定，会发生什么？

如果 IPFS 元数据没有被固定或以其他方式保存，当没有节点保留并提供内容时，该元数据可能会变得无法访问。

IPFS 比中心化 NFT 元数据更好吗？

在基于内容寻址的验证和去中心化访问方面，IPFS 通常更有优势；但要可靠运行，仍需要固定服务、备份和良好的元数据设计。

结语

NFT 元数据 IPFS 是 NFT 生态系统中最重要的存储模式之一，因为它将基于区块链的所有权与基于内容寻址的元数据和媒体联系起来。

IPFS 允许 NFT 项目通过 CID 引用 JSON 文件、图片、动画和其他资产，而不只是依赖普通服务器 URL。

正确实施时，这可以提升透明度、可移植性和数据保存能力。

不过，IPFS 并不意味着内容会自动永久保存。

NFT 创作者仍需规划内容固定、备份、可靠网关、经过测试的元数据、清晰的更新政策和安全的智能合约权限控制。

NFT 买家应了解 NFT 是否使用 IPFS、内容是否已固定、元数据是否可以更改，以及展示的媒体是否符合项目的说法。

只有将 IPFS 纳入完整的 NFT 元数据策略，而不是仅仅将其视为简单的上传步骤，才能更好地发挥其作用。

如果与 ERC-721、ERC-1155、ERC-4906、完善的存储规划和透明沟通结合使用，IPFS 可以让 NFT 元数据更可靠、更易验证，也更符合加密资产的开放特性。