AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 对象存储 开发参考 常用工具 命令行工具ossutil 1.0 安装ossutil

安装ossutil

更新时间：
产品详情
我的收藏

当您需要快速上传大文件、下载文件、删除固定前缀文件时，可以使用ossutil工具。ossutil支持在Windows、Linux、macOS等系统中运行，您可以根据实际环境下载和安装合适的版本。

版本升级

推荐您使用全新升级的ossutil2.0，快速安装并使用，请参见安装ossutil。

ossutil2.0重点功能如下：

  • 全新的命令组织结构：引入了多级命令支持，包括API级命令（例如ossutil api put-bucket-acl）和高级命令（如ossutil config）。

  • 改进的配置管理机制：简化了初始配置流程，用户仅需提供AccessKey ID、AccessKey Secret及地域ID即可完成安装后的基础配置，并且支持通过--profile参数指定多个配置文件，增强了灵活性。

  • 丰富的过滤参数：对于批量处理命令（如ls、cp、rm等），新增了基于路径、文件大小、修改时间以及对象元数据等多种过滤条件的支持，极大地提升了操作的精确性和效率。

  • 灵活的输出格式调整：新增--output-format参数，允许用户将输出格式设定为JSON、YAML或XML，以便更好地适配不同的数据处理需求；同时引入了--output-query选项，让用户能够对输出内容进行筛选，获取所需信息。

  • 安全性增强：为了提高安全性，ossutil 2.0支持通过环境变量设置敏感参数，避免在命令行中直接暴露密钥，减少了泄露风险；此外，新增的--dry-run选项使用户能够在实际执行命令前验证其行为，确保操作无误。

版本

  • 当前版本：1.7.19

  • 历史版本：关于ossutil各版本源代码以及发布记录的更多信息，请参见GitHub。

下载地址

下载地址

SHA256校验和

Linux x86 32bit

f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86

Linux x86 64bit

dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343

Linux ARM 32bit

ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d

Linux ARM 64bit

f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57

macOS 64bit

9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe

macOS ARM 64bit

10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5

Windows x86 32bit

772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799

Windows x86 64bit

8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

下载并安装ossutil

Linux

  1. 安装ossutil。

    sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
    说明

    • 安装过程中，需要使用解压工具（unzip、7z）解压软件包，请提前安装其中的一个解压工具。

    • 安装完成后，ossutil会安装到/usr/bin/目录下。

  2. 配置ossutil。

    1. 输入配置命令。

      ossutil config

    2. 根据提示设置配置文件路径。

      请输入配置文件名，文件名可以带路径（默认为：/home/user/.ossutilconfig，回车将使用默认路径。
如果用户设置为其它路径，在使用命令时需要将--config-file选项设置为该路径）：

      ossutil默认使用/home/user/.ossutilconfig作为配置文件，若您设置了配置文件的路径，则每次使用命令时需增加-c选项指定配置文件。例如配置文件保存为/home/config，使用ls时，命令格式如下：

      ossutil ls oss://examplebucket -c /home/config

    3. 根据提示设置工具的语言。请输入语言CH或EN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。

    4. 根据提示设置工具的语言。

      请输入语言CH或EN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。

    5. 根据提示分别设置Endpoint、AccessKey ID、AccessKey Secret和STSToken参数。使用STS临时授权账号访问OSS时需要配置STSToken，否则置空跳过即可。

      参数说明如下：

      参数

      是否必填

      说明

      endpoint

      是

      填写Bucket所在地域的Endpoint。例如，使本示例使用华东1（杭州）外网Endpoint，设置为https://oss-cn-hangzhou.aliyuncs.com。

      如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint，设置为https://oss-cn-hangzhou-internal.aliyuncs.com。

      关于各地域Endpoint的更多信息，请参见OSS地域和访问域名。

      accessKeyID

      是

      填写账号的AccessKey，AccessKey的获取方式，请参见创建AccessKey。

      使用ROS脚本快速创建有OSS管理权限的RAM用户AccessKey

      在资源编排ROS控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。

      1.png

      创建完成后，在输出中，复制创建的AccessKey。

      image

      accessKeySecret

      是

      stsToken

      否

      使用STS临时授权账号访问OSS时需要配置该项，否则置空跳过即可。关于stsToken的生成方式，请参见AssumeRole - 获取扮演角色的临时身份凭证。

  3. 验证是否已成功安装ossutil。

    ossutil

    如果屏幕中输出ossutil所有支持的命令，表明已成功安装ossutil。

Windows

  1. 安装ossutil。

    1. 单击下载链接下载Windows安装包。

    2. 将工具解压，并双击运行ossutil.bat文件。

  2. 配置ossutil。

    1. 输入配置命令。

      ossutil config

    2. 根据提示设置配置文件路径。

      请输入配置文件名，文件名可以带路径（默认为：C:\\Users\user\.ossutilconfig，回车将使用默认路径。
如果用户设置为其它路径，在使用命令时需要将--config-file选项设置为该路径）：

      ossutil默认使用C:\\Users\user\.ossutilconfig作为配置文件，若您设置了配置文件的路径，则每次使用命令时需增加-c选项指定配置文件。例如配置文件保存为c:\ossutil\config，使用ls时，命令格式如下：

      ossutil ls oss://examplebucket -c c:\ossutil\config

    3. 根据提示设置工具的语言。请输入语言CH或EN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。

    4. 根据提示分别设置Endpoint、AccessKey ID、AccessKey Secret和STSToken参数。使用STS临时授权账号访问OSS时需要配置STSToken，否则置空跳过即可。

      参数说明如下：

      参数

      是否必填

      说明

      endpoint

      是

      填写Bucket所在地域的Endpoint。例如，使本示例使用华东1（杭州）外网Endpoint，设置为https://oss-cn-hangzhou.aliyuncs.com。

      如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint，设置为https://oss-cn-hangzhou-internal.aliyuncs.com。

      关于各地域Endpoint的更多信息，请参见OSS地域和访问域名。

      accessKeyID

      是

      填写账号的AccessKey，AccessKey的获取方式，请参见创建AccessKey。

      使用ROS脚本快速创建有OSS管理权限的RAM用户AccessKey

      在资源编排ROS控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。

      1.png

      创建完成后，在输出中，复制创建的AccessKey。

      1.png

      accessKeySecret

      是

      stsToken

      否

      使用STS临时授权账号访问OSS时需要配置该项，否则置空跳过即可。关于stsToken的生成方式，请参见AssumeRole - 获取扮演角色的临时身份凭证。

  3. 验证是否已成功安装ossutil。

    ossutil

    如果屏幕中输出ossutil所有支持的命令，表明已成功安装ossutil。

macOS

  1. 安装ossutil。

    sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
    说明

    默认安装到/usr/local/bin目录下。

  2. 配置ossutil。

    1. 输入配置命令。

      ossutil config

    2. 根据提示设置配置文件路径。

      请输入配置文件名，文件名可以带路径（默认为：/Users/user/.ossutilconfig，回车将使用默认路径。
如果用户设置为其它路径，在使用命令时需要将--config-file选项设置为该路径）：

      ossutil默认使用/Users/user/.ossutilconfig作为配置文件。

      若您设置了配置文件的路径，则每次使用命令时需增加-c选项指定配置文件。例如配置文件保存为/home/config，使用ls时，命令格式如下：

      ossutil ls oss://examplebucket -c /home/config

    3. 根据提示设置工具的语言。请输入语言CH或EN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。

    4. 根据提示分别设置Endpoint、AccessKey ID、AccessKey Secret和STSToken参数。使用STS临时授权账号访问OSS时需要配置STSToken，否则置空跳过即可。

      参数说明如下：

      参数

      是否必填

      说明

      endpoint

      是

      填写Bucket所在地域的Endpoint。例如，使本示例使用华东1（杭州）外网Endpoint，设置为https://oss-cn-hangzhou.aliyuncs.com。

      如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint，设置为https://oss-cn-hangzhou-internal.aliyuncs.com。

      关于各地域Endpoint的更多信息，请参见OSS地域和访问域名。

      accessKeyID

      是

      填写账号的AccessKey，AccessKey的获取方式，请参见创建AccessKey。

      使用ROS脚本快速创建有OSS管理权限的RAM用户AccessKey

      在资源编排ROS控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。

      1.png

      创建完成后，在输出中，复制创建的AccessKey。

      1.png

      accessKeySecret

      是

      stsToken

      否

      使用STS临时授权账号访问OSS时需要配置该项，否则置空跳过即可。关于stsToken的生成方式，请参见AssumeRole - 获取扮演角色的临时身份凭证。

  3. 验证是否已成功安装ossutil。

    ossutil

    如果屏幕中输出ossutil所有支持的命令，表明已成功安装ossutil。

相关文档

安装ossutil成功后，您可以按需上传、下载、拷贝、删除文件等。更多信息，请参见cp（上传文件）、cp（下载文件）、cp（拷贝文件）和rm（删除）。

上一篇：命令行工具ossutil 1.0下一篇：配置ossutil