对象存储下载与安装配置-工具指南-文档中心-腾讯云

COSCLI 工具提供 Windows、Mac、Linux 操作系统的二进制包，通过简单的安装和配置后即可使用。
步骤一：下载 COSCLI 工具
您可以根据业务场景选择下载 COSCLI 工具的地址。如果您的服务器在国内，推荐使用国内站点下载地址。
国内站点下载地址
Github下载地址（国外站点使用）
SHA256校验
﻿Windows-386﻿
﻿Windows-386﻿
6ee8cae7ea86547d7a5acf57f8d919210f076a785c482aafa90f7099ef61d65a
﻿Windows-amd64﻿
﻿Windows-amd64﻿
6ac7d595fdcc2e1c8ccaf7b5b227fb3a472cfbde76f95856cd9e95249eff75a5
﻿Mac-amd64﻿
﻿Mac-amd64﻿
87796d1b67b3c7e890762a3bf2cec1338699a8cba6da88d1616a44e323c58925
﻿Mac-arm64﻿
﻿Mac-arm64﻿
8fe85a00260cd2ba920d6b50e62e38079d16eb3553c404191afd09a5e6587d9b
﻿Linux-386﻿
﻿Linux-386﻿
5890c250f1c9a22829d7916d7ba29b1c232722fcb20bb51128ae30f8c2c6c478
﻿Linux-amd64﻿
﻿Linux-amd64﻿
0651ec2678cf6f58d80c35656ca60447d9180d09b2c343827506a6a741fa9554
﻿Linux-arm﻿
﻿Linux-arm﻿
b367d11f8068ef699a0932b36237028058f278d7f249494d646dc443d1bec2a3
﻿Linux-arm64﻿
﻿Linux-arm64﻿
7efebfe68836a090c26b0afdf319bdf5c04c834461867b4013806a911404ffad
您也可以通过命令行，获取国内站点 Mac 和 Linux 环境下的 COSCLI 工具文件：
Mac-amd64：wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-darwin-amd64
Mac-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.2，如需获取工具的最新版本、历史版本和更新日志，请前往 release 进行查看。
步骤二：安装 COSCLI 工具
Windows
1. 将已下载的 Windows 版本 COSCLI 工具，移动至 C:\\Users\\<用户名> 目录下。
2. 将 coscli-windows-amd64.exe 重命名为 coscli.exe。
3. 按 win+r 键打开 运行 程序。
4. 在对话框中，输入 cmd，按 Enter 打开命令行窗口。
5. 在命令行窗口中，输入 coscli --version，若打印出以下信息则代表安装成功：
说明：
在 Windows 系统下，在不同的命令行客户端中使用 COSCLI 的方式可能略有不同，若输入 coscli [command] 后 COSCLI 无法正常工作，请尝试 ./coscli [command] 的格式。
coscli version v1.0.2
Mac
1. 运行以下命令，重命名 Mac 版本 COSCLI 文件：
mv coscli-darwin-amd64 coscli
2. 运行以下命令修改文件执行权限：
chmod 755 coscli
3. 在命令行中输入 ./coscli --version，若打印出以下信息则代表安装成功：
coscli version v1.0.2
说明：
在 Mac 系统下使用 COSCLI 时，若弹出 无法打开 “coscli”，因为无法验证开发者 的提示，可以前往 设置 > 安全性与隐私 > 通用 中选择 仍要打开 coscli，之后即可正常使用 COSCLI。
Linux
1. 运行以下命令，重命名 Linux 版本 COSCLI 文件：
mv coscli-linux-amd64 coscli
2. 运行以下命令修改文件执行权限：
chmod 755 coscli
3. 在命令行窗口中输入 ./coscli --version，若打印出以下信息则代表安装成功：
coscli version v1.0.2
步骤三：配置 COSCLI 工具
注意：
建议用户通过 临时密钥 使用工具，通过临时授权的方式进一步提高工具使用的安全性。申请临时密钥时，请遵循 最小权限指引原则，防止泄露目标存储桶或对象之外的资源。
如果您一定要使用永久密钥，建议遵循 最小权限指引原则 对永久密钥的权限范围进行限制。
首次使用 COSCLI 时，用户需要初始化配置文件。配置文件包含以下两部分内容：
1. 授权 COSCLI 访问您的腾讯云账号，需要您配置密钥 ID、密钥 Key、临时密钥 Token。
2. 为常用桶添加别名，需要您配置常用桶名称、桶所在地域信息、桶别名。配置常用桶信息后，用户可以使用别名进行桶操作，无需再填写桶名称和地域信息。添加多个常用桶配置后，还可以更便捷的进行跨桶或跨域的操作。如果无需配置常用桶信息，可以按 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
设置身份模式，支持枚举值 SecretKey 和 CvmRole。可以为空，空值默认为SecretKey，表示使用密钥请求 COS。当Mode 为CvmRole时，表示是用 管理实例角色 请求 COS。
Cvm Role Name
设置 CVM 角色实例名称，详情参考 管理实例角色。
protocol
网络传输协议，默认为 https。如需更改为 http，可直接进入配置文件进行修改即可。
APPID
APPID 是您在成功申请腾讯云账户后所得到的账号，由系统自动分配，可从 账号信息 中获取。一个存储桶的全称由 Bucket Name 和 APPID 这两个元素组成，格式为 <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，则不进行备份域名切换。
在初次配置时，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 均为加密后的字符串。
﻿

国内站点下载地址	Github下载地址（国外站点使用）	SHA256校验
Windows-386	Windows-386	6ee8cae7ea86547d7a5acf57f8d919210f076a785c482aafa90f7099ef61d65a
Windows-amd64	Windows-amd64	6ac7d595fdcc2e1c8ccaf7b5b227fb3a472cfbde76f95856cd9e95249eff75a5
Mac-amd64	Mac-amd64	87796d1b67b3c7e890762a3bf2cec1338699a8cba6da88d1616a44e323c58925
Mac-arm64	Mac-arm64	8fe85a00260cd2ba920d6b50e62e38079d16eb3553c404191afd09a5e6587d9b
Linux-386	Linux-386	5890c250f1c9a22829d7916d7ba29b1c232722fcb20bb51128ae30f8c2c6c478
Linux-amd64	Linux-amd64	0651ec2678cf6f58d80c35656ca60447d9180d09b2c343827506a6a741fa9554
Linux-arm	Linux-arm	b367d11f8068ef699a0932b36237028058f278d7f249494d646dc443d1bec2a3
Linux-arm64	Linux-arm64	7efebfe68836a090c26b0afdf319bdf5c04c834461867b4013806a911404ffad

配置项	说明
Secret ID	密钥 ID，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见子账号访问密钥管理。
Secret Key	密钥 Key，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见子账号访问密钥管理。
Session Token	临时密钥 token，当使用临时密钥时需要配置，若不使用可以直接按 `Enter` 跳过。关于临时密钥的更多信息，详见使用临时密钥访问 COS。
Mode	设置身份模式，支持枚举值 `SecretKey` 和 `CvmRole`。可以为空，空值默认为`SecretKey`，表示使用密钥请求 COS。当Mode 为`CvmRole`时，表示是用管理实例角色请求 COS。
Cvm Role Name	设置 CVM 角色实例名称，详情参考管理实例角色。
protocol	网络传输协议，默认为 https。如需更改为 http，可直接进入配置文件进行修改即可。
APPID	APPID 是您在成功申请腾讯云账户后所得到的账号，由系统自动分配，可从账号信息中获取。一个存储桶的全称由 `Bucket Name` 和 `APPID` 这两个元素组成，格式为 `<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，则不进行备份域名切换。

下载与安装配置

本页目录：

步骤一：下载 COSCLI 工具

步骤二：安装 COSCLI 工具

Windows

Mac

Linux

步骤三：配置 COSCLI 工具

其他配置方法