s3cmd 命令

S3cmd Usage

s3cmd 是一个用于管理 Amazon S3 存储中的对象的工具。它允许创建和删除 “buckets”，以及上传、下载和删除这些 buckets 中的 “objects”。

基本用法

参数	说明	使用示例
-h, --help	显示帮助信息并退出。	s3cmd --help
--configure	运行配置向导， 调用交互式(重新)配置工具。帮助设置S3账户信息。 可选地使用如–configure s3://some-bucket来测试对特定存储桶的访问而不是尝试列出所有存储桶	s3cmd --configure
--dump-config	转储当前配置（解析配置文件和命令行选项后）并退出	s3cmd --dump-config
--version	显示版本信息并退出。	s3cmd --version
-c FILE, --config=FILE	指定配置文件路径，默认使用 $HOME/.s3cfg。	s3cmd -c /path/to/config
--access_key=ACCESS_KEY	指定S3访问密钥，覆盖配置文件中的值。	s3cmd --access_key=YOUR_ACCESS_KEY
--secret_key=SECRET_KEY	指定S3密钥，覆盖配置文件中的值。	s3cmd --secret_key=YOUR_SECRET_KEY
--access_token=ACCESS_TOKEN	AWS 访问令牌
-r, --recursive	递归上传、下载或删除操作（例如在目录上执行操作时）。	s3cmd sync --recursive /local/dir s3://bucket/dir
-f, --force	强制执行可能有风险的操作（例如覆盖现有文件）。	s3cmd put --force file.txt s3://bucket/
-n, --dry-run	仅显示将要上传或下载的内容，但实际不执行操作。可能仍然执行S3请求以获取存储桶列表和其他信息（仅用于文件传输命令）
-s, --ssl	使用SSL/TLS加密与S3通信。	s3cmd --ssl ls s3://bucket/
--no-ssl	不使用HTTPS
-e, --encrypt	在上传到S3之前加密文件
--no-encrypt	不加密文件
--dry-run	显示将要执行的操作，但不实际执行。	s3cmd sync --dry-run /local/dir s3://bucket/dir
--delete-removed	在同步时删除S3中不存在的本地文件。	s3cmd sync --delete-removed /local/dir s3://bucket/dir
--check-md5	检查MD5校验和（默认）
--no-check-md5	跳过MD5校验，不检查MD5校验和，仅比较大小。 可能会显著加速传输但也可能错过一些更改过的文件加快传输速度（不推荐）。	s3cmd put --no-check-md5 file.txt s3://bucket/
--reduced-redundancy	使用亚马逊S3的Reduced Redundancy Storage（RRS），以降低存储成本。	s3cmd put --reduced-redundancy file.txt s3://bucket/
--storage-class=CLASS	指定存储类型（标准、标准-IA或RRS）。	s3cmd put --storage-class=STANDARD_IA file.txt s3://bucket/
--region=REGION	指定S3区域，如us-east-1。	s3cmd --region=us-west-2 ls s3://bucket/
--endpoint-url=URL	使用自定义S3兼容存储的URL。	s3cmd --endpoint-url=https://custom-s3.com ls s3://bucket/
--signature-v2	使用AWS Signature Version 2进行身份验证。	s3cmd --signature-v2 ls s3://bucket/
--server-side-encryption	在S3服务器端对上传的数据进行加密。	s3cmd put --server-side-encryption file.txt s3://bucket/
--delete-after	上传完成后删除本地文件（sync命令）。	s3cmd sync --delete-after /local/dir s3://bucket/dir
--delete-removed	删除没有相应源文件的目标对象（仅用于sync命令）
--no-delete-removed	不删除目标对象
--delay-updates	OBSOLETE 将所有更新的文件放置在最后（sync命令）
--multipart-chunk-size-mb=SIZE	指定多部分上传时的块大小（MB）。	s3cmd put --multipart-chunk-size-mb=10 largefile.bin s3://bucket/
--max-delete=NUM	在同步时限制删除操作的数量。（del和sync命令）	s3cmd sync --max-delete=10 /local/dir s3://bucket/dir
--preserve	保留文件的元数据（例如时间戳）。	s3cmd sync --preserve /local/dir s3://bucket/dir
--exclude-from=FILE	从FILE中读取--exclude GLOB
--exclude=GLOB	排除匹配的文件（使用shell通配符）。	s3cmd sync --exclude '*.tmp' /local/dir s3://bucket/dir
--include=GLOB	包含匹配的文件，即使它们被排除。	s3cmd sync --include '*.jpg' --exclude '*' /local/dir s3://bucket/dir
--skip-existing	跳过目标位置已存在的文件（仅用于get和sync命令）	s3cmd sync --skip-existing /local/dir s3://bucket/dir
--upload-id=UPLOAD_ID	继续已中断的多部分上传。	s3cmd put --upload-id UPLOAD_ID file.txt s3://bucket/
--continue	继续获取部分下载的文件（仅用于get命令）
--continue-put	继续上传部分上传的文件或多部分上传段。重新启动或部分文件没有匹配大小和md5的情况会跳过具有匹配大小和md5的文件/部分
-p, --preserve	保留文件系统属性（模式、所有权、时间戳）。默认为sync命令
-P, --acl-public	存储对象时使用ACL允许任何人读取
--acl-private	存储对象时使用默认ACL，只允许您访问
--acl-grant=PERMISSION:EMAIL or USER_CANONICAL_ID	授予给定亚马逊用户所述权限。权限可以是：read, write, read_acp, write_acp, full_control, all
--acl-revoke=PERMISSION:USER_CANONICAL_ID	撤销给定亚马逊用户的所述权限
-D NUM, --restore-days=NUM	保持恢复文件可用的天数（仅用于restore命令）
--restore-priority=RESTORE_PRIORITY	从S3 Glacier恢复文件的优先级（仅用于restore命令）。可用选项：bulk, standard, expedited
--limit=NUM	限制响应主体中返回的对象数量（仅用于ls和la命令）
--add-destination=ADDITIONAL_DESTINATIONS	并行上传的额外目标位置，除了最后一个参数外。可以重复
--delete-after-fetch	在获取到本地文件后删除远程对象（仅用于get和sync命令）
--no-preserve	不存储文件系统属性
--rexclude=REGEXP	匹配正则表达式的文件名和路径将从同步中排除
--rexclude-from=FILE	从FILE中读取--rexclude正则表达式
--include=GLOB	即使之前被--(r)exclude(-from)模式排除，匹配GLOB的文件名和路径也将被包括
--include-from=FILE	从FILE中读取--include GLOB
--rinclude=REGEXP	与--include相同，但使用正则表达式而不是GLOB
--rinclude-from=FILE	从FILE中读取--rinclude正则表达式
--files-from=FILE	从FILE中读取源文件名列表。使用-从stdin读取
--region=REGION, --bucket-location=REGION	创建存储桶的区域。目前区域有：us-east-1, us-west-1, us-west-2, eu-west-1, eu-central-1, ap-northeast-1, ap-southeast-1, ap-southeast-2, sa-east-1
--host=HOSTNAME	S3端点的HOSTNAME:PORT（默认：s3.amazonaws.com，其他如s3-eu-west-1.amazonaws.com）。也应该设置--host-bucket
--host-bucket=HOST_BUCKET	用于访问存储桶的DNS样式存储桶+主机名：端口模板（默认：%(bucket)s.s3.amazonaws.com）
--reduced-redundancy, --rr	以“降低冗余”存储对象。每GB价格更低。[put, cp, mv]
--no-reduced-redundancy, --no-rr	不使用“降低冗余”存储对象。每GB价格更高。[put, cp, mv]
--storage-class=CLASS	指定存储类别（STANDARD, STANDARD_IA, 或 REDUCED_REDUNDANCY）。[put, cp, mv]
--access-logging-target-prefix=LOG_TARGET_PREFIX	访问日志的目标前缀（S3 URI）（仅用于cfmodify和accesslog命令）
--no-access-logging	禁用访问日志（仅用于cfmodify和accesslog命令）
--default-mime-type=DEFAULT_MIME_TYPE	存储对象的默认MIME类型。默认是binary/octet-stream
-M, --guess-mime-type	通过文件扩展名或mime magic猜测文件的MIME类型。回退到--default-mime-type选项指定的默认MIME类型
--no-guess-mime-type	不猜测MIME类型，使用默认类型
--no-mime-magic	猜测MIME类型时不使用mime magic
-m MIME/TYPE, --mime-type=MIME/TYPE	强制MIME类型。覆盖--default-mime-type和--guess-mime-type
--add-header=NAME:VALUE	向上传请求添加给定的HTTP头。可以多次使用。例如设置’Expires’或’Cache-Control’头（或两者）
--remove-header=NAME	移除给定的HTTP头。可以多次使用。例如，移除’Expires’或’Cache-Control’头（或两者）
--server-side-encryption	指定在放置对象时使用服务器端加密。[put, sync, cp, modify]
--server-side-encryption-kms-id=KMS_KEY	指定用于服务器端加密的密钥ID，使用AWS KMS管理的密钥（SSE-KMS）放置对象。[put, sync, cp, modify]
--encoding=ENCODING	覆盖自动检测的终端和文件系统编码（字符集）。自动检测：UTF-8
--add-encoding-exts=EXTENSIONs	在上传到S3时添加编码到这些逗号分隔的扩展名，例如（css,js,html）
--verbatim	使用命令行上给定的S3名称。不进行预处理、编码等。谨慎使用！
--disable-multipart	在文件大于--multipart-chunk-size-mb时禁用多部分上传
--multipart-chunk-size-mb=SIZE	多部分上传中每个块的大小。大于SIZE的文件自动作为多线程多部分上传，小于SIZE的文件使用传统方法。SIZE以

ref
https://s3tools.org/s3cmd-sync
https://s3tools.org/s3cmd
https://s3tools.org/usage