如何使用 Sugar (Candy Machine) 在 Solana 上部署 NFT 合集

QuickNode
发布于 1天前
阅读 27

本文详细指导如何使用Metaplex Sugar (Candy Machine V2)在Solana链上部署NFT合集，涵盖钱包设置、资产准备、Candy Machine配置与部署、以及铸造页搭建。请注意，文中使用的Sugar V1版本已弃用。

Sugar v1 已废弃

本指南使用 Sugar v1 和 Candy Machine V2，这已废弃。对于新的 NFT 项目，请参阅[如何使用 Metaplex Core Candy Machine 启动 NFT 收藏](https://learnblockchain.cn/article/11941)。本指南仅供历史教育目的。

#### 在开始本指南之前

本指南将通过一系列技术步骤，深入讲解如何使用 Sugar (Candy Machine) 在 Solana 上部署 NFT 收藏。如果你想更快地完成这项任务并把繁重的工作留给我们，我们推荐使用 [Crossmint NFT Mint API [mainnet]](https://marketplace.quicknode.com/add-on/crossmint-nft-mint-api-mainnet) 附加组件。通过使用 Crossmint NFT Mint API [mainnet]，你可以避免创建 Candy Machine。使用 NFT Mint API 创建收藏品并降低前期成本，轻松铸造 NFT！

[试试 Crossmint NFT Mint API [mainnet]](https://marketplace.quicknode.com/add-on/crossmint-nft-mint-api-mainnet)

## 概述

你准备好在 Solana 上发布你的 NFT 收藏了吗？Metaplex 新的 Candy Machine 工具——Sugar，是让你立即发布的工具。Sugar 是 Metaplex 最新版本的 Candy Machine，它带来了一些显著的改进：

-   改进的上传性能
-   简化的用户体验 (UX)
-   改进的错误处理

#### **你将做什么**

在本指南中，你将使用 Solana CLI 创建一个新钱包，空投一些 SOL，并使用 Sugar 在 Solana 的 devnet 上部署一个 Candy Machine。然后，你将使用 Candy Machine UI 将你的 Candy Machine 部署到网络上。

#### **你需要什么**

-   已安装 [Nodejs](https://nodejs.org/en/) (版本 16.15 或更高)
-   已安装 [Solana CLI](https://docs.solana.com/cli/install-solana-cli-tools)
-   已安装 [Phantom Wallet](https://phantom.app/) 或 [Solflare 扩展](https://solflare.com/)
-   已安装 [Metaplex Sugar](https://docs.metaplex.com/developer-tools/sugar/overview/installation) (**旧版本, V1.x**)
-   一个文本编辑器
-   已安装 npm 或 yarn (我们将使用 yarn 初始化项目并安装必要的包。如果你更喜欢 npm，也可以随意使用。)

## 设置你的项目

在你的终端中，使用以下命令创建一个新的项目目录：

```sh
mkdir sugar-demo
cd sugar-demo
```

## 安装 Sugar

**本指南假设你正在使用旧版本的 Sugar，V1.x。（Candy Machine v2）。如果你正在使用更新的版本，请查看我们的[指南](https://learnblockchain.cn/article/11174)。**

#### **Mac 安装**

在你的终端中输入：

```bash
<(curl -sSf https://sugar.metaplex.com/install.sh)
```

注意：安装后你可能需要重启终端

#### **Windows 安装**

1.  从[此处](https://github.com/metaplex-foundation/winstaller/releases/latest/download/winstaller.exe)下载 Windows 安装程序。
2.  以管理员身份运行安装程序（右键点击 --> **以管理员身份运行**）。如果你收到关于不受信任的二进制文件的警告，请尝试点击 _更多信息_，然后 _仍然运行_。如果你没有此选项，请按照以下步骤操作：
    -   右键点击可执行文件并选择 _属性_。
    -   如果你信任 Metaplex 开发团队，请勾选 _解除锁定_ 按钮，如下图所示。这将允许你在计算机上运行此二进制文件，因为 Microsoft 不会自动信任它。
    -   点击 _应用_ 和 _确定_。
    -   再次运行安装程序

如果一切正常，你应该会看到类似以下内容：

![Windows 安装成功确认](https://img.learnblockchain.cn/2026/03/28/0-95510ae0acc690e061170eff60e4d059.png)

## 设置新钱包

Sugar 的一个很酷的新功能是它允许你使用 Solana CLI 设置你的钱包和 RPC 配置，这样你就不需要在每个 Sugar 命令中重新输入它们。

我们首先需要专门为 devnet 测试创建一个新钱包，使用以下命令：

```sh
solana-keygen new --outfile ./wallet.json
```

我们可以跳过密码（通过按 **Enter**），因为我们只会在 devnet 上使用这个钱包，所以资金并不重要。我们可以通过运行以下命令确认我们刚刚生成的钱包是 Solana CLI 将使用的钱包：

```sh
solana config set --keypair ./wallet.json
```

## 建立与你的 Quicknode RPC 的连接

我们需要确保我们的 Solana CLI 连接到一个节点。你可以随意使用公共节点或部署和管理你自己的基础设施，但是，如果你想获得 8 倍更快的响应时间，你可以把繁重的工作留给我们。

查看超过 50% 的 Solana 项目选择 Quicknode 的原因，并在此处[免费注册](https://www.quicknode.com/chains/sol)。

确保在 Solana Devnet 下启动你的节点，并复制 HTTP 链接：

![新的 Solana HTTP 端点](https://img.learnblockchain.cn/2026/03/28/1-9b8c136f77deeffa7ef3d7e66edc9bb8.png)

设置好你的 Solana Devnet 端点后，你现在可以运行此命令，将 **YOUR\_QUICKNODE\_URL** 替换为你复制的 HTTP URL：

```sh
solana config set --url YOUR_QUICKNODE_URL
```

现在要为你的钱包充值，你可以运行命令：

```sh
solana airdrop 1
```

如果命令成功，你应该会看到类似以下内容：

![空投成功](https://img.learnblockchain.cn/2026/03/28/2-227ab1f83042a1ef83a0b22990fbc997.png)

你也可以在终端中运行 `solana balance`，看到 1 SOL 就在那里。

## 准备 NFT 资产

如果你之前使用过 Candy Machine，这个过程会很熟悉。我们需要为每个数字资产创建一个 _.json_ 文件，使用从 0 开始并依次递增的简单数字格式，永不跳过任何数字（例如，0.json 映射到 0.png，然后 1.json 映射到 1.png）。我们还可以创建一个可选的 **collection.json** 和 **collection.png**，以使 Sugar 能够自动创建链上收藏。

Metaplex 有一套[样本资产](https://docs.metaplex.com/assets/files/assets-ff6bd873ecd07b49c86faf3c7aab82d2.zip)，我们可以下载并使用它们以保持一致。你可以编辑 json 以包含你想要的任何值，只要它符合 [URI json 模式](https://docs.metaplex.com/programs/token-metadata/token-standard#the-non-fungible-standard)。

下载样本集并将其内容解压到你项目目录中的 **./assets/**（这是 Sugar 查找文件的默认目录）。

## 配置 Candy Machine

在你的根项目文件夹中创建一个新文件，**config.json**：

```sh
echo > config.json
```

打开文件并粘贴此配置：

```json
{
    "price": 0.01,
    "number": 10,
    "symbol": "NB",
    "sellerFeeBasisPoints": 500,
    "gatekeeper": null,
    "solTreasuryAccount": "YOUR_WALLET_ADDRESS",
    "splTokenAccount": null,
    "splToken": null,
    "goLiveDate": "2022-07-24T00:00:00Z",
    "endSettings": null,
    "whitelistMintSettings": null,
    "hiddenSettings": null,
    "uploadMethod": "bundlr",
    "awsS3Bucket": null,
    "retainAuthority": true,
    "isMutable": true,
    "creators": [\
    {\
      "address": "YOUR_WALLET_ADDRESS",\
      "share": 100\
    }\
  ]
}
```

> 注意：你可以在终端中运行 **solana address** 来获取你刚刚创建的钱包地址。

现在，我们应该一切就绪了。如果你一直跟着到这里，你的目录结构应该像这样：

> -   sugar-demo/wallet.json
> -   sugar-demo/config.json
> -   sugar-demo/assets/\[0-9\].png
> -   sugar-demo/assets/\[0-9\].json
> -   sugar-demo/assets/collection.png
> -   sugar-demo/assets/collection.json

Sugar 有一个内置的验证器，可以让我们在继续之前检查任何错误。在终端中，运行：

```sh
sugar validate
```

![Sugar 验证成功](https://img.learnblockchain.cn/2026/03/28/3-ae802e2cddaf765d61ed41a3807ea0ed.png)

我们干得漂亮！让我们构建我们的 Candy Machine。

## 创建 Candy Machine

因为我们已经使用 Solana CLI 设置了我们的 RPC 和钱包，并且我们将 **assets** 和 **config.json** 保存到了 Sugar 的默认目录中，所以我们的命令将非常简单！

#### **上传你的资产**

在你的终端中输入：

```sh
sugar upload
```

你应该会看到类似以下内容：

![Sugar 上传成功](https://img.learnblockchain.cn/2026/03/28/4-a1bef9869087ac86808264f079cdb68e.png)

#### **部署 Candy Machine**

在你的终端中输入：

```sh
sugar deploy
```

你应该会看到类似以下内容：

![Sugar 部署成功](https://img.learnblockchain.cn/2026/03/28/5-d11d474eb3986924d4e0681dd077264a.png)

> 如果你收到“Blockhash not found”错误，请尝试再次运行该命令。

请务必将终端中提供的 Candy Machine ID 本地存储。我们稍后会用到它。

#### **验证 Candy Machine**

让我们确保一切都按预期工作。在你的终端中输入：

```sh
sugar verify
```

你应该会看到类似以下内容：

![Candy Machine 已验证](https://img.learnblockchain.cn/2026/03/28/6-4847aad70b580356404925e73f6e0570.png)

干得漂亮！

#### **测试你的 Candy Machine**

尝试使用 Sugar 铸造一个 NFT。在你的终端中输入：

```sh
sugar mint
```

你应该会看到类似以下内容：

![Sugar 铸造成功](https://img.learnblockchain.cn/2026/03/28/7-16f940ec25f6619345c7d73e27e6d3f5.png)

太棒了！让我们创建一个铸造页面，这样我们就可以与全世界分享这个项目了！

## 设置铸造站点

为了最简单的设置，我们将使用 Metaplex 提供给我们的前端 Candy Machine UI。

从你的项目目录中，在你的终端中输入：

```sh
git clone https://github.com/metaplex-foundation/candy-machine-ui ./candy-machine-ui/
cd candy-machine-ui
```

将文件 **.env.example** 重命名为 **.env**。更改文件名后，你可以将其中的值更改为以下内容：

```sh
REACT_APP_CANDY_MACHINE_ID=<YOUR_CANDY_MACHINE_PUBKEY>
REACT_APP_SOLANA_NETWORK=devnet
REACT_APP_SOLANA_RPC_HOST=<YOUR_QUICKNODE_DEVNET_ENDPOINT>
```

如果你不记得你的 Candy Machine ID，你可以在 **cache.json** 文件的 **program.candyMachine** 字段中找到它。

所有这些信息都已填好后，你现在可以保存文件了。从 candy-machine-ui 文件夹中，运行以下命令：

```sh
yarn install
yarn start
```

这将在 [localhost:3000](localhost:3000) 打开一个浏览器，你可以在其中连接你的钱包并铸造 NFT。请在继续之前确认你的 Phantom Wallet 已设置为 devnet 而非 mainnet。

你的 Phantom 钱包中需要有 devnet SOL 才能铸造 NFT。你可以在终端中输入此命令，使用 Solana CLI 向你的 Phantom 钱包空投：

```sh
solana airdrop 1 YOUR_PHANTOM_WALLET_ADDRESS
```

准备就绪后，点击“Mint”。如果成功完成，你应该会看到一个像这样的网站：

![Candy Machine 铸造页面](https://img.learnblockchain.cn/2026/03/28/8-7b14dd6084c343a0d3e21b63fffa0355.png)

如果你看到一个显示“Mint Failed”的错误，你可能没有足够的资金。添加资金后再试。购买后你可以在你的钱包中查看 NFT。Phantom 可能需要一些时间才能在你的钱包中渲染 NFT。我们的看起来像这样：

![钱包中铸造的 NFT](https://img.learnblockchain.cn/2026/03/28/9-8dcd030390fbba23e3dfb38ac1a3fb64.png)

这真是一些甜蜜的 Sugar！干得漂亮。

## 结论

恭喜！你使用 Metaplex Sugar 创建了一个 Candy Machine，并拥有运行自己 NFT 铸造所需的所有工具。我们很高兴看到你正在创建的 NFT！加入我们的 [Discord](https://discord.gg/quicknode) 或通过 [Twitter](https://twitter.com/Quicknode) 联系我们分享你的 NFT 项目。

#### 我们 ❤️ 反馈！

如果你对本指南有任何反馈或问题，请[告诉我们](https://airtable.com/shrKKKP7O1Uw3ZcUB?prefill_Guide+Name=How%20to%20Deploy%20an%20NFT%20Collection%20on%20Solana%20Using%20Sugar)。我们很乐意听取你的意见！

>- 原文链接： [quicknode.com/guides/sol...](https://www.quicknode.com/guides/solana-development/legacy/how-to-deploy-an-nft-collection-on-solana-using-sugar-candy-machine)
>- 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～

Sugar v1 已废弃

本指南使用 Sugar v1 和 Candy Machine V2，这已废弃。对于新的 NFT 项目，请参阅如何使用 Metaplex Core Candy Machine 启动 NFT 收藏。本指南仅供历史教育目的。

在开始本指南之前

本指南将通过一系列技术步骤，深入讲解如何使用 Sugar (Candy Machine) 在 Solana 上部署 NFT 收藏。如果你想更快地完成这项任务并把繁重的工作留给我们，我们推荐使用 Crossmint NFT Mint API [mainnet] 附加组件。通过使用 Crossmint NFT Mint API [mainnet]，你可以避免创建 Candy Machine。使用 NFT Mint API 创建收藏品并降低前期成本，轻松铸造 NFT！

试试 Crossmint NFT Mint API [mainnet]

概述

改进的上传性能
简化的用户体验 (UX)
改进的错误处理

你将做什么

你需要什么

已安装 Nodejs (版本 16.15 或更高)
已安装 Solana CLI
已安装 Phantom Wallet 或 Solflare 扩展
已安装 Metaplex Sugar (旧版本, V1.x)
一个文本编辑器
已安装 npm 或 yarn (我们将使用 yarn 初始化项目并安装必要的包。如果你更喜欢 npm，也可以随意使用。)

设置你的项目

在你的终端中，使用以下命令创建一个新的项目目录：

mkdir sugar-demo
cd sugar-demo

安装 Sugar

本指南假设你正在使用旧版本的 Sugar，V1.x。（Candy Machine v2）。如果你正在使用更新的版本，请查看我们的指南。

Mac 安装

在你的终端中输入：

&lt;(curl -sSf https://sugar.metaplex.com/install.sh)

注意：安装后你可能需要重启终端

Windows 安装

从此处下载 Windows 安装程序。
以管理员身份运行安装程序（右键点击 --> 以管理员身份运行）。如果你收到关于不受信任的二进制文件的警告，请尝试点击 更多信息，然后 仍然运行。如果你没有此选项，请按照以下步骤操作：
- 右键点击可执行文件并选择属性。
- 如果你信任 Metaplex 开发团队，请勾选 解除锁定 按钮，如下图所示。这将允许你在计算机上运行此二进制文件，因为 Microsoft 不会自动信任它。
- 点击应用和确定。
- 再次运行安装程序

如果一切正常，你应该会看到类似以下内容：

设置新钱包

Sugar 的一个很酷的新功能是它允许你使用 Solana CLI 设置你的钱包和 RPC 配置，这样你就不需要在每个 Sugar 命令中重新输入它们。

我们首先需要专门为 devnet 测试创建一个新钱包，使用以下命令：

solana-keygen new --outfile ./wallet.json

我们可以跳过密码（通过按 Enter），因为我们只会在 devnet 上使用这个钱包，所以资金并不重要。我们可以通过运行以下命令确认我们刚刚生成的钱包是 Solana CLI 将使用的钱包：

solana config set --keypair ./wallet.json

建立与你的 Quicknode RPC 的连接

查看超过 50% 的 Solana 项目选择 Quicknode 的原因，并在此处免费注册。

确保在 Solana Devnet 下启动你的节点，并复制 HTTP 链接：

设置好你的 Solana Devnet 端点后，你现在可以运行此命令，将 YOUR_QUICKNODE_URL 替换为你复制的 HTTP URL：

solana config set --url YOUR_QUICKNODE_URL

现在要为你的钱包充值，你可以运行命令：

solana airdrop 1

如果命令成功，你应该会看到类似以下内容：

你也可以在终端中运行 solana balance，看到 1 SOL 就在那里。

准备 NFT 资产

如果你之前使用过 Candy Machine，这个过程会很熟悉。我们需要为每个数字资产创建一个 .json 文件，使用从 0 开始并依次递增的简单数字格式，永不跳过任何数字（例如，0.json 映射到 0.png，然后 1.json 映射到 1.png）。我们还可以创建一个可选的 collection.json 和 collection.png，以使 Sugar 能够自动创建链上收藏。

Metaplex 有一套样本资产，我们可以下载并使用它们以保持一致。你可以编辑 json 以包含你想要的任何值，只要它符合 URI json 模式。

下载样本集并将其内容解压到你项目目录中的 ./assets/（这是 Sugar 查找文件的默认目录）。

配置 Candy Machine

在你的根项目文件夹中创建一个新文件，config.json：

echo > config.json

打开文件并粘贴此配置：

{
    "price": 0.01,
    "number": 10,
    "symbol": "NB",
    "sellerFeeBasisPoints": 500,
    "gatekeeper": null,
    "solTreasuryAccount": "YOUR_WALLET_ADDRESS",
    "splTokenAccount": null,
    "splToken": null,
    "goLiveDate": "2022-07-24T00:00:00Z",
    "endSettings": null,
    "whitelistMintSettings": null,
    "hiddenSettings": null,
    "uploadMethod": "bundlr",
    "awsS3Bucket": null,
    "retainAuthority": true,
    "isMutable": true,
    "creators": [\
    {\
      "address": "YOUR_WALLET_ADDRESS",\
      "share": 100\
    }\
  ]
}

注意：你可以在终端中运行 solana address 来获取你刚刚创建的钱包地址。

现在，我们应该一切就绪了。如果你一直跟着到这里，你的目录结构应该像这样：

sugar-demo/wallet.json

sugar-demo/config.json

sugar-demo/assets/[0-9].png

sugar-demo/assets/[0-9].json

sugar-demo/assets/collection.png

sugar-demo/assets/collection.json

Sugar 有一个内置的验证器，可以让我们在继续之前检查任何错误。在终端中，运行：

sugar validate

我们干得漂亮！让我们构建我们的 Candy Machine。

创建 Candy Machine

因为我们已经使用 Solana CLI 设置了我们的 RPC 和钱包，并且我们将 assets 和 config.json 保存到了 Sugar 的默认目录中，所以我们的命令将非常简单！

上传你的资产

在你的终端中输入：

sugar upload

你应该会看到类似以下内容：

部署 Candy Machine

在你的终端中输入：

sugar deploy

你应该会看到类似以下内容：

如果你收到“Blockhash not found”错误，请尝试再次运行该命令。

请务必将终端中提供的 Candy Machine ID 本地存储。我们稍后会用到它。

验证 Candy Machine

让我们确保一切都按预期工作。在你的终端中输入：

sugar verify

你应该会看到类似以下内容：

干得漂亮！

测试你的 Candy Machine

尝试使用 Sugar 铸造一个 NFT。在你的终端中输入：

sugar mint

你应该会看到类似以下内容：

太棒了！让我们创建一个铸造页面，这样我们就可以与全世界分享这个项目了！

设置铸造站点

为了最简单的设置，我们将使用 Metaplex 提供给我们的前端 Candy Machine UI。

从你的项目目录中，在你的终端中输入：

git clone https://github.com/metaplex-foundation/candy-machine-ui ./candy-machine-ui/
cd candy-machine-ui

将文件 .env.example 重命名为 .env。更改文件名后，你可以将其中的值更改为以下内容：

REACT_APP_CANDY_MACHINE_ID=&lt;YOUR_CANDY_MACHINE_PUBKEY>
REACT_APP_SOLANA_NETWORK=devnet
REACT_APP_SOLANA_RPC_HOST=&lt;YOUR_QUICKNODE_DEVNET_ENDPOINT>

如果你不记得你的 Candy Machine ID，你可以在 cache.json 文件的 program.candyMachine 字段中找到它。

所有这些信息都已填好后，你现在可以保存文件了。从 candy-machine-ui 文件夹中，运行以下命令：

yarn install
yarn start

这将在 localhost:3000 打开一个浏览器，你可以在其中连接你的钱包并铸造 NFT。请在继续之前确认你的 Phantom Wallet 已设置为 devnet 而非 mainnet。

你的 Phantom 钱包中需要有 devnet SOL 才能铸造 NFT。你可以在终端中输入此命令，使用 Solana CLI 向你的 Phantom 钱包空投：

solana airdrop 1 YOUR_PHANTOM_WALLET_ADDRESS

准备就绪后，点击“Mint”。如果成功完成，你应该会看到一个像这样的网站：

这真是一些甜蜜的 Sugar！干得漂亮。

结论

恭喜！你使用 Metaplex Sugar 创建了一个 Candy Machine，并拥有运行自己 NFT 铸造所需的所有工具。我们很高兴看到你正在创建的 NFT！加入我们的 Discord 或通过 Twitter 联系我们分享你的 NFT 项目。

我们 ❤️ 反馈！

如果你对本指南有任何反馈或问题，请告诉我们。我们很乐意听取你的意见！

原文链接： quicknode.com/guides/sol...

登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～

翻译
学分: 0
分类: Solana
标签: Solana NFT Metaplex Sugar Candy Machine 部署铸造

本文参与登链社区写作激励计划，好文好收益，欢迎正在阅读的你也加入。

如何使用 Sugar (Candy Machine) 在 Solana 上部署 NFT 合集

在开始本指南之前

概述

你将做什么

你需要什么

设置你的项目

安装 Sugar

Mac 安装

Windows 安装

设置新钱包

建立与你的 Quicknode RPC 的连接

准备 NFT 资产

配置 Candy Machine

创建 Candy Machine

上传你的资产

部署 Candy Machine

验证 Candy Machine

测试你的 Candy Machine

设置铸造站点

结论

我们 ❤️ 反馈！

0 条评论

文章目录