ossutil工具32位+64位是一款专为高效管理阿里云OSS（对象存储服务）而设计的命令行工具，全面兼容32位与64位系统。软件体积小巧、运行流畅，安装即用，不占用过多系统资源，下载和响应速度极快。开发团队持续优化更新，确保其与主流操作系统保持良好兼容性，为用户提供稳定可靠的使用体验。

软件介绍

ossutil工具32位+64位是一款通过命令行方式操作和管理OSS数据的实用工具。当前版本暂未完整支持Bucket管理功能和Multipart上传管理功能，相关能力正在积极开发中，并将在后续版本陆续上线。若您当前有上述功能的使用需求，建议暂时使用osscmd命令行工具作为替代方案。

安装使用

请根据您的操作系统选择对应的二进制文件或压缩包进行下载。下载完成后，直接运行其中的可执行文件即可。若系统提示该文件不可执行，请先为其添加执行权限，例如在Linux或macOS中执行：chmod 755 ossutil。

Windows系统下（以64位为例）有两种使用方式：

1) 解压下载的压缩包，双击运行其中的bat文件，随后在弹出的命令窗口中输入：ossutil64.exe

2）解压压缩包后，打开命令提示符（cmd），进入binary所在目录，直接输入：ossutil64.exe

设置ossutil的语言

在执行ossutil命令时，可通过-L参数指定界面语言，支持CH（中文）或EN（英文），大小写不敏感。默认语言为中文（CH）。若选择中文显示，请确保系统编码为UTF-8，否则可能出现乱码。

示例如下：

./ossutil help ls 显示ls命令的默认语言帮助信息

./ossutil help ls -L ch 显示ls命令的中文帮助

./ossutil help ls -L en 显示ls命令的英文帮助

./ossutil config -L ch 启动交互式配置，提示语言为中文

./ossutil config -L en 启动交互式配置，提示语言为英文

注意：ossutil输出的错误信息默认始终为英文，不受-L参数影响。

常见问题

本文整理了使用ossutil过程中可能遇到的典型问题及对应的解决方法，帮助用户快速排查和处理异常情况。

使用-u参数上传文件时出现skip提示

问题分析：当使用-u参数上传文件时，ossutil会将本地文件与目标Bucket中同名文件进行比对。如果本地文件的最后修改时间早于或等于OSS中已存在的文件，则跳过上传并提示“skip”；仅当本地文件更新时才会重新上传。因此，出现skip提示属于正常行为。

解决方案：确认目标Bucket中的文件内容无误后，可忽略该提示。

文件解冻时出现403报错

问题分析：解冻归档类型文件时返回403错误，通常由以下两种原因导致：一是当前使用的子账号权限不足，缺乏对该文件的操作权限；二是该文件因内容违规已被OSS系统封禁。

解决方案：

若为子账号权限不足，请为主账号或子账号补充相应权限策略；

若文件内容违禁，请删除或不再尝试操作该文件。

使用ls命令查看Bucket无文件，删除Bucket时报错

问题分析：默认的ls命令仅列出当前版本的普通文件，无法显示碎片（multipart upload残留）或历史版本文件（仅存在于开启过版本控制的Bucket中）。若Bucket实际包含这些隐藏内容，则无法直接通过rm命令删除整个Bucket。

解决方案：

首先清理碎片和历史版本文件（如Bucket未开启版本控制，可跳过历史版本处理），再执行删除操作。

列举并删除碎片：

./ossutil ls oss://bucket1 -m

./ossutil rm -m oss://bucket1 -r

列举并删除历史版本文件：

./ossutil ls oss://bucket1 --all-versions

./ossutil rm oss://bucket1 --all-versions -r

完成清理后，删除Bucket：

./ossutil rm oss://bucket1 -b

如需强制删除Bucket：

若Bucket未开启版本控制，执行：

./ossutil rm oss://bucketname -abrf

若Bucket已开启版本控制，执行：

./ossutil rm oss://bucketname -abrf --all-versions

警告：Bucket及其内部所有文件一经删除将无法恢复，请务必谨慎操作。

文件上传、下载进度超过100%

问题分析：当上传或下载的文件大于100MB时，ossutil会自动启用断点续传机制，并在当前目录生成名为.ossutil_checkpoint的临时文件夹用于记录传输状态。任务完成后该文件夹会被自动清除。若在同一台机器上同时运行多个ossutil实例进行传输，其中一个任务结束后删除了checkpoint文件夹，可能导致其他任务因丢失断点信息而显示进度超过100%且无法完成。

解决方案：

终止当前异常任务，重新开始上传或下载；

或在cp命令中通过--checkpoint-dir参数手动指定一个独立的checkpoint目录，避免冲突。例如：

./ossutil cp oss://bucket1/myphoto.jpg /dir --checkpoint-dir checkpoint