首页/云/云平台与虚拟化速查/对象存储命令行工具

对象存储命令行工具

三家对象存储均提供命令行工具:ossutil(阿里云)、coscmd(腾讯云)、obsutil(华为云),支持上传下载与目录同步,适合发布与备份脚本。

云平台与虚拟化速查云更新于 2026-10-13

对象存储命令行工具是什么

三家对象存储都有官方命令行工具:阿里云 ossutil、腾讯云 coscmd(另有新版工具)、华为云 obsutil。它们支持上传下载、目录同步与批量操作,是发布脚本与备份任务里最常用的形态:一条命令把构建产物推到桶里,或把日志目录同步到远端。

基本信息

工具对应阿里云 ossutil、腾讯云 coscmd、华为云 obsutil
配置方式首次运行交互式写入凭证与地域,配置存本地文件
核心子命令上传、下载、列举、删除与目录同步
增量能力同步类命令可按修改时间或大小判断是否需要传输
危险参数部分命令支持删除远端多余文件,使用前必须核验范围
凭证建议使用子账号或临时凭证,配置文件权限收紧

常用命令示例

常用命令示例
ossutil cp -r ./dist oss://my-app-assets/dist/ --update    # 上传目录,仅传有变化的文件
ossutil sync ./logs oss://my-app-assets/logs/               # 同步目录到桶
ossutil ls oss://my-app-assets/ --short-format               # 快速列举对象
coscmd upload -r ./dist /dist/                               # 腾讯云上传目录
obsutil cp -r -f ./dist obs://my-app-assets/dist/            # 华为云上传目录
# 带 --delete 的同步会在远端删除多余文件,先在测试桶验证范围

发布与备份场景的用法

场景推荐做法注意点
前端发布上传新版本目录后再切换访问入口避免直接覆盖正在被引用的文件
日志备份按日期前缀同步,配合生命周期转档先确认上传完整性,再允许本地清理
批量下载按前缀过滤,分批下载全量下载大桶会长时间占用带宽
增量上传启用按时间或大小跳过未变化文件时间戳异常会导致漏传
工具配置文件包含密钥:发布机上要限制文件权限,优先使用子账号密钥或临时凭证。把配置文件纳入镜像或代码仓库是常见的泄露途径,应通过环境变量或密钥服务注入。
同步类命令的删除参数是高风险开关:它会让远端与本地完全一致,本地缺失的文件在远端也会被删除。使用前确认本地目录完整,并先在测试桶验证前缀范围。

易错点

  • sync 或 cp 的删除参数未核验就在生产桶执行:远端文件被误删,且通常没有回收途径
  • 在流水线中运行工具但未配置凭证:发布静默失败,构建任务却显示成功
  • 全量上传大目录代替增量:每次发布都传输全部文件,耗时与流量成倍增加
  • 用主账号密钥配置工具:权限过大且难以轮转,泄露影响面覆盖整个账号
  • 只上传不校验:中断的上传留下不完整对象,恢复备份时才发现文件不可用

数据来源与参考

  • 阿里云 ossutil 文档
  • 腾讯云 coscmd 文档
  • 华为云 obsutil 文档
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌