ossutil支持在Windows、Linux、macOS等系统中运行,您可以根据实际环境下载和安装合适的版本。

版本和运行环境

  • 版本
    • 当前版本:1.7.14
    • 历史版本:关于ossutil各版本源代码以及发布记录的更多信息,请参见GitHub
  • 运行环境
    • Windows、Linux、macOS
    • 支持架构:x86(32bit、64bit)、ARM(32bit、64bit)

下载地址

ossutil1.7.8版本基于Golang 1.16版本编译,不支持通过macOS x86 32bit操作系统使用ossutil。因此,ossutil1.7.8及以上版本均不再提供ossutilmac32安装包。

根据您的操作系统下载对应版本,然后按如下步骤安装并配置ossutil,以下均以64位系统为例。

Linux系统安装

  1. 运行以下命令下载ossutil。
    wget https://gosspublic.alicdn.com/ossutil/1.7.14/ossutil64                           
    注意 复制下载地址时会自动加上spm编码内容,使用wget命令下载时注意删除链接中?spm=xxxx的内容。
  2. 运行以下命令修改文件执行权限。
    chmod 755 ossutil64
  3. 使用交互式配置生成配置文件。
    1. 输入配置命令。
      ./ossutil64 config
    2. 根据提示设置配置文件路径。
      建议直接按回车使用默认配置文件的路径。
      请输入配置文件名,文件名可以带路径(默认为:/home/user/.ossutilconfig,回车将使用默认路径。
      如果用户设置为其它路径,在使用命令时需要将--config-file选项设置为该路径): 

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

      ./ossutil64 ls oss://examplebucket -c /home/config
    3. 根据提示设置工具的语言。
      请输入语言CHEN。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。
    4. 根据提示分别设置Endpoint、AccessKey ID、AccessKey Secret和STSToken参数。
      参数说明如下:
      参数 说明
      endpoint 填写Bucket所在地域的Endpoint。关于各地域Endpoint的更多信息,请参见访问域名和数据中心

      您也可以增加http://https://指定ossutil访问OSS使用的协议,默认使用HTTP协议。例如,使用HTTPS协议访问华东1(杭州)的Bucket,设置为https://oss-cn-hangzhou.aliyuncs.com

      accessKeyID 填写账号的AccessKey。
      accessKeySecret
      stsToken 使用STS临时授权账号访问OSS时需要配置该项,否则置空即可。关于stsToken的生成方式,请参见临时访问凭证
      说明 关于配置文件的更多信息,请参见config
    5. 运行以下命令,验证是否已成功安装ossutil。
      ./ossutil64

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

Windows系统安装

  1. 单击下载链接下载Windows安装包。
  2. 将工具解压,并双击运行ossutil.bat文件。
  3. 运行以下命令,生成配置文件。
    D:\ossutil>ossutil64.exe config
  4. 根据提示设置配置文件。设置方法与Linux系统生成配置文件的方法相同。
  5. 运行以下命令,验证是否已成功安装ossutil。
    ossutil64.exe

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

macOS系统安装

  1. 运行以下命令下载ossutil。
    curl -o ossutilmac64 https://gosspublic.alicdn.com/ossutil/1.7.14/ossutilmac64
  2. 运行以下命令修改文件执行权限。
    chmod 755 ossutilmac64
  3. 运行以下命令,生成配置文件。
    ./ossutilmac64 config
  4. 根据提示设置配置文件。设置方法与Linux系统生成配置文件的方法相同。
  5. 运行以下命令,验证是否已成功安装ossutil。
    ./ossutilmac64

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

ARM系统安装

  1. 运行以下命令下载ossutil。
    wget https://gosspublic.alicdn.com/ossutil/1.7.14/ossutilarm64
  2. 运行以下命令修改文件执行权限。
    chmod 755 ossutilarm64
  3. 运行以下命令,生成配置文件。
    ./ossutilarm64 config
  4. 根据提示设置配置文件。设置方法与Linux系统生成配置文件的方法相同。
  5. 运行以下命令,验证是否已成功安装ossutil。
    ./ossutilarm64

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