固定

文件如何在 IPFS 网络上持久存在，以及为什么固定很重要。

垃圾回收问题

IPFS 节点的存储空间有限。为了管理磁盘空间，它们会定期运行垃圾回收 — 一个清除未被明确标记为重要的缓存数据的过程。没有干预，您上传的文件可能在几小时内就从网络中被清除。

固定告诉 IPFS 节点："永久保留此文件 — 不要对其进行垃圾回收。" 被固定的文件会无限期地留在节点的存储中，确保在网络上保持可用。

本地固定 vs. 远程固定

本地固定意味着运行自己的 IPFS 节点并将文件固定到该节点。您需要负责正常运行时间、存储和网络连接。如果您的节点离线，文件将变得不可用。

远程固定（IPFS.NINJA 提供的服务）意味着由托管服务在始终在线的基础设施上固定您的文件。您无需运行自己的节点即可获得固定的持久性。

TIP

通过 IPFS.NINJA 上传的每个文件都会自动固定到我们的 IPFS 集群。无需额外步骤 — 您的文件从上传那一刻起就是持久的。

取消固定后会发生什么

如果您从 IPFS.NINJA 账户中删除文件，我们会从节点上取消固定。但如果以下情况，文件可能仍然可访问：

• 其他 IPFS 节点缓存或固定了相同的 CID
• IPFS 网关在其缓存中有该文件
• 另一个用户上传了相同的内容（相同的 CID = 相同的文件）

随着时间推移，如果没有节点固定该 CID，文件将从网络中被完全垃圾回收。

固定最佳实践

• 尽早固定 — 在智能合约、NFT 元数据或外部系统中引用 CID 之前，先上传并固定您的内容。
• 不要依赖缓存 — IPFS 网关缓存是临时的。只有固定的内容才能保证持久存在。
• 保持账户活跃 — 只要您的 IPFS.NINJA 账户处于活跃状态，即使在免费层级，文件也会保持固定。

固定现有内容

您不必通过 IPFS.NINJA 上传文件才能固定它。如果内容已经存在于 IPFS 网络上 — 由其他人上传的，或者您通过另一个服务上传的 — 您可以通过提供其 CID 将其固定到您的账户。

当您固定现有 CID 时，我们的集群会：

1. 在 IPFS 网络上搜索拥有该内容的节点
2. 从最近的可用节点下载内容
3. 在我们的基础设施上本地固定
4. 使其可通过您的账户和网关访问

这对以下场景很有用：

• 保存 NFT 资产 — 固定现有收藏集的元数据和图片
• 备份内容 — 确保重要的 CID 即使原始固定者离线也保持可用
• 从其他服务迁移 — 固定现有 CID 而无需重新上传文件

详情请参阅固定 API 文档。