用KooCLI命令行管理 OBS 桶

一、为什么要用命令行管 OBS

一开始的时候也都是控制台点，后来要批量传一堆文件、或者服务器上自动备份，点来点去太累了。华为云有个命令行工具叫 KooCLI，里面直接集成了 OBS 的管理命令，装好之后敲命令就能管桶和对象。

这篇就当个速查笔记，把最常用的几条列出来，省得每次还得翻文档。

二、准备工作

提醒：AK/SK 相当于你账号的钥匙，博客和脚本里都别直接写明文，用占位符或者读环境变量就行，下面我都用 YOUR_AK 这种代替。

三、操作步骤

3.1 装好 KooCLI 并验证

# 一键安装（Linux/macOS，Windows 用安装包或 WSL）
curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh -y

# 看版本
hcloud version

能打印出版本号就说明装好了。

3.2 初始化 OBS 对接信息

第一次用要先告诉 KooCLI 你的密钥和 OBS 的接入地址：

hcloud obs config -i=YOUR_AK -k=YOUR_SK -e=obs.cn-north-4.myhuaweicloud.com

配完顺手测一下连通性：

hcloud obs ls -s

回显里出现 Bucket number : 就说明配置 OK；要是 403 多半是 AK/SK 不对，要是连接失败就查网络。

3.3 建桶和列桶

# 创建一个新桶（桶名全局唯一）
hcloud obs mb obs://my-blog-bucket

# 列出账号下所有桶
hcloud obs ls -s

3.4 上传文件（带公共读）

做静态站的话，上传时直接把 ACL 设成公共读最省事：

# 上传单个文件并设为公共读
hcloud obs cp ./index.html obs://my-blog-bucket/index.html -acl=public-read

# 上传整个文件夹
hcloud obs cp ./dist obs://my-blog-bucket/dist -r -acl=public-read

3.5 下载和删对象

# 下载某个对象
hcloud obs cp obs://my-blog-bucket/index.html ./index.html

# 删除对象
hcloud obs rm obs://my-blog-bucket/index.html

3.6 改桶的访问权限

已经建好的桶想改公共读/私有，用 chattri：

hcloud obs chattri obs://my-blog-bucket -acl=public-read

四、小结

KooCLI 这套 hcloud obs 命令基本把日常 OBS 操作都覆盖了：建桶、传文件、下载、改权限，而且参数风格和 obsutil 一致，记一条就能用一片。配合脚本，服务器上的自动备份、批量同步都能直接写成 shell 跑。

唯一要注意的就是 AK/SK 别泄露，我一般是在服务器上配好 hcloud obs config 之后就不再把密钥写进任何脚本里了。