安装 Solana CLI

<!--StartFragment-->

根据您的首选工作流程，有多种方法可以在您的计算机上安装 Solana 工具：

• 使用 Solana 安装工具（最简单的选项）
• 下载预构建的二进制文件
• 从源代码构建
• 使用 Homebrew

使用 Solana 安装工具

MacOS 和Linux

• 打开您最喜欢的终端应用程序
• 通过运行以下命令在您的机器上安装 Agave 版本 v2.2.0 ：

sh -c "$(curl -sSfL https://release.anza.xyz/v2.2.0/install)"

• 您可以v2.2.0用与所需版本的软件版本相匹配的发布标签进行替换，或者使用三个符号频道名称之一：stable、beta或edge。
• 以下输出表明更新成功：

downloading v2.2.0 installer
Configuration: /home/solana/.config/solana/install/config.yml
Active release directory: /home/solana/.local/share/solana/install/active_release
* Release version: v2.2.0
* Release URL: https://github.com/anza-xyz/agave/releases/download/v2.2.0/solana-release-x86_64-unknown-linux-gnu.tar.bz2
Update successful

• 根据您的系统，安装程序消息的结尾可能会提示您

Please update your PATH environment variable to include the solana programs:

• 如果收到上述消息，请复制并粘贴下方推荐的命令进行更新PATH
• 通过运行以下命令确认您已安装所需的版本solana：

solana --version

• 安装成功后，agave-install update可以随时轻松将 Solana 软件更新到较新的版本。

窗户

• cmd.exe以管理员身份打开命令提示符 (

  • 在 Windows 搜索栏中搜索命令提示符。出现命令提示符应用时，右键单击并选择“以管理员身份打开”。如果弹出窗口询问“您是否允许此应用更改您的设备？”，请单击“是”。

• 复制并粘贴以下命令，然后按 Enter 将 Solana 安装程序下载到临时目录中：

cmd /c "curl https://release.anza.xyz/v2.2.0/agave-install-init-x86_64-pc-windows-msvc.exe --output C:\agave-install-tmp\agave-install-init.exe --create-dirs"

• 复制并粘贴以下命令，然后按 Enter 安装最新版本的 Solana。如果您看到系统弹出安全提示，请选择允许该程序运行。

C:\agave-install-tmp\agave-install-init.exe v2.2.0

• 安装程序完成后，按 Enter。

• 关闭命令提示符窗口并以普通用户身份重新打开一个新的命令提示符窗口

  • 在搜索栏中搜索“命令提示符”，然后左键单击命令提示符应用程序图标（无需以管理员身份运行）

• solana输入以下命令确认您已安装所需版本：

solana --version

• 安装成功后，agave-install update可以随时轻松将 Solana 软件更新到较新的版本。

下载预构建的[二进制文件]

如果您不想使用agave-install管理安装，您可以手动下载并安装二进制文件。

Linux

通过导航至https://github.com/anza-xyz/agave/releases/latest下载二进制文件 ，下载solana-release-x86_64-unknown-linux-gnu.tar.bz2，然后提取存档：

tar jxf solana-release-x86_64-unknown-linux-gnu.tar.bz2
cd solana-release/
export PATH=$PWD/bin:$PATH

MacOS

通过导航至https://github.com/anza-xyz/agave/releases/latest下载二进制文件 ，下载solana-release-x86_64-apple-darwin.tar.bz2，然后提取存档：

tar jxf solana-release-x86_64-apple-darwin.tar.bz2
cd solana-release/
export PATH=$PWD/bin:$PATH

窗户

• 通过导航至https://github.com/anza-xyz/agave/releases/latest下载二进制文件 ，下载solana-release-x86_64-pc-windows-msvc.tar.bz2，然后使用 WinZip 或类似程序提取存档。
• 打开命令提示符并导航到您解压二进制文件的目录并运行：

cd solana-release/
set PATH=%cd%/bin;%PATH%

从源代码

如果您无法使用预构建的二进制文件或希望从源代码自行构建，请按照以下步骤操作，确保您的系统上安装了必要的先决条件。

先决条件

从源代码构建之前，请确保安装以下先决条件：

锈病

对于所有平台，请查看 <https://www.rust-lang.org/tools/install>上的“安装 Rust” 以获取最新的安装说明。

对于 Debian 和其他 Linux 发行版

安装构建依赖项：

• 构建必需品
• 包配置
• Udev、LLM 和 libclang
• 协议缓冲区

apt-get install \
    build-essential \
    pkg-config \
    libudev-dev llvm libclang-dev \
    protobuf-compiler

对于其他 Linux 发行版

apt用你的发行版的包管理器（例如yum，，，dnf） 替换pacman并根据需要调整包名称。

对于 macOS 

如果尚未安装，请查看https://brew.sh/上的“安装 Homebrew”以获取 Homebrew 的最新安装说明。

然后，使用以下命令安装构建依赖项brew：

brew install pkg-config libudev protobuf llvm coreutils

按照 brew install 命令末尾给出的有关 PATH配置的说明进行操作。

对于 Windows

• 从Visual Studio 下载页面下载并安装 Visual Studio 构建工具（2019 或更高版本） 。确保在安装中包含 C++ 构建工具。
• 安装 LLVM：从 官方 LLVM 下载页面下载并安装 LLVM 。
• 安装协议缓冲区编译器（protoc）：protoc从 Protocol Buffers 的 GitHub 发布页面下载，并将其添加到你的PATH.

信息

Windows 10 或 11 上的用户可能需要安装 Windows Subsystem for Linux (WSL) 才能从源代码构建。WSL 提供了一个在现有 Windows 安装中运行的 Linux 环境。然后，您可以运行常规 Linux 软件，包括 Solana CLI 的 Linux 版本。

安装后，wsl从 Windows 终端运行，然后继续 上面的Debian 和其他 Linux 发行版。

从源头

安装先决条件后，继续从源代码构建 Solana，导航到 Solana 的 GitHub 发布页面，然后下载源代码存档。提取代码并使用以下命令构建二进制文件：

./scripts/cargo-install-all.sh .
export PATH=$PWD/bin:$PATH

然后，您可以运行以下命令来获得与预构建二进制文件相同的结果：

agave-install init

使用Homebrew

此选项要求您在 MacOS 或 Linux 机器上安装Homebrew包管理器。

MacOS 和Linux

• 按照以下说明操作：<https://formulae.brew.sh/formula/solana>

Homebrew 公式 在每次发布后都会更新solana，但是 Homebrew 版本可能已经过时。

• solana输入以下命令确认您已安装所需版本：

solana --version

<!--EndFragment-->