KooCLI 常用命令实战：从安装配置到云资源日常运维

日常运维里，控制台点来点去效率低，还容易误操作。华为云命令行工具 KooCLI（可执行文件 hcloud）把 ECS、VPC、EVS、OBS、IAM 等服务的 API 封装成一条条命令，写进脚本就能批量执行。本文结合真实使用场景，梳理从安装配置到日常巡检、启停、批量查询的常用命令。

一、安装与配置

1. 安装

从华为云官网下载对应操作系统的 KooCLI 安装包，解压后把 hcloud 加入 PATH，验证版本：

hcloud version

2. 初始化配置

首次使用执行交互式配置，按提示填入 Access Key、Secret Key、区域（Region）和项目（Project）：

hcloud configure

也可以用一条命令直接写入配置，适合写进自动化脚本。注意：不要把密钥提交到代码仓库。

hcloud configure set --cli-access-key=AKXXXXXXXX --cli-secret-key=SKXXXXXXXX --cli-region=cn-north-4 --cli-project=cn-north-4

查看当前配置：

hcloud configure list

3. 用环境变量临时切换

临时切换账号或区域时，不用改配置文件，用环境变量覆盖即可：

export HUAWEICLOUD_SDK_AK=AKXXXXXXXX
export HUAWEICLOUD_SDK_SK=SKXXXXXXXX
export HUAWEICLOUD_SDK_REGION=cn-north-4
export HUAWEICLOUD_SDK_PROJECT=cn-north-4

二、命令通用结构

KooCLI 的命令格式固定为：

hcloud <服务缩写> <操作> --参数名=参数值

服务缩写如 ECS、VPC、EVS、EIP、OBS；操作名与 API 操作名对应，如 ListServers、ShowServer。两个通用参数最常用：–cli-output=json 输出 JSON，方便 jq 解析；–cli-query 用 JMESPath 表达式过滤输出字段。

查看帮助：

hcloud --help
hcloud ECS --help
hcloud ECS ListServers --help

三、ECS 日常运维实战

1. 查询云服务器列表

hcloud ECS ListServers --limit 10

只看名称和状态两列：

hcloud ECS ListServers --cli-query="servers[*].[name,status]" --cli-output table

2. 查看单台服务器详情

hcloud ECS ShowServer --server_id=你的服务器ID

3. 开机、关机与重启

hcloud ECS StartServer --server_id=你的服务器ID
hcloud ECS StopServer --server_id=你的服务器ID
hcloud ECS RebootServer --server_id=你的服务器ID --reboot.type=SOFT

4. 批量巡检脚本

把巡检写成 Shell 脚本，每天定时跑一遍，输出每台服务器的名称、状态和 IP：

#!/bin/bash
# daily-check.sh：批量巡检 ECS
set -e
hcloud ECS ListServers --limit 100 --cli-query="servers[*].{名称:name,状态:status}" --cli-output table
echo "巡检完成：$(date '+%Y-%m-%d %H:%M:%S')"

执行：

chmod +x daily-check.sh
./daily-check.sh

四、网络与存储常用命令

查看 VPC 列表：

hcloud VPC ListVpcs --limit 10

查看云硬盘列表：

hcloud EVS ListVolumes --limit 10

查看弹性公网 IP：

hcloud EIP ListPublicips --limit 10

五、OBS 对象存储实战

列出桶：

hcloud OBS ListBuckets

上传文件到桶：

hcloud OBS PutObject --bucket=你的桶名 --key=backup/config.yaml --body=/本地路径/config.yaml

六、使用心得

1. 密钥安全：AK/SK 只保存在本地配置文件或环境变量里，绝不写进公开脚本和代码仓库，定期轮换。
2. 先查后改：执行启停、删除类操作前，先用查询命令确认目标资源 ID，避免误操作。
3. 输出格式化：配合 --cli-query 和 --cli-output table，查询结果直接可读；配合 jq 可以做更复杂的加工。
4. 脚本化：把高频操作沉淀为脚本，配合 cron 定时执行，巡检、备份这类重复工作就不用每天手动做了。

结语

KooCLI 的学习成本很低：记住“服务 + 操作 + 参数”的结构，其余都靠 --help 现查。把控制台上的重复操作换成命令和脚本，是云上运维提效最直接的一步。