如何使用 S3CMD 访问 COS 服务

简介

S3cmd 是免费的命令行工具和客户端，用于在 Amazon S3 和其他兼容 S3 协议的对象存储中上传、下载和管理数据。本文主要介绍如何使用 S3cmd 访问 COS 上的文件。

准备工作

1. 您已注册 腾讯云账号，并且从 访问管理控制台 上获取了腾讯云密钥 SecretID 与 SecretKey。

使用环境

软件依赖

• Python 2.6+/3+。
• 最新版本的 pip。

安装及配置

• 环境安装与配置详细操作请参见 Python 安装与配置。
• pip 环境安装与配置详细操作请参见 官网 pip 安装说明。

安装 S3cmd

• 使用 pip 安装（推荐）

pip install s3cmd

安装成功之后，用户可以通过--version命令查看当前的版本信息。

配置参数

S3cmd 工具在使用前需要进行参数配置，默认读取 ~/.s3cfg 作为配置文件，可以直接在命令中指定参数,也可以直接通过程序的交互式命令创建配置文件。

• 通过 s3cmd --configure 命令来初始化配置信息

• 编辑 ~/.s3cfg配置文件

可以直接编辑~/.s3cfg 文件 （在 Windows 环境下，该文件是位于【我的文档】下的一个隐藏文件），该文件初始时不存在，是通过 s3cmd --configure 命令生成，用户也可以手动创建。

配置完成之后的.s3cfg文件内容示例如下所示：

经过如上配置后具体可以操作某一个地域的存储桶。

如有在其它兼容S3的工具中使用COS可以参考：https://cloud.tencent.com/document/product/436/41284

开始使用

下面为您介绍如何使用 s3cmd 完成一个基础操作，例如创建存储桶、查询存储桶列表、上传对象、查询对象列表、下载对象和删除对象。

创建存储桶

注意，该存储桶创建时的地域为配置信息里的默认地域

• 命令如下：

删除存储桶

• 命令如下：

查询存储桶列表

• 命令如下：

查询对象列表

• 命令如下：

上传文件或文件夹

• 上传文件命令如下：

• 上传文件夹命令如下：

复制文件或文件夹

• 复制文件命令如下：

• 复制文件夹命令如下：

移动文件或文件夹

• 移动文件命令如下：

• 移动文件夹命令如下：

下载文件

• 下载文件命令如下：

• 暂不支持下载文件夹

删除文件或文件夹

• 删除文件命令如下：

• 删除文件夹命令如下：

分块上传文件

• 命令如下：

提示 multipart-chunk-size-mb 用来设置分块大小，最小值为 5MB, 最大值为 5GB, 默认值为 15MB。

显示桶内未完成的分块上传

• 命令如下：

此处会打印出日期、路径以及上传 id

查询分块上传文件碎片

• 命令如下：

提示 1586497168ca632296cea7ebe10b43e6c22ab23a067c776d793da1316d8e991aadafd0cebb 是上传 id，在 s3cmd multipart 中进行查询

清除分块上传文件碎片

• 命令如下：

提示

1586497168ca632296cea7ebe10b43e6c22ab23a067c776d793da1316d8e991aadafd0cebb 是上传 id，在 s3cmd multipart 中进行查询