下载与安装--对象存储-火山引擎

文档中心

导航

对象存储

下载与安装

最近更新时间：2024.11.06 17:07:33首次发布时间：2022.11.03 10:30:29

tosutil 命令行工具同时支持 Windows、Linux 及 macOS 三大系统，您可以根据实际环境下载和安装合适的版本。

下载地址

操作系统	工具下载地址	工具校验文件
Linux amd64bit	Linux AMD tosutil	Linux AMD sha256
Linux arm64bit	Linux ARM tosutil 注意该操作系统工具不会与其他系统的工具版本同步更新，如有更新，将在更新日志中单独说明。	Linux ARM sha256
macOS amd64bit	AMD64 tosutil 注意 macOS 系统默认无法打开未验证的开发者应用。如果安装 tosutil 时，提示无法验证开发者，您需要修改系统设置。具体操作，请参见在 macOS 系统中安装 tosutil 或 TOS Browser 时，提示无法验证开发者。	AMD64 sha256
macOS arm64bit	ARM64 tosutil	ARM64 sha256
Windows 64bit	Windows tosutil	Windows sha256

更新日志

说明

如无特殊说明，本章节更新日志不包括 Linux ARM 操作系统的工具版本。
tosutil 工具的最新版本仅适用于 Windows、Mac 和 Linux amd 系统。

版本号	版本类型	发布日期	更新说明
3.1.5	最新版本	2024-11-06	新增 `enablePprof` 参数，该参数可用于开启 pprof 服务，详情请参见配置文件说明。修复上传对象时如果不携带 `-link` 参数后，导致内容不符合预期的问题。
3.1.4	历史版本	2024-10-22	修改 `mount` 命令的参数，说明如下：下线 `-dlfc` 参数。简化`-rateLimit` 参数，将 `-rateLimit` 简化为 `-rl` 参数。新增 `-mrbs` 、`-mwbs`、`-rfdl`、`-wfdl`、`-nftr` 参数。详情请参见挂载桶为本地文件系统目录（mount）。
3.1.3	历史版本	2024-09-13	修复执行 `mount` 命令时， `-fm` 和 `-dm` 参数设置后不生效的问题。
3.1.2	历史版本	2024-09-03	支持将开启版本控制功能的存储桶挂载为本地文件系统目录，详情请参见挂载桶为本地文件系统目录（mount）。
3.1.0	历史版本	2024-08-16	批量任务的最大并发数的默认值由 1 改为 3，详情请参见以下文档：上传对象（cp）下载对象（cp）拷贝对象（cp）恢复执行失败的任务（cp）通过授权码下载对象（share-cp）复制本地文件（fcp）配置文件说明挂载存储桶为本地文件系统目录时，新增以下功能：支持通过 `-ac` 参数为已存在的文件执行追加写操作。支持通过 `-cfd` 参数指定本地缓存文件的目录，通过 `-mcs` 指定本地缓存文件的存储容量上限。详情请参见挂载桶为本地文件系统目录（mount）。
3.0.1	历史版本	2024-06-24	支持通过 `mount` 命令将存储桶挂载为本地文件系统目录，详情请参见挂载桶为本地文件系统目录（mount）。注意该命令仅支持 Linux 和 macOS。
3.0.0	历史版本	2024-06-20	支持通过 `netdig` 命令进行一键式网络诊断，详情请参见一键式网络诊断（netdig）。注意该命令仅支持 Linux 和 macOS。
2.0.0	历史版本	2024-04-16	支持创建文件夹，详情请参见创建文件夹（mkdir）。下载和拷贝对象时支持通过 `-marker` 参数指定对象的开始位置，详情请参见以下文档：下载对象（cp）拷贝对象（cp）支持测试亚太东南（柔佛）地域的单流速率，详情请参见测试网络速率（probe）。复制本地文件时支持使用 `-eam` 参数指定用于加解密本地文件的算法模式，详情请参见复制本地文件（fcp）。配置文件中新增数据一致性校验相关参数，详情请参见配置文件说明。
1.9.0	历史版本	2024-02-29	支持设置桶或对象的预定义访问策略，详情请参见设置桶或对象的预定义访问策略（set-acl）。支持多个网络诊断命令，详情请参见以下文档：测量网络延迟（ping）计算网络连接耗时（connect）抓取网络（traceroute）发送 HTTP 请求（curl）
1.8.2	历史版本	2024-01-16	复制本地文件或文件夹时支持加密复制，详情请参见复制本地文件（fcp）。上传、下载或复制对象时支持使用 `#` 作为分隔符，详情请参见以下文档：上传对象（cp）下载对象（cp）拷贝对象（cp）
1.8.0	历史版本	2023-12-18	支持将本地文件或文件夹复制到目的路径，详情请参见复制本地文件（fcp）。
1.7.2	历史版本	2023-11-23	支持计算桶内对象及分片的大小及数量，详情请参见计算对象和分片大小和数量（du）。提供常见错误码说明，详情请参见 tosutil 工具错误码说明。
1.6.0	历史版本	2023-09-12	支持计算文件或文件夹的哈希值，详情请参见计算文件哈希值。
1.5.1	历史版本	2023-08-14	批量处理对象时新增 `-nfj` 参数，表示处理普通文件或对象（非分片任务）的最大并发数。详情请参见以下文档：上传对象下载对象复制对象恢复执行失败的对象
1.5.0	历史版本	2023-07-14	分享对象操作删除提取码参数，详情请参见分享对象。上传及复制对象时支持设置加密参数，详情请参见上传对象及复制对象。配置文件中新增加密等参数，详情请参见配置文件说明。
1.4.1	历史版本	2023-05-19	支持网络测试命令，详情请参见测试网络速率。支持上传文件时指定自定义 meta，详情请参见设置对象元数据。优化了部分报错信息。
1.3.2	历史版本	2023-04-17	优化任务中止或失败场景中，状态码的判断逻辑。
1.3.1	历史版本	2023-03-30	优化大文件上传失败后的清理逻辑。
1.3.0	历史版本	2023-02-06	支持分享文件功能，详情请参见以下文档：创建授权码通过授权码列举对象通过授权码下载对象
1.2.0	历史版本	2022-11-03	首次发布。支持创建桶、上传文件等功能。支持的功能列表，请参见功能说明。

安装方式

您可以直接下载安装包安装 tosutil 工具；也可以通过 wget 命令下载，不同操作系统下的安装命令如下所示。

Linux

wget https://tos-tools.tos-cn-beijing.volces.com/linux/tosutil && chmod a+x tosutil

macOS AMD64

wget https://tos-tools.tos-cn-beijing.volces.com/darwin/amd64/tosutil && chmod a+x tosutil

macOS ARM64

wget https://tos-tools.tos-cn-beijing.volces.com/darwin/arm64/tosutil && chmod a+x tosutil

Windows

wget https://tos-tools.tos-cn-beijing.volces.com/windows/tosutil -O tosutil.exe