如何在 IPFS 上托管 NFT 镜像？ （皮纳塔指南）

了解 IPFS 及其在 NFT 存储中的作用

1. IPFS 代表星际文件系统，是一种点对点超媒体协议，旨在使网络更快、更安全、更开放。

2. 与通过服务器地址定位文件的传统 HTTP 不同，IPFS 通过其独特的加密哈希来检索内容，从而确保不变性和完整性。

3. NFT 依赖外部存储来存储媒体资产，因为以太坊等区块链网络由于成本和可扩展性限制，不会直接在链上存储大型二进制文件。

4. 将图像文件存储在 IPFS 上可以保证只要至少一个节点固定内容，资产就可以保持可访问性，从而避免集中故障点。

5. IPFS 生成的内容标识符（CID）成为嵌入 NFT 元数据 JSON 文件中的规范引用，将令牌链接到其视觉表示。

设置 Pinata 帐户和 API 访问

1. 访问 pinata.cloud 并使用电子邮件或 GitHub 身份验证注册免费帐户。

2. 导航至您的个人资料设置下的“API 密钥”部分，以生成一组启用“Pin”权限的新密钥。

3. 复制 JWT 令牌和 API 密钥对 - 以编程方式或通过 CLI 工具与 Pinata 的 REST API 交互时需要这些凭据。

4. Pinata 提供公共网关，例如 https://gateway.pinata.cloud/ipfs/，允许任何人无需身份验证即可解析 CID，从而实现去中心化访问。

5. 免费层用户每月可获得 1GB 固定存储和有限的 API 调用，足以启动小型 NFT 集合或测试工作流程。

使用 Pinata Web 界面上传 NFT 图像

1. 登录 Pinata 仪表板，然后单击顶部导航栏中的“固定文件”。

2. 将单个图像文件（或包含多个资产的 ZIP 存档）拖放到上传区域。

3. 上传完成后，Pinata 显示 CID、文件名、大小和时间戳；它还显示文件是否固定到 Pinata 的基础设施。

4. 单击任何上传项目旁边的三点菜单以复制其 CID 或生成可共享网关 URL。

5. 对于批处理，在上传之前以一致的命名约定组织图像，以简化以后的元数据生成。

使用 Pinata SDK 和 CLI 工具自动上传

1. 通过 npm 安装官方 Pinata SDK： npm install @pinata/sdk 。

2. 使用 API 密钥和密钥在 Node.js 脚本中初始化客户端，然后使用可读流或缓冲区调用pinFileToIPFS() 。

3. 使用pinata-cli包从终端上传： pinata pin add ./images/ ，支持递归目录上传。

4. 将上传逻辑集成到铸造脚本中，以便每个图像在将元数据写入区块链之前立即接收 CID。

5. 将返回的 CID 与相应的代币 ID 一起存储在本地 JSON 文件或数据库中，以在合约部署期间保持可追溯性。

常见问题解答

问：图像固定到 IPFS 后可以更新吗？答：不会。IPFS 内容在设计上是不可变的。要更改图像，您必须重新上传它并获取新的 CID，然后相应地更新 NFT 的元数据。

问：如果 Pinata 离线会怎样？答：您的文件通过缓存或固定它们的其他 IPFS 节点仍然可用。 cloudflare-ipfs.com 或 dweb.link 等公共网关也独立提供相同的 CID。

问：每次铸造后我需要再次固定我的 NFT 图像吗？答：不一定。如果所有 NFT 都引用相同的图像或使用基于模板的结构（其中变化是在链下处理的），则一次性上传就足够了。

问：有没有办法验证我的图片是否仍然被固定？答：是的。使用 Pinata 的pinList端点或通过curl 检查状态： curl 'https://api.pinata.cloud/data/pinList?ipfsPinHash= CID_HERE ' -H 'Authorization: Bearer YOUR_JWT' 。