gsutil

Google Cloud Storage 命令行客户端

补充说明

gsutil 是 GCS 的传统命令行工具，支持上传、下载、同步、权限和生命周期配置。新项目可优先用 gcloud storage，但大量脚本仍依赖 gsutil。

常用示例

gsutil ls
gsutil ls -l gs://my-bucket/
gsutil cp file.txt gs://my-bucket/
gsutil -m cp -r ./dist gs://my-bucket/dist
gsutil rsync -r ./site gs://my-bucket/site
gsutil rsync -d -r ./site gs://my-bucket/site
gsutil mb -l asia-east1 gs://my-bucket/
gsutil iam ch user:dev@example.com:objectViewer gs://my-bucket
gsutil versioning set on gs://my-bucket
gsutil lifecycle set lifecycle.json gs://my-bucket
gsutil du -sh gs://my-bucket

易错点与排错

• gsutil rsync -d 会删除目标端多余对象；先不加 -d 试跑或列清单确认。
• -m 开启并行，能显著加速大量小文件；但错误输出会分散，注意汇总检查。
• 源路径结尾的 / 会影响复制层级；同步目录时先用 -n 干跑。
• gsutil 和 gcloud storage 的权限模型、性能和参数不同；不要盲目替换。
• 桶级 IAM 和对象 ACL 可能同时存在；统一策略前先看桶的默认权限。
• 开启版本控制或保留策略后，删除不等于彻底清除；成本和合规要一起考虑。
• Requester Pays 桶需要显式 -u 计费项目；否则访问被拒。
• 大文件传输中断后可用 gsutil -o GSUtil:resumable_threshold=... 调整；先确认网络和权限。

相关命令

• gcloud — 推荐的新一代存储命令
• bq — BigQuery CLI
• aws — 其他云的对象存储命令