文档中心

对象存储

请输入

tosutil

下载与安装

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

下载地址

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

更新日志

说明

如无特殊说明，本章节更新日志不包括 Linux ARM 操作系统的工具版本。

tosutil 工具的最新版本仅适用于 Windows、Mac 和 Linux amd 系统。

版本号	版本类型	发布日期	更新说明
4.1.7	最新版本	2026/05/19	更新底层 Golang 版本至1.20 版本，解决 Runtime 问题。
4.1.6	历史版本	2026-01-21	加固弱网环境下，上传对象（cp）时的稳定性。
4.1.5	历史版本	2025-12-22	下载对象（cp）和拷贝对象（cp）新增 -bfs 参数，用于使用分层列举的方式批量下载和复制对象，并指定分层列举的并发度。详情请参见下载对象（cp）和拷贝对象（cp）。
4.1.4	历史版本	2025-12-22
4.1.3	历史版本	2025-09-26	新增 - f 参数，用于设置是否跳过覆盖本地文件时的确认提示。详情请参见下载对象（cp）。
4.1.2	历史版本	2025-09-23	支持配置 HTTP 代理，您可以通过代理访问对象存储 TOS。详情请参见配置 HTTP 代理。支持通过 presign 命令生成预签名 URL。详情请参见生成预签名 URL（presign）。
4.1.1	历史版本	2025-08-07	将下载对象（cp）中 -p 参数的默认值修改为 5 。详情请参见下载对象（cp）。配置文件新增 defaultDownloadParallels、defaultScanConcurrency 等参数，说明如下：新增 defaultDownloadParallels 参数，用于设置下载分片任务的最大并发数。新增 defaultScanConcurrency 参数，用于设置批量任务在列举源端数据时的并发数。新增 usePrefetchForDownload 参数，用于在下载对象时，使用并发预读模式顺序写本地文件。详情请参见配置文件说明。
4.1.0	历史版本	2025-07-29	优化版本稳定性。
4.0.9	历史版本	2025-07-24	优化使用 cp 命令上传对象、拷贝对象时 -p 参数的默认值，由 1 修改为 20。详情请参见上传对象（cp）和拷贝对象（cp）。修复使用 mount 命令挂载存储桶后，某些场景 close 文件报错的问题。
4.0.8	历史版本	2025-07-07	修复使用 readdir 查询文件时，无法获取正在写但未关闭的文件的问题。修复 ls 命令 -limit = 0 （表示列举数量无限制）配置无效的问题，详情请参见列举账号下资源（ls）。
4.0.7	历史版本	2025-07-07
4.0.6	历史版本	2025-06-12	修改 mount 命令的参数，说明如下：新增 -mts 参数，用于在写入数据时，限制本地临时文件的目录大小。将 rconcurrency 参数的默认值修改为 100000。将 wconcurrency 参数的默认值修改为 100000。详情请参见挂载存储桶为本地文件系统目录（mount）。
4.0.5	历史版本	2025-06-12
4.0.4	历史版本	2025-04-29	修改 mount 命令的参数，说明如下：新增 -ntmout 参数，用于设置挂载的本地文件系统目录的 Negative-Timeout。新增 -cctf 参数，用于设置在写入数据时，是否计算本地临时文件的 CRC64 值。新增 -ntfc 参数，用于设置在创建新文件时，是否使用 truncate 参数。详情请参见挂载存储桶为本地文件系统目录（mount）。将 skipWriteSucceedRecord 的默认值修改为 true，详情请参见配置文件说明。
4.0.3	历史版本	2025-03-28	下载对象（cp）和复制本地文件（fcp）新增 -nftr 参数，配置文件新增 noTruncateForCreateNewFile 参数，这些参数功能相同，用于选择是否使用 Truncate 参数指定文件大小。详情请参见下载对象（cp）、复制本地文件（fcp）和配置文件说明。
4.0.2	历史版本	2025-02-28	支持匿名访问 TOS，详情请参见快速入门。
4.0.1	历史版本	2025-02-18	修复使用 mount 命令挂载存储桶时，随机读 IO 操作出现阻塞的问题。
4.0.0	历史版本	2025-02-13	tosutil 全面支持 HNS 存储桶，详情请参见创建存储桶（mb）。 mount 命令新增 -adr 参数，该参数用于递归删除目录，详情请参见挂载存储桶为本地文件系统目录（mount）。新增配置参数 allowNoDelimiterForFns 和 printMemUsage ，说明如下： allowNoDelimiterForFns 参数用于设置是否允许携带 delimiter 列举。 printMemUsage 参数用于设置是否需要在日志中记录内存申请 metrics。详情请参见配置文件说明。
3.1.7	历史版本	2025-01-14	修改 mount 命令的参数，说明如下：新增 -mpt 、-spt 、-rps 、-mlh 、-ce 参数。更新 -rbs 参数，默认值由 3MB 改为 1MB。详情请参见挂载存储桶为本地文件系统目录（mount）。
3.1.6	历史版本	2024-12-16	新增 restore 参数，该参数用于恢复对象，详情请参见恢复对象（restore）。上传和拷贝对象时支持通过 -sc 参数指定对象的存储类型，详情请参见以下文档：上传对象（cp）拷贝对象（cp）
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://m645b3e1bb36e-mrap.mrap.accesspoint.tos-global.volces.com/linux/amd64/tosutil && chmod a+x tosutil

macOS AMD64

wget https://m645b3e1bb36e-mrap.mrap.accesspoint.tos-global.volces.com/darwin/amd64/tosutil && chmod a+x tosutil

macOS ARM64

wget https://m645b3e1bb36e-mrap.mrap.accesspoint.tos-global.volces.com/darwin/arm64/tosutil && chmod a+x tosutil

Windows

wget https://m645b3e1bb36e-mrap.mrap.accesspoint.tos-global.volces.com/windows/tosutil -O tosutil.exe

最近更新时间：2026.05.19 17:30:52

这个页面对您有帮助吗？

有用

无用