跳到主要内容

使用Pinata上传文件至IPFS

建立NFT智能合约的初始阶段涉及准备您的NFT文件。 在这个情况下，文件将被上传到**Pinata**，这是一个允许您在IPFS上轻松管理和维护媒体文件的服务。 如果您还没有创建帐户，可以在此处注册。

什么是Pinata？​

Pinata是一个web3媒体管理服务，允许用户在IPFS中托管、管理和共享文件。 作为一个IPFS的固定服务，Pinata致力于为技术和非技术创作者提供一种快速、简单、可靠的方式来无限制地分享内容。

对于开发者，Pinata是将内容固定到IPFS并构建web3应用程序的最简单的方法之一，无需构建和管理自己的IPFS节点。 它已为开发者完成了所有繁重的工作。

对于创作者，Pinata使得在不需要任何技术经验的情况下大规模提供内容变得简单。 Pinata让创作者无需立即担心web3或IPFS的技术问题即可开始创作。

什么是“固定（Pinning）”？​

当您在一个IPFS节点上“固定”数据时，您告诉该节点这些数据是重要的，并且应该被保存。 节点是连接您到IPFS并存储文件的程序。

固定可以防止重要数据从您的节点中被删除。 只有您可以控制并在您的节点上固定数据 - 您不能强制IPFS网络上的其他节点为您固定内容。 因此，为了保证您的内容始终被固定，您必须运行自己的IPFS节点。

一旦您的文件被固定到IPFS，您可以完全控制分享、分发、变现和分享您的文件。

视频教程​

关于如何使用 pinata 来存储您的 Web3 文件，您可以观看以下实操视频：

准备好你的图片​

本指南将专注于创建单个NFT，也可以用同样的方式为更多NFT准备图片。 如果您想使用，可以在此处找到正在使用的图像。

将图像文件保存在计算机上的文件夹中。 将此图像命名为**0**，使其成为智能合约检索的第一张图像。 这将是此系列中的第一个（也是唯一一个）NFT；但是，如果你要添加更多图片，请继续按照升序的数字顺序命名它们。 一旦你的图片整理和命名好了，就将这个文件夹上传到Pinata。

备注

💡 注意：有些项目的文件名以**0开始，有些以1开始。 确保你的命名方式与智能合约代码保持一致。 我们这里将文件命名为0**。

1.png

登录Pinata后，你会看到你的仪表板。 上传按钮位于左侧。 点击**添加文件（Add Files），然后选择文件夹（Folder）**。

2.png

接下来，选择包含图片的文件夹。 你的浏览器可能会弹出一个窗口，要求你确认文件夹及其文件的上传。 如果是这样，点击**上传（Upload）**。

3.png

你需要为你上传的文件夹命名。 这在你有多个文件夹集上传到Pinata并需要保持它们有序时非常有用。 命名后，点击**上传（Upload）**并等待你的文件上传。 图片的数量和大小可能会影响上传时间，但对于这次这种小规模的上传，应该只需要几秒钟。

一旦上传完成，你的文件夹将出现在你的仪表板中。

4.png

点击文件夹名称，将带你进入Pinata网关，以查看你最近上传的文件。 如果你有一个付费的Pinata帐户，它会通过你自己的网关打开文件夹。 付费计划和个人网关对于本教程来说并不是必需的，但对于更大规模的NFT集合和托管多个文件夹是推荐的。

右键点击图像以复制其URL。 这个URL是非常关键的。 保存它，以备下一步设置元数据（metadata）使用。 在本示例中，URL是 https://gateway.pinata.cloud/ipfs/Qmb9WSGE66AJyYpggnxWPvmgHJo3mmyK5eNQJhKUK1ZpQn/0.png

设置元数据（Metadata）​

图像上传并且URL可用后，我们可以创建相应的元数据文件。 为此，我们需要(创建一个JSON文件)[https://codebeautify.org/blog/how-to-create-json-file/#:~:text=How%20to%20Create%20JSON%20File%3F%201%201.%20Using,3.%20Create%20a%20file%20from%20the%20JSON%20URL]).。

由于这个NFT将是一个ERC-721，我们知道可以使用在像**Joepegs.com**这样的市场上常见的元数据标准。 下面的.json文件展示了元数据应该是什么样子。

{
  "name": "",
  "tokenId": 0,
  "image": "",
  "description": "",
  "attributes": []
}

现在，让我们填写元数据文件的各个字段值。 你可以选择任何**name和description**。

这里的**tokenId将是0**，以对应上传的图片。 如果上传多个文件，该字段需要在每个文件中递增。

将之前保存的**图像**链接（URL）粘贴在这里，这样智能合约就知道在哪里找到你的NFT的图像文件。 如果上传多个文件，URL末尾（具体的图像）需要在每个文件中递增。

**attribute**字段在这里并不是非常关键，但如果你在上传具有多个层级的NFT，那么属性会代表这些特定层的信息。 这通常在确定NFT稀有度时使用，以根据他们在整个集合中层的频率对它们进行排名。 在这个教程中，我们将它留空。

下面是填写元数据文件字段的一个例子。

{
  "name": "Confi Art",
  "tokenId": 0,
  "image": "https://gateway.pinata.cloud/ipfs/Qmb9WSGE66AJyYpggnxWPvmgHJo3mmyK5eNQJhKUK1ZpQn/0.png",
  "description": "A beaver cartoon inspired in Confi."
}

保存此文件时，确保它的名称与对应的图片名称相同。 在本例中，它是0。

将元数据文件上传到Pinata后，文件扩展名将不再必要。 它将搜索该文件作为一个目录，并从那里提取信息。 要删除文件扩展名，请按照这些步骤操作**Mac环境，或者按照这些步骤操作Windows**环境。

将无文件扩展名的元数据放在一个单独的文件夹中，就像你处理图像文件一样。

5.png

现在，重复文件夹上传过程，将元数据添加到Pinata。 按照之前的步骤操作。 完成后，两个文件夹都将在你的仪表板上可访问。

6.png

点击元数据文件夹，将被引导到IPFS网关并保存URL。 这个URL将是你的基础URL，不需要直接的文件链接。 智能合约将追加每个NFT所需的必要文件信息。 例如，我们的URL是**https://gateway.pinata.cloud/ipfs/QmewVNwWYW27gKTrwhDG1Ge1ABqyQGxACCAdpx9a47d3sm**。