solana-cli 工具如何升级到最新版本

Louis
发布于 15小时前
阅读 72

本文修改于：2025年4月20日

本文修改于：2025 年 4 月 20 日

## 安装agave-install 工具：

要安装 agave-install 工具，以便使用它来安装或升级 Solana CLI，可以按照以下步骤操作。以下是简洁的安装指南：

### 1. 下载并运行安装脚本：

使用以下命令从 Anza 官方服务器下载并执行 agave-install 的安装脚本：bash

```
curl -sSfL https://release.anza.xyz/stable/agave-install-init.sh | sh
```

-   这会下载最新稳定版本的 agave-install 和 Solana CLI，并将其安装到默认路径（通常为 ~/.local/share/solana/install/active_release/bin）。
-   stable 表示稳定版本通道。如果需要其他版本（例如 beta 或特定版本如 v2.2.6），可以替换 stable 为所需版本号或通道，例如：

```
curl -sSfL https://release.anza.xyz/v2.2.6/agave-install-init.sh | sh
```

### 2. 添加到 PATH：

安装完成后，需要确保 agave-install 和 solana 命令在你的 PATH 中。运行以下命令：

```
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
```

为确保永久生效，将此行添加到你的 shell 配置文件（例如 ~/.bashrc 或 ~/.zshrc）：

```
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

### 3. 验证安装：

检查 agave-install 和 Solana CLI 是否正确安装：

```
agave-install --version
solana --version
```

如果命令返回版本号，说明安装成功。

注意事项

-   **系统要求**：agave-install 适用于 Linux 和 macOS。Windows 用户建议使用 WSL（Windows Subsystem for Linux）。
-   **权限问题**：如果遇到权限错误，确保你有权限写入 ~/.local/share/solana 目录，或者尝试以 sudo 运行安装命令。
-   **网络问题**：若下载脚本失败，检查网络连接或尝试使用代理，确保能访问 release.anza.xyz。

### 4. 如何升级：

要升级 agave-install 工具以及相关的 Solana CLI（Agave），

**运行更新命令**：使用 agave-install update 命令来升级到最新版本：

```
agave-install update
```

-   此命令会检查 GitHub 上最新的稳定版本（默认 stable 通道），下载并更新 agave-install 和 Solana CLI。
-   如果你需要升级到特定版本（例如 v2.2.6），可以运行：

```
agave-install init v2.2.6
```

**验证升级**：升级完成后，检查 agave-install 和 Solana CLI 的版本以确认更新成功：

```
agave-install --version
solana --version
```

## 升级 solana cli 工具

### 1. 检查当前版本

首先，检查你当前安装的 `solana-cli` 版本：

```
solana --version
```

这将显示类似以下输出：

```
solana-cli 2.1.16 (src:a5744e79; feat:3271415109, client:Agave)
```

### 2. 更新到最新版本

Solana 的 CLI 可以通过 `agave-install update` 命令直接更新到最新版本。执行以下命令：

```
agave-install update
```

-   这会自动从 GitHub 的 Anza 仓库（`https://github.com/anza-xyz/agave`）下载并安装最新的稳定版本。
-   更新完成后，你可能会需要重新加载终端环境变量，或者重启终端。

如果已经更新到了最新的版本，终端输入上述的命令会打印如下信息

```
Install is up to date. a5744e7 is the latest commit for stable
```

### 3. 验证更新

更新完成后，再次检查版本以确认是否成功升级：

```
solana --version
```

输出版本号应反映最新的稳定版本（例如 `2.1.16` 或更高版本，取决于当前最新发布）。

### 4. 指定特定版本（可选）

如果你不想安装最新版本，而是想升级到某个特定版本，可以使用以下命令：

```
agave-install init <版本号>
```

例如：

```
agave-install init v1.18.25
```

这将安装指定的版本。

### 5. 确保 PATH 配置正确

安装或更新后，确保 Solana 的二进制文件路径已正确添加到你的环境变量 `PATH` 中。通常，安装程序会自动处理，但如果 `solana` 命令无法识别，可以手动添加：

Linux/MacOS：  
编辑 `~/.bashrc` 或 `~/.zshrc`，添加：

```
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
```

然后运行：

```
source ~/.bashrc  # 或 source ~/.zshrc
```

### 6. 遇到问题时的解决方法

**命令未找到**：如果 `agave-install` 不可用，可能是因为你使用的是较旧的安装方式（例如通过 `solana-install`）。在这种情况下，可以先卸载旧版本并重新安装：

```
# 卸载旧版本
rm -rf ~/.local/share/solana/install
# 重新安装最新版本
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
```

**网络问题**：确保你的网络可以访问 `release.anza.xyz`。

本文修改于：2025 年 4 月 20 日

安装agave-install 工具：

要安装 agave-install 工具，以便使用它来安装或升级 Solana CLI，可以按照以下步骤操作。以下是简洁的安装指南：

1. 下载并运行安装脚本：

使用以下命令从 Anza 官方服务器下载并执行 agave-install 的安装脚本：bash

curl -sSfL https://release.anza.xyz/stable/agave-install-init.sh | sh

这会下载最新稳定版本的 agave-install 和 Solana CLI，并将其安装到默认路径（通常为 ~/.local/share/solana/install/active_release/bin）。
stable 表示稳定版本通道。如果需要其他版本（例如 beta 或特定版本如 v2.2.6），可以替换 stable 为所需版本号或通道，例如：

curl -sSfL https://release.anza.xyz/v2.2.6/agave-install-init.sh | sh

2. 添加到 PATH：

安装完成后，需要确保 agave-install 和 solana 命令在你的 PATH 中。运行以下命令：

export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"

为确保永久生效，将此行添加到你的 shell 配置文件（例如 ~/.bashrc 或 ~/.zshrc）：

echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

3. 验证安装：

检查 agave-install 和 Solana CLI 是否正确安装：

agave-install --version
solana --version

如果命令返回版本号，说明安装成功。

注意事项

系统要求：agave-install 适用于 Linux 和 macOS。Windows 用户建议使用 WSL（Windows Subsystem for Linux）。
权限问题：如果遇到权限错误，确保你有权限写入 ~/.local/share/solana 目录，或者尝试以 sudo 运行安装命令。
网络问题：若下载脚本失败，检查网络连接或尝试使用代理，确保能访问 release.anza.xyz。

4. 如何升级：

要升级 agave-install 工具以及相关的 Solana CLI（Agave），

运行更新命令：使用 agave-install update 命令来升级到最新版本：

agave-install update

此命令会检查 GitHub 上最新的稳定版本（默认 stable 通道），下载并更新 agave-install 和 Solana CLI。
如果你需要升级到特定版本（例如 v2.2.6），可以运行：

agave-install init v2.2.6

验证升级：升级完成后，检查 agave-install 和 Solana CLI 的版本以确认更新成功：

agave-install --version
solana --version

升级 solana cli 工具

1. 检查当前版本

首先，检查你当前安装的 solana-cli 版本：

solana --version

这将显示类似以下输出：

solana-cli 2.1.16 (src:a5744e79; feat:3271415109, client:Agave)

2. 更新到最新版本

Solana 的 CLI 可以通过 agave-install update 命令直接更新到最新版本。执行以下命令：

agave-install update

这会自动从 GitHub 的 Anza 仓库（https://github.com/anza-xyz/agave）下载并安装最新的稳定版本。
更新完成后，你可能会需要重新加载终端环境变量，或者重启终端。

如果已经更新到了最新的版本，终端输入上述的命令会打印如下信息

Install is up to date. a5744e7 is the latest commit for stable

3. 验证更新

更新完成后，再次检查版本以确认是否成功升级：

solana --version

输出版本号应反映最新的稳定版本（例如 2.1.16 或更高版本，取决于当前最新发布）。

4. 指定特定版本（可选）

如果你不想安装最新版本，而是想升级到某个特定版本，可以使用以下命令：

agave-install init &lt;版本号>

例如：

agave-install init v1.18.25

这将安装指定的版本。

5. 确保 PATH 配置正确

安装或更新后，确保 Solana 的二进制文件路径已正确添加到你的环境变量 PATH 中。通常，安装程序会自动处理，但如果 solana 命令无法识别，可以手动添加：

Linux/MacOS：
编辑 ~/.bashrc 或 ~/.zshrc，添加：

export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"

然后运行：

source ~/.bashrc  # 或 source ~/.zshrc

6. 遇到问题时的解决方法

命令未找到：如果 agave-install 不可用，可能是因为你使用的是较旧的安装方式（例如通过 solana-install）。在这种情况下，可以先卸载旧版本并重新安装：

# 卸载旧版本
rm -rf ~/.local/share/solana/install
# 重新安装最新版本
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

网络问题：确保你的网络可以访问 release.anza.xyz。

原创
学分: 0
分类: Solana
标签: Solana CLI

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