跳转至主要内容

如何使用 Sugar（Candy Machine）在 Solana 上部署 NFT 系列

更新于
2026年4月15日
亚伦·米兰诺简介
亚伦·米兰诺
全部
索拉纳
SVM
糖果机
Metaplex
NFT

阅读时间 6 分钟

Sugar v1 已弃用

本指南使用的是 Sugar v1 搭配 Candy Machine V2，后者现已弃用。对于新的 NFT 项目，请参阅《如何使用 Metaplex Core Candy Machine 发布 NFT 系列》。本指南仅供历史参考和教育用途。

概述​

您准备好在 Solana 上发布您的 NFT 系列了吗？Metaplex 推出的全新 Candy Machine 工具——Sugar，能助您快速上线。作为 Metaplex 最新版本的 Candy Machine，Sugar 带来了一些值得注意的改进： 

  • 提升了上传性能
  • 简化的用户体验 
  • 改进的错误处理

您将负责的工作内容​

在本指南中，您将使用 Solana CLI 创建一个新钱包，领取一些 SOL 空投，并使用 Sugar 在 Solana 开发网（devnet）上部署一个 Candy Machine。随后，您将通过 Candy Machine UI 将其部署到网络上。 

您需要准备的物品​

  • 已安装Node.js（版本 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 安装​

在终端中输入：

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

注意：安装完成后，您可能需要重启终端

Windows 安装​

  1. 请在此处下载 Windows 安装程序。
  2. 以管理员身份运行安装程序（右键单击-->以管理员身份运行). 如果您收到关于不可信二进制文件的警告，请尝试点击 更多信息 然后 不管怎样，还是跑吧. 如果您没有此选项，请按照以下步骤操作： 
    • 右键单击可执行文件，然后选择“属性”。
    •  如果您信任 Metaplex 开发团队，请如下图所示勾选“解除阻止”按钮。由于微软不会自动信任该二进制文件，此操作将允许您在计算机上运行该二进制文件。
    • 点击“应用”和“确定”。
    • 请重新运行安装程序

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

Windows 安装成功确认

设置新钱包​

Sugar 的一项很棒的新功能是，它允许您使用 Solana CLI 设置钱包和 RPC 配置，这样您就不需要在每次执行 Sugar 命令时都重新输入这些信息了。 

首先，我们需要使用以下命令创建一个专门用于开发网（devnet）测试的新钱包：

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

由于我们仅会在开发网（devnet）上使用该钱包，因此资金并不重要，我们可以跳过密码设置（按Enter 键）。通过运行以下命令，我们可以确认刚刚生成的钱包正是 Solana CLI 将要使用的钱包： 

Solana 配置 设置 --keypair ./wallet.json

建立与 Quicknode RPC 的连接​

我们需要确保 Solana CLI 已连接到某个节点。您可以使用公共节点，也可以部署和管理自己的基础设施；不过，如果您希望响应速度提升 8 倍，不妨将繁重的工作交给我们来处理。


了解为何超过50%的Solana项目选择Quicknode，并点击此处免费注册。

请确保在 Solana 开发网（Devnet）下启动您的节点，并复制 HTTP 链接：

新的 Solana HTTP 端点

在 Solana Devnet 上配置好您的端点后，现在可以运行以下命令，并将YOUR_QUICKNODE_URL替换为您复制的 HTTP URL：

Solana 配置 set --url 您的 QuickNode 网址

现在，要给您的钱包充值，您可以运行以下命令：

Solana 空投 1

如果命令执行成功，您应该会看到类似以下的内容：

空投成功

您还可以运行 Solana 余额 在终端中查看，确认那里有 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 默认查找文件的位置）。 

配置糖果机​

在项目根目录下创建一个名为 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 验证

糖验证成功

我们开始行动了！干得漂亮。让我们来制作我们的糖果机吧。 

制作糖果机​

由于我们已经使用 Solana CLI 配置了 RPC 和钱包，并且将资产和 config.json保存到了 Sugar 的默认目录中，因此我们的操作命令将非常简单！ 

上传您的素材​

在终端中输入：

sugar上传

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

Sugar 上传成功

部署糖果机​

在终端中输入：

sugar deploy简体中文（大陆）

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

Sugar 部署成功

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

请务必将终端中提供的“糖果机 ID”保存在本地。稍后我们会用到它。

验证糖果机​

让我们确认一切是否都按预期运行。在终端中输入：

sugar verify

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

糖果机 已验证

干得漂亮！

测试你的糖果机​

试着用糖来铸造一个 NFT。在终端中输入：

糖薄荷

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

成功的糖薄荷

太棒了！让我们创建一个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=<YOUR_CANDY_MACHINE_PUBKEY>
REACT_APP_SOLANA_NETWORK=devnet
REACT_APP_SOLANA_RPC_HOST=<YOUR_QUICKNODE_DEVNET_ENDPOINT>

如果你不记得自己的糖果机 ID，应该可以在程序的 cache.json文件中，通过program.candyMachine字段找到它。 

输入所有这些信息后，现在就可以保存文件了。在 candy-machine-ui 文件夹中，运行以下命令：

纱线 安装
yarn 启动

这将打开一个浏览器窗口，访问地址为localhost:3000，您可以在该页面连接钱包并铸造 NFT。继续操作前，请确认您的 Phantom 钱包已设置为 devnet 而非主网。

要在 Phantom 钱包中铸造 NFT，您需要在钱包里存有 devnet SOL。您可以通过 Solana CLI 向您的 Phantom 钱包空投，方法是在终端中输入以下命令： 

Solana 空投 1 您的_Phantom_钱包地址

准备就绪后，点击“Mint”。如果操作成功，您应该会看到一个类似这样的网站：

糖果机薄荷页面

如果您看到“铸造失败”的错误提示，可能是因为您的余额不足。请先充值，然后重试。购买完成后，您可以在钱包中查看该 NFT。Phantom 可能需要片刻时间才能在您的钱包中显示该 NFT。我们的显示效果如下：

在钱包中铸造 NFT

这糖真甜啊！干得不错。

结论​

恭喜！您已使用 Metaplex Sugar 创建了一台“糖果机”，并拥有了运行自己的 NFT 铸造所需的所有工具。我们非常期待看到您将创作什么样的 NFT！欢迎加入我们的Discord社区，或通过Twitter联系我们，分享您的 NFT 项目。 

我们 ❤️ 您的反馈！​

如果您对本指南有任何反馈或疑问，请告诉我们。我们非常期待您的反馈！

最后更新时间 在……上
分享本指南