动态与公告

产品动态

产品公告

产品简介

产品概述

功能概览

应用场景

产品优势

基本概念

地域和访问域名

规格与限制

产品计费

计费概述

计费方式

计费项

免费额度

计费示例

查看和下载账单

欠费说明

常见问题

快速入门

控制台快速入门

COSBrowser 快速入门

用户指南

创建请求

存储桶

对象

数据管理

批量处理

全球加速

监控与告警

运维中心

数据处理

内容审核

智能工具箱

数据工作流

应用集成

工具指南

工具概览

环境安装与配置

COSBrowser 工具

COSCLI 工具

COSCMD 工具

COS Migration 工具

FTP Server 工具

Hadoop 工具

COSDistCp 工具

HDFS TO COS 工具

GooseFS-Lite 工具

在线辅助工具

自助诊断工具

实践教程

概览

访问控制与权限管理

性能优化

使用 AWS S3 SDK 访问 COS

数据容灾备份

域名管理实践

图片处理实践

COS 音视频播放器实践

工作流实践

数据直传

内容审核实践

数据安全

数据校验

大数据实践

COS 成本优化解决方案

在第三方应用中使用 COS

迁移指南

本地数据迁移至 COS

第三方云存储数据迁移至 COS

以 URL 作为源地址的数据迁移至 COS

COS 之间数据迁移

Hadoop 文件系统与 COS 之间的数据迁移

数据湖存储

云原生数据湖

元数据加速

数据加速器 GooseFS

数据处理

数据处理概述

图片处理

媒体处理

内容审核

文件处理

文档处理

故障处理

获取 RequestId 操作指引

通过外网上传文件至 COS 缓慢

访问 COS 时返回403错误码

资源访问异常

POST Object 常见异常

API 文档

简介

公共请求头部

公共响应头部

错误码

请求签名

操作列表

Service 接口

Bucket 接口

Object 接口

批量处理接口

数据处理接口

任务与工作流

内容审核接口

云查毒接口

SDK 文档

SDK 概览

准备工作

Android SDK

C SDK

C++ SDK

.NET(C#) SDK

Flutter SDK

Go SDK

iOS SDK

Java SDK

JavaScript SDK

Node.js SDK

PHP SDK

Python SDK

React Native SDK

小程序 SDK

错误码

鸿蒙(Harmony) SDK

终端 SDK 质量优化

安全与合规

数据容灾

数据安全

访问管理

常见问题

热门问题

一般性问题

计费计量问题

域名合规问题

存储桶配置问题

域名和 CDN 问题

文件操作问题

日志监控问题

权限管理问题

数据处理问题

数据安全问题

预签名 URL 问题

SDK 类问题

工具类问题

API 类问题

服务协议

Service Level Agreement

隐私政策

数据处理和安全协议

联系我们

词汇表

下载与安装配置

PDF

聚焦模式

字号

最后更新时间： 2026-02-12 17:52:22

COSCLI 工具提供 Windows、macOS、Linux 操作系统的二进制包，通过简单的安装和配置后即可使用。
步骤一：下载 COSCLI 工具
您可以根据业务场景选择下载 COSCLI 工具的地址。如果您的服务器在中国，推荐使用中国站点下载地址（此处链接的工具版本均为最新版本，如需使用旧版本，可访问 release 获取历史版本）。
中国站点下载地址
GitHub 下载地址（推荐海外用户使用）
SHA256校验
﻿Windows-386﻿
﻿Windows-386﻿
96e3c2aa2706f2c580f30093d1bf9f468046fd2cf498596f373f8e2707f0dea1
﻿Windows-amd64﻿
﻿Windows-amd64﻿
74f3b5ebbe89be2c013f9d3b2d8968691372801f2671bb31548eab4476fe9179
﻿macOS-amd64﻿
﻿macOS-amd64﻿
432ee022dcfdaec5a77e113386e7bcaa340680ea4c959147a3afb840c664aef9
﻿macOS-arm64﻿
﻿macOS-arm64﻿
df0018fbf78b552cbe875ebe26e8bdf7938c7f4394959f913dfc2ea4d1252568
﻿Linux-386﻿
﻿Linux-386﻿
a58e220bdc14781522b0c9eab76b02e5124b19f57554771a9e7ab204583c89ab
﻿Linux-amd64﻿
﻿Linux-amd64﻿
7165f2ae16c5f7ac495864c963ca574a76e04ec72680d7bc8a8eee3234d8cf91
﻿Linux-arm﻿
﻿Linux-arm﻿
5c5f6b70be061c7c30777dbc67271b2664036fbb56aaf6774c55ccc7f03194ed
﻿Linux-arm64﻿
﻿Linux-arm64﻿
0404b4da5b1d0c230c7d7522cb3bbec2909e314ab998889a0aeb8dc6094a2d21
您也可以通过命令行，获取中国站点 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.8，如需获取工具的最新版本、历史版本和更新日志，请前往 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.8，则安装成功。
说明：
在 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.8，则安装成功。
说明：
在 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.8，则安装成功。
步骤三：配置 COSCLI 工具
注意：
建议用户通过 临时密钥 使用工具，通过临时授权的方式进一步提高工具使用的安全性。申请临时密钥时，请遵循 最小权限指引原则，防止泄露目标存储桶或对象之外的资源。
如果您一定要使用永久密钥，建议遵循 最小权限指引原则 对永久密钥的权限范围进行限制。
首次使用 COSCLI 时，用户需要初始化配置文件。配置文件包含以下两部分内容：
授权 COSCLI 访问您的腾讯云账号，需要您配置密钥 ID、密钥 Key、临时密钥 Token。
为常用桶添加别名，需要您配置常用桶名称、桶所在地域信息、桶别名。配置常用桶信息后，用户可以使用别名进行桶操作，无需再填写桶名称和地域信息。添加多个常用桶配置后，还可以更便捷的进行跨桶或跨域的操作。如果无需配置常用桶信息，可以按 Enter 跳过。
以 Linux 系统为例，初次使用时，COSCLI 会自动调用./coscli config init 在~/.cos.yaml 位置生成配置文件，您可以在命令行交互式的完成配置。后续您也可以使用./coscli config init 命令在其他位置为 COSCLI 交互式地生成配置文件。您可以使用./coscli config show 来查看配置文件的所在位置和配置参数信息。
配置文件中各配置项的说明如下：
配置项
是否必填
说明
Secret ID
是
密钥 ID，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取请参见 子账号访问密钥管理。
注意：
通过初始化或命令配置的 Secret ID 会加密存储，如需手动修改配置文件，需设置 Disable Encryption 参数关闭密钥加密。
Secret Key
是
密钥 Key，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取请参见 子账号访问密钥管理。
注意：
通过初始化或命令配置的 Secret Key 会加密存储，如需手动修改配置文件，需设置  Disable Encryption 参数关闭密钥加密。
Session Token
否
临时密钥 token，当使用临时密钥时需要配置，若不使用可以直接按 Enter 跳过。 关于临时密钥的更多信息，请参见 使用临时密钥访问 COS。
注意：
通过初始化或命令配置的 Session Token 会加密存储，如需手动修改配置文件，需设置 Disable Encryption 参数关闭密钥加密。
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
否
元数据加速桶标记，用于标识该桶是否开启 元数据加速 功能。
CloseAutoSwitchHost
否
设置是否关闭自动切换备份域名。可选值 true | false，可以为空。
若不设置或值为 false，则会进行备份域名切换。
若设置为 true，则不进行备份域名切换。
DisableEncryption
否
设置是否关闭密钥加密。可选值 true | false，可以为空。
若不设置或值为 false ，则会加密配置文件中的密钥相关信息。
若设置为 true，则不加密配置文件中的密钥相关信息。
DisableAutoFetchBucketType
否
设置是否关闭自动获取桶类型。可选值 true | false，可以为空。
若不设置或值为 false ，则工具会自动获取桶类型，需要授权cos:HeadBucket权限。
如果设置为 true，工具将不会自动识别桶类型，而是优先根据参数 --bucket-type 来确定桶类型。若未设置该参数，则依据配置文件中桶信息的 ofs 参数确定桶类型（true 表示为 OFS 桶，false 表示为 COS 桶）。如果配置文件中未包含桶信息，则默认使用 COS 桶类型。
在初次配置时，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 均为加密后的字符串。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

对象存储

下载与安装配置

步骤一：下载 COSCLI 工具

步骤二：安装 COSCLI 工具

Windows

macOS

Linux

步骤三：配置 COSCLI 工具

其他配置方法

帮助和支持

中国站点下载地址	GitHub 下载地址（推荐海外用户使用）	SHA256校验
Windows-386	Windows-386	96e3c2aa2706f2c580f30093d1bf9f468046fd2cf498596f373f8e2707f0dea1
Windows-amd64	Windows-amd64	74f3b5ebbe89be2c013f9d3b2d8968691372801f2671bb31548eab4476fe9179
macOS-amd64	macOS-amd64	432ee022dcfdaec5a77e113386e7bcaa340680ea4c959147a3afb840c664aef9
macOS-arm64	macOS-arm64	df0018fbf78b552cbe875ebe26e8bdf7938c7f4394959f913dfc2ea4d1252568
Linux-386	Linux-386	a58e220bdc14781522b0c9eab76b02e5124b19f57554771a9e7ab204583c89ab
Linux-amd64	Linux-amd64	7165f2ae16c5f7ac495864c963ca574a76e04ec72680d7bc8a8eee3234d8cf91
Linux-arm	Linux-arm	5c5f6b70be061c7c30777dbc67271b2664036fbb56aaf6774c55ccc7f03194ed
Linux-arm64	Linux-arm64	0404b4da5b1d0c230c7d7522cb3bbec2909e314ab998889a0aeb8dc6094a2d21

配置项	是否必填	说明
Secret ID	是	密钥 ID，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取请参见子账号访问密钥管理。注意：通过初始化或命令配置的 Secret ID 会加密存储，如需手动修改配置文件，需设置 Disable Encryption 参数关闭密钥加密。
Secret Key	是	密钥 Key，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取请参见子账号访问密钥管理。注意：通过初始化或命令配置的 Secret Key 会加密存储，如需手动修改配置文件，需设置 Disable Encryption 参数关闭密钥加密。
Session Token	否	临时密钥 token，当使用临时密钥时需要配置，若不使用可以直接按 `Enter` 跳过。关于临时密钥的更多信息，请参见使用临时密钥访问 COS。注意：通过初始化或命令配置的 Session Token 会加密存储，如需手动修改配置文件，需设置 Disable Encryption 参数关闭密钥加密。
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	否	元数据加速桶标记，用于标识该桶是否开启元数据加速功能。
CloseAutoSwitchHost	否	设置是否关闭自动切换备份域名。可选值 true \| false，可以为空。若不设置或值为 false，则会进行备份域名切换。若设置为 true，则不进行备份域名切换。
DisableEncryption	否	设置是否关闭密钥加密。可选值 true \| false，可以为空。若不设置或值为 false ，则会加密配置文件中的密钥相关信息。若设置为 true，则不加密配置文件中的密钥相关信息。
DisableAutoFetchBucketType	否	设置是否关闭自动获取桶类型。可选值 true \| false，可以为空。若不设置或值为 false ，则工具会自动获取桶类型，需要授权`cos:HeadBucket`权限。如果设置为 true，工具将不会自动识别桶类型，而是优先根据参数 `--bucket-type` 来确定桶类型。若未设置该参数，则依据配置文件中桶信息的 ofs 参数确定桶类型（true 表示为 OFS 桶，false 表示为 COS 桶）。如果配置文件中未包含桶信息，则默认使用 COS 桶类型。