s3cmd命令常用参数有哪些？

s3cmd 是一个功能强大的命令行工具，专门用于与 Amazon S3（Simple Storage Service）及兼容 S3 协议的存储服务进行交互，它支持文件的上传、下载、删除、列表管理，以及存储桶的创建、配置和权限设置等操作，适用于数据备份、静态网站托管、大数据存储等多种场景，以下将详细介绍 s3cmd 的安装、配置、常用命令及实际应用示例，帮助用户快速上手并高效使用该工具。

安装与初始配置

在使用 s3cmd 之前，需先完成安装和配置，以 Linux 系统为例，可通过包管理器安装，例如在 Ubuntu 中运行 sudo apt-get install s3cmd，在 CentOS 中运行 sudo yum install s3cmd，安装完成后，需运行配置命令 s3cmd --configure，根据提示输入访问密钥（Access Key）、秘密密钥（Secret Key）、默认区域（如 eu-west-1）、加密密码（可选）等信息，配置完成后，s3cmd 会在用户主目录下生成 .s3cfg 配置文件，后续命令将自动读取该文件中的连接信息。

常用命令详解

存储桶管理

存储桶是 S3 中用于存储对象的容器，相关命令包括：

• s3cmd mb s3://bucket-name：创建名为 bucket-name 的存储桶，需确保名称全局唯一且符合 S3 命名规范（小写字母、数字、连字符，长度 3-63 字符）。
• s3cmd rb s3://bucket-name：删除空存储桶，若桶内有对象需先清空或使用 --force 参数强制删除（慎用）。
• s3cmd ls：列出账户下所有存储桶及其创建时间和大小。
• s3cmd du s3://bucket-name：计算存储桶中所有对象的总大小。

文件上传与下载

• 上传文件：s3cmd put /local/path s3://bucket-name/remote/path，支持 --acl-public 设置对象为公开可读，--encrypt 启用服务器端加密（SSE）。
• 上传目录：s3cmd put -r /local/dir s3://bucket-name/remote/dir，-r 参数递归处理目录下所有文件。
• 下载文件：s3cmd get s3://bucket-name/remote/path /local/path，--continue 可支持断点续传。
• 下载目录：s3cmd get -r s3://bucket-name/remote/dir /local/dir。

对象与列表操作

• 列出对象：s3cmd ls s3://bucket-name/remote/path，可结合 --recursive 列出子目录内容，--human-readable 以易读格式显示大小。
• 删除对象：s3cmd del s3://bucket-name/object-key，-r 可删除目录及其所有对象。
• 同步本地与远程：s3cmd sync /local/dir s3://bucket-name/remote/dir，双向同步差异，--delete 可删除目标中多余文件。s3cmd sync --delete s3://bucket-name/remote/dir /local/dir 可使本地目录完全匹配远程目录。

权限与元数据管理

• 设置 ACL：s3cmd setacl s3://bucket-name/object-key --acl-grant-read email@example.com，可授予指定用户读取权限。
• 查看对象元数据：s3cmd info s3://bucket-name/object-key，显示对象大小、最后修改时间、存储类等信息。
• 修改存储类：s3cmd modify s3://bucket-name/object-key --storage-class STANDARD_IA，将对象转换为低频访问存储。

其他实用命令

• 生成网站托管配置：s3cmd ws-create s3://bucket-name，配置后将支持静态网站访问。
• 同步时排除文件：通过 --exclude 和 --include 参数过滤文件，s3cmd sync /local/dir s3://bucket-name/ --exclude "*.tmp" 排除所有临时文件。

高级应用场景

数据备份自动化

结合 crontab 定时任务，可实现每日自动备份，创建脚本 backup.sh：

s3cmd sync /var/www/html s3://backup-bucket/www/ --delete --exclude "*.log"

然后通过 crontab -e 添加定时任务，如 0 2 * * * /path/to/backup.sh，表示每天凌晨 2 点执行备份。

大文件分片上传

对于大文件（如超过 5GB），s3cmd 会自动启用分片上传，提高传输稳定性，可通过 --multipart-chunk-size-mb 调整分片大小（默认为 50MB），s3cmd put large-file.iso s3://bucket-name/ --multipart-chunk-size-mb 100。

多账户管理

通过创建多个配置文件（如 .s3cfg-account1），可在不同账户间切换使用：s3cmd --config=/home/user/.s3cfg-account1 ls。

常见问题与解决方案

权限错误：Access Denied

原因：访问密钥无效、存储桶或对象权限未正确配置。
解决：检查 .s3cfg 中的密钥是否正确，运行 s3cmd ls 测试连接；使用 s3cmd setacl 调整对象或桶的 ACL。

上传速度慢

原因：网络带宽限制、区域选择不当。
解决：选择与服务器同区域的 S3 终端节点；使用 --disable-multipart 禁用分片上传（对小文件可能有效）；检查本地网络环境。

相关问答FAQs

Q1: s3cmd 支持哪些 S3 兼容存储服务？
A1: s3cmd 除支持 Amazon S3 外，还兼容 MinIO、Ceph Object Gateway、Wasabi、DigitalOcean Spaces 等基于 S3 协议的存储服务，只需在配置时修改 host_base 和 host_bucket 参数即可，配置 MinIO 时，需设置 host_base = play.min.io:9000 和 host_bucket = %(bucket)s.play.min.io:9000。

Q2: 如何使用 s3cmd 恢复误删的对象？
A2: S3 本身不提供回收站功能，但可通过版本控制（Versioning）恢复历史版本，首先在存储桶启用版本控制：s3cmd version s3://bucket-name，然后使用 s3cmd ls --version s3://bucket-name/object-key 查看所有版本，最后通过 s3cmd get s3://bucket-name/object-key?versionId=版本ID 恢复指定版本的对象，未启用版本控制时，误删对象无法直接恢复，建议定期通过 s3cmd sync 将重要数据备份到其他存储桶。