安装天翼云 CLI

本文面向第一次使用天翼云 CLI 的用户，介绍两种安装方式：

1. 一键部署：推荐方式，脚本自动识别操作系统和 CPU 架构。
2. 下载 setup 包自行安装：适合不能直接执行远程安装脚本，或需要离线分发的场景。

安装完成后，用户调用的命令统一为：

ctyun-cli

Windows 下实际文件名是 ctyun-cli.exe，但在 PowerShell 中仍然执行 ctyun-cli。

1. 安装前准备

a. 支持的平台

macOS / Linux 可以通过下面的命令查看系统和架构：

uname -s
uname -m

常见结果：

• Darwin 表示 macOS，Linux 表示 Linux。

• x86_64 或 amd64 表示 x86 64 位。

• arm64 或 aarch64 表示 ARM64。

Windows PowerShell 可以执行：

$env:PROCESSOR_ARCHITECTURE

返回 AMD64 或 ARM64 均可安装。

b. 网络和命令要求

• macOS / Linux 需要能够使用 curl。

• Windows 建议使用 PowerShell 5.1 或更高版本。

• 当前用户需要能够写入自己的用户目录。

• 安装到默认目录不需要 sudo 或管理员权限。

2. 选择平台安装

根据你的操作系统，选择对应的安装指南：

• Windows 安装

• Linux 安装

• macOS 安装

3. 验证安装结果

无论使用哪种操作系统，安装后都应执行：

ctyun-cli version
ctyun-cli --help

看到版本号和产品命令列表，表示二进制文件已经能够正常运行。

也可以直接使用完整路径验证，用来区分"文件没有安装"和"PATH 没有生效"：

macOS / Linux：

"$HOME/.ctyun-cli/bin/ctyun-cli" version

Windows PowerShell：

& "$HOME\.ctyun-cli\bin\ctyun-cli.exe" version

验证通过后，请继续阅读配置 CLI 完成 AK/SK 认证配置， 然后参考命令格式与参数执行云资源操作。