张芷铭的个人博客

ossutil 是阿里云 OSS 官方命令行工具，跨平台支持，批量和大文件操作首选。

安装配置

下载安装

  • Windows：解压后得到 ossutil64.exe
  • Mac/Linux：解压后得到 ossutil64，执行 chmod +x ossutil64

初始化配置

1

ossutil64 config

填写三项（阿里云控制台获取）：

  1. Endpoint：如 oss-cn-hangzhou.aliyuncs.com
  2. AccessKey ID
  3. AccessKey Secret

核心命令

通用语法：ossutil64 命令 本地路径 oss://bucket名/oss路径

参数作用
-r递归操作（文件夹必备）
-f强制执行（跳过确认）
-u增量同步（只传新增/修改）
-j多线程并发（如 -j 8）

查看/列举

1
2
3

ossutil64 ls                          # 列出所有 bucket
ossutil64 ls oss://my-bucket-name     # 列出 bucket 下文件
ossutil64 ls oss://my-bucket/images/  # 指定目录

上传

1
2
3
4
5

# 单个文件
ossutil64 cp 本地文件 oss://bucket名/目录/

# 文件夹（加 -r 递归）
ossutil64 cp -r 本地文件夹 oss://bucket名/

下载

1
2
3
4
5

# 单个文件
ossutil64 cp oss://bucket名/文件 本地路径

# 文件夹（加 -r 递归）
ossutil64 cp -r oss://bucket名/目录 本地路径

删除

1
2
3
4
5

# 单个文件
ossutil64 rm oss://bucket名/文件

# 文件夹（慎用）
ossutil64 rm -rf oss://bucket名/目录/

重命名/移动

1
2
3
4
5

# 重命名
ossutil64 mv oss://bucket/old.jpg oss://bucket/new.jpg

# 移动
ossutil64 mv oss://bucket/a/file oss://bucket/b/

其他操作

1
2

ossutil64 mkdir oss://bucket/new-folder/  # 创建目录
ossutil64 stat oss://bucket/file          # 查看文件详情

增量同步

1
2
3
4
5

# 增量上传
ossutil64 cp -ru 本地文件夹 oss://bucket/

# 增量下载
ossutil64 cp -ru oss://bucket/ 本地文件夹

高速传输

1
2

# 8线程 + 递归 + 强制
ossutil64 cp -rfu -j 8 大文件夹 oss://bucket/

注意事项

  1. OSS 路径格式：oss://bucket名/路径，无需引号
  2. Windows 使用 ossutil64.exe
  3. 区分大小写

速查表

1
2
3
4
5
6

ossutil64 config                    # 初始化配置
ossutil64 ls oss://bucket           # 查看文件
ossutil64 cp 本地 oss://bucket -r   # 上传文件夹
ossutil64 cp oss://bucket 本地 -r   # 下载文件夹
ossutil64 rm oss://bucket/文件 -rf  # 删除
ossutil64 mv oss://原 oss://新      # 移动/重命名

核心就是 cp + ls/rm/mv，记住 -r/-f/-u 三个参数即可。

Comments