全部产品
Search
文档中心

对象存储 OSS:安装ossutil

更新时间:Dec 10, 2024

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

版本升级

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

ossutil2.0重点功能如下:

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

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

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

  • 灵活的输出格式调整:新增--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. 根据提示设置工具的语言。请输入语言CHEN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。

    4. 本文以配置长期访问凭证为例,配置AccessKey ID、AccessKey Secret,STSToken设置为空。关于如何创建AccessKey和获取Endpoint,请参见创建AccessKeyOSS地域和访问域名。更多配置方式,请参见通过config命令进行快速配置

      说明

      如果使用STSToken进行临时访问授权,需获取临时访问凭证,具体内容请参见使用STS临时访问凭证访问OSS

      获取到临时访问凭证后,在配置STSToken、AccessKey ID、AccessKey Secret时,请填入临时访问凭证中的SecurityToken、AccessKey ID和AccessKey Secret。

  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. 根据提示设置工具的语言。请输入语言CHEN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。

    4. 本文以配置长期访问凭证为例,配置AccessKey ID、AccessKey Secret,STSToken设置为空。关于如何创建AccessKey和获取Endpoint,请参见创建AccessKeyOSS地域和访问域名。更多配置方式,请参见通过config命令进行快速配置

      说明

      如果使用STSToken进行临时访问授权,需获取临时访问凭证,具体内容请参见使用STS临时访问凭证访问OSS

      获取到临时访问凭证后,在配置STSToken、AccessKey ID、AccessKey Secret时,请填入临时访问凭证中的SecurityToken、AccessKey ID和AccessKey Secret。

  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. 根据提示设置工具的语言。请输入语言CHEN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。

    4. 本文以配置长期访问凭证为例,配置AccessKey ID、AccessKey Secret,STSToken设置为空。关于如何创建AccessKey和获取Endpoint,请参见创建AccessKeyOSS地域和访问域名。更多配置方式,请参见通过config命令进行快速配置

      说明

      如果使用STSToken进行临时访问授权,需获取临时访问凭证,具体内容请参见使用STS临时访问凭证访问OSS

      获取到临时访问凭证后,在配置STSToken、AccessKey ID、AccessKey Secret时,请填入临时访问凭证中的SecurityToken、AccessKey ID和AccessKey Secret。

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

    ossutil

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

相关文档

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