文档中心

CLI工具

安装指南

在MacOS中安装火山引擎CLI

本文介绍如何在MacOS终端中，安装火山引擎CLI工具。目前支持，npm安装和自行下载安装包文件安装。

通过npm安装

注意

请先确保当前系统中已安装npm(要求 Node.js >= 14)，可在终端中输出：npm -v查看。如未安装npm，请参考“下载安装包文件安装CLI”。

操作步骤

在终端中执行如下命令，即可完成安装。

在终端中执行如下命令，验证是否可以正常使用cli工具。

正常使用回显示例：

如需升级到最新版本，执行如下命令：

通过下载安装包文件安装

操作步骤

步骤一：获取CLI工具

您可以在火山引擎CLI工具的GitHub Release页面，下载压缩包后解压获取安装包文件或下载源码后自行编译。

方式一：下载CLI工具的安装包

访问火山引擎CLI工具的GitHub Release页面。

找到您终端的CPU架构相应的最新版压缩包。

查看CPU架构命令

直接下载或右键单击压缩包，选择“复制链接地址”。

在终端中执行如下命令，下载volcengine-cli压缩包。

本文以下载AMD架构的1.0.39版工具为例，请替换为实际下载链接。

wget https://github.com/volcengine/volcengine-cli/releases/download/v1.0.39/volcengine-cli_1.0.39_darwin_amd64.zip

执行如下命令，解压工具压缩包。

请替换压缩包名为实际包名。

unzip volcengine-cli_1.0.39_darwin_amd64.zip

解压缩包完成将获取ve文件。

方式二：编译源码获取CLI安装包

注意

编译源码需要终端已安装Go运行环境，且版本不低于1.5，推荐您使用1.12及以上版本。安装详情可查看Download and install。

访问火山引擎CLI工具的GitHub Release页面。

右键单击目标版本的Source code（zip）源码压缩包，选择“复制链接地址”。

执行如下命令下载压缩包。

本文以下载AMD架构的1.0.39版为例。

wget https://github.com/volcengine/volcengine-cli/archive/refs/tags/v1.0.39.zip

执行如下命令，解压源码包。

unzip volcengine-cli-1.0.39.zip

进入解压后的源码包目录，执行如下命令，使用工具包中的脚本编译客户端。

go env -w GOPROXY=https://goproxy.cn
sh build.sh darwin

编译完成将生成ve文件。

步骤二：配置环境变量

在终端中执行如下命令，确认$PATH系统变量是否存在/usr/local/bin。

echo $PATH

回显示例：

执行如下命令，将ve文件复制至/usr/local/bin目录下。

sudo cp ve /usr/local/bin/

在终端中执行如下命令，验证是否可以正常使用cli工具。

注意

若您的操作系统拦截了工具运行，请在”设置 > 隐私与安全 > 安全性“中，单击ve栏的”任然允许“按钮并输入密码，解除拦截。

ve -h

正常使用回显示例：

最近更新时间：2026.07.15 18:00:44

这个页面对您有帮助吗？

有用

无用