下载与安装配置

最近更新时间:2025-04-24 15:48:22

我的收藏
COSCLI 工具提供 Windows、MacOS、Linux 操作系统的二进制包,通过简单的安装和配置后即可使用。

步骤一:下载 COSCLI 工具

您可以根据业务场景选择下载 COSCLI 工具的地址。如果您的服务器在国内,推荐使用国内站点下载地址(此处链接的工具版本均为最新版本,如需使用旧版本,可访问 release 获取历史版本)。
国内站点下载地址
Github 下载地址(国外站点使用)
SHA256校验
8d415550d4625e0df0b39164326cedd5512d3271c11bebea0dcf9cfc01f6fe46
a81488cecae7767904e2a111cd8f6d2def0f95f8aba04bb7bcef47b1327bc210
c9c4bb2a021423e3a3ee014c99c8287d484d9a55451f7f75c87d3aaa9417e80f
9253e043985b51219112400a37b39e618ab5c358cf5777193829aa7b9d9ff5f6
Linux-386
Linux-386
e25a856141140c0da262509fa146a424d19f23830cbd4d92e231f7e38d07d8e7
8a137821c9869d9c07be84e8c2ed69177d9029c1c504e04662e048631112553c
Linux-arm
Linux-arm
07c03d5fc78ef5c714e0e154b8a79fc5850382527e03d7e60b46b26cf9478d59
34b4d1a82dc5aa23d80c808289d97a03bf101b31871c0a53100de2af2fd25b0e
您也可以通过命令行,获取国内站点 MacOS 和 Linux 环境下的 COSCLI 工具文件:
MacOS-amd64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-amd64
MacOS-arm64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-arm64
Linux-386:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-386
Linux-amd64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-amd64
Linux-arm:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm
Linux-arm64:wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-arm64
说明:
Github 上当前版本号为 v1.0.6,如需获取工具的最新版本、历史版本和更新日志,请前往 release 进行查看。

步骤二:安装 COSCLI 工具

Windows

1. windows-amd64版本为例,将已下载的 Windows 版本 COSCLI 工具,移动至 C:\\Users\\<用户名> 目录下。
2. coscli-windows-amd64.exe 重命名为 coscli.exe
3. win+r 键打开 运行 程序。
4. 在对话框中,输入 cmd,按 Enter 打开命令行窗口。
5. 在命令行窗口中,输入以下命令。
coscli --version
若输出 coscli version v1.0.6,则安装成功。
说明:
Windows 系统下,在不同的命令行客户端中使用 COSCLI 的方式可能略有不同,若输入 coscli [command] 后 COSCLI 无法正常工作,请尝试 ./coscli [command] 的格式。

MacOS

1. MacOS-amd64版本为例,运行以下命令,重命名 MacOS 版本 COSCLI 文件。
mv coscli-darwin-amd64 coscli
2. 运行以下命令修改文件执行权限。
chmod 755 coscli
3. 在命令行中输入以下命令。
./coscli --version
若输出 coscli version v1.0.6,则安装成功。
说明:
在 MacOS 系统下使用 COSCLI 时,若弹出无法打开 “coscli”,因为无法验证开发者的提示,可以前往设置 > 安全性与隐私 > 通用中选择仍要打开 coscli,之后即可正常使用 COSCLI。

Linux

1. Linux-amd64版本为例,运行以下命令,重命名 Linux 版本 COSCLI 文件。
mv coscli-linux-amd64 coscli
2. 运行以下命令修改文件执行权限。
chmod 755 coscli
3. 在命令行窗口中输入以下命令。
./coscli --version
若输出 coscli version v1.0.6,则安装成功。

步骤三:配置 COSCLI 工具

注意:
建议用户通过 临时密钥 使用工具,通过临时授权的方式进一步提高工具使用的安全性。申请临时密钥时,请遵循 最小权限指引原则,防止泄露目标存储桶或对象之外的资源。
如果您一定要使用永久密钥,建议遵循 最小权限指引原则 对永久密钥的权限范围进行限制。
首次使用 COSCLI 时,用户需要初始化配置文件。配置文件包含以下两部分内容:
授权 COSCLI 访问您的腾讯云账号,需要您配置密钥 ID、密钥 Key、临时密钥 Token。
为常用桶添加别名,需要您配置常用桶名称、桶所在地域信息、桶别名。配置常用桶信息后,用户可以使用别名进行桶操作,无需再填写桶名称和地域信息。添加多个常用桶配置后,还可以更便捷的进行跨桶或跨域的操作。如果无需配置常用桶信息,可以按 Enter 跳过。
初次使用时,COSCLI 会自动调用./coscli config init~/.cos.yaml 位置生成配置文件,您可以在命令行交互式的完成配置。后续您也可以使用./coscli config init 命令在其他位置为 COSCLI 交互式地生成配置文件。您可以使用./coscli config show 来查看配置文件的所在位置和配置参数信息。
配置文件中各配置项的说明如下:
配置项
说明
Secret ID
密钥 ID,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取请参见 子账号访问密钥管理
Secret Key
密钥 Key,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取请参见 子账号访问密钥管理
Session Token
临时密钥 token,当使用临时密钥时需要配置,若不使用可以直接按 Enter 跳过。 关于临时密钥的更多信息,请参见 使用临时密钥访问 COS
Mode
设置身份模式,支持枚举值 SecretKeyCvmRole。可以为空,空值默认为SecretKey,表示使用密钥请求 COS。当Mode 为 CvmRole 时,表示是用 管理实例角色 请求 COS。
Cvm Role Name
设置 CVM 角色实例名称,详情请参见 管理实例角色
protocol
网络传输协议,默认为 https。如需更改为 http,可直接进入配置文件进行修改即可。
APPID
APPID 是您在成功申请腾讯云账户后所得到的账号,由系统自动分配,可从 账号信息 中获取。一个存储桶的全称由 Bucket NameAPPID 这两个元素组成,格式为 <BucketName-APPID>,详情请参见 存储桶命名规范
Bucket Name
存储桶名称,和 APPID 一起构成存储桶全称,格式为 <BucketName-APPID>,详情请参见 存储桶命名规范
Bucket Endpoint
存储桶所在地域的域名,默认域名格式为 cos.<region>.myqcloud.com,其中 <region> 代表存储桶地域,例如 ap-guangzhou、ap-beijing 等,COS 支持的地域列表请参见 地域与访问域名
如果存储桶开启了全球加速,可配置全球加速域名。例如,全球加速域名配置为cos.accelerate.myqcloud.com;内网全球加速域名配置为cos-internal.accelerate.tencentcos.cn
Bucket Alias
存储桶别名,配置后可以在使用时用 BucketAlias 代替 BucketName-APPID,减少所需输入的命令长度,如果不配置此项,BucketAlias 的值是 BucketName-APPID 的值。
OFS Bucket
元数据加速桶标记,用于标识该桶是否开启 元数据加速 功能。
Auto Switch Host
设置是否关闭自动切换备份域名。可选值 true | false,可以为空。
若不设置或值为 false,则会进行备份域名切换。
若设置为 true,则不进行备份域名切换。
Disable Encryption
设置是否关闭秘钥加密。可选值 true | false,可以为空。
若不设置或值为 false ,则会加密配置文件中的秘钥相关信息。
若设置为 true,则不加密配置文件中的秘钥相关信息。
在初次配置时,COSCLI 只会要求您配置一个存储桶的信息,如果您希望配置多个存储桶,您后续可以使用./coscli config add 命令添加存储桶配置。如您需要修改配置文件,或获取更多有关配置文件的操作,请参见 config 命令 或使用./coscli config --help 命令来快速查看和配置文件相关的指令。
在正式开始使用指令之前,您可以使用./coscli --help 命令来快速查看 COSCLI 的使用方法。

其他配置方法

除了使用./coscli config init 交互式地生成配置文件外,您也可以直接手动编写 COSCLI 的配置文件。COSCLI 的配置文件格式是 yaml 格式,配置文件示例如下:
cos:
base:
secretid: XXXXXXXXXXXXXXX
secretkey: XXXXXXXXXXXXXXXXX
sessiontoken: ""
protocol: https
buckets:
- name: examplebucket1-1250000000
alias: bucket1
region: ap-shanghai
endpoint: cos.ap-shanghai.myqcloud.com
ofs: false
- name: examplebucket2-1250000000
alias: bucket2
region: ap-guangzhou
endpoint: cos.ap-guangzhou.myqcloud.com
ofs: false
- name: examplebucket3-1250000000
alias: bucket3
region: ap-chengdu
endpoint: cos.ap-chengdu.myqcloud.com
ofs: false
注意:
COSCLI 默认从 ~/.cos.yaml 处读取配置项,若用户想要使用自定义的配置文件,请在命令后使用 -c (--config-path)选项。配置文件存储的 secretid/secretkey/sessiontoken 均为加密后的字符串。