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

注意

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

## 操作步骤在终端中执行如下命令，即可完成安装。 ```Bash npm install -g @volcengine/cli@latest ``` 在终端中执行如下命令，验证是否可以正常使用cli工具。 ```Bash ve -h ``` 正常使用回显示例： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_feda172af7ed07bd677082ac83cfea13.png) # 通过下载安装包文件安装 ## 操作步骤 ### 步骤一：获取CLI工具您可以在火山引擎CLI工具的[GitHub Release](https://github.com/volcengine/volcengine-cli/releases)页面，下载压缩包后解压获取安装包文件或下载源码后自行编译。 **方式一：下载CLI工具的安装包** 1. 访问火山引擎CLI工具的[GitHub Release](https://github.com/volcengine/volcengine-cli/releases)页面。 2. 找到您终端的CPU架构相应的最新版压缩包。 > 查看CPU架构命令 ```Bash uname -m ``` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_60e548a4c9042e3f58f407436074af86.png) 3. 直接下载或右键单击压缩包，选择“复制链接地址”。 4. 在终端中执行如下命令，下载volcengine\-cli压缩包。 > 本文以下载AMD架构的1.0.39版工具为例，请替换为实际下载链接。 ```Plain Text wget https://github.com/volcengine/volcengine-cli/releases/download/v1.0.39/volcengine-cli_1.0.39_darwin_amd64.zip ``` 5. 执行如下命令，解压工具压缩包。 > 请替换压缩包名为实际包名。 ```Plain Text unzip volcengine-cli_1.0.39_darwin_amd64.zip ``` 6. 解压缩包完成将获取ve文件。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8cb96999a44843059464572f2dc565e6.png) **方式二：编译源码获取CLI安装包**

注意

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

1. 访问火山引擎CLI工具的[GitHub Release](https://github.com/volcengine/volcengine-cli/releases)页面。 2. 右键单击目标版本的Source code（zip）源码压缩包，选择“复制链接地址”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1cf0cce941b9356bc45c98a6b6ab4446.png) 3. 执行如下命令下载压缩包。 > 本文以下载AMD架构的1.0.39版为例。 ```Plain Text wget https://github.com/volcengine/volcengine-cli/archive/refs/tags/v1.0.39.zip ``` 4. 执行如下命令，解压源码包。 ```Plain Text unzip volcengine-cli-1.0.39.zip ``` 5. 进入解压后的源码包目录，执行如下命令，使用工具包中的脚本编译客户端。 ```Plain Text go env -w GOPROXY=https://goproxy.cn sh build.sh darwin ``` 6. 编译完成将生成ve文件。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_aa8a25b6a2a30c908d5cb500228844a9.png) ### 步骤二：配置环境变量 1. 在终端中执行如下命令，确认`$PATH`系统变量是否存在`/usr/local/bin`。 ```Plain Text echo $PATH ``` 回显示例： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2ed4de16df937eae4beae05d017f18f4.png) 2. 进入“步骤一”获取的ve文件所在目录。 3. 执行如下命令，将ve文件复制至/usr/local/bin目录下。 ```Bash sudo cp ve /usr/local/bin/ ``` 4. 在终端中执行如下命令，验证是否可以正常使用cli工具。

注意

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

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_da8c87dd5b6ae67e16d795aa73ef992c.jpg) ```Bash ve -h ``` 正常使用回显示例： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_feda172af7ed07bd677082ac83cfea13.png)