安装ossutil

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

版本

当前版本:2.0.6-beta.01091200

下载ossutil

下载地址

SHA256校验和

Linux x86 32bit

7f995a199daa964da2ea3552413ab3c8bd16fd3947beef123a9184515a4b7410

Linux x86 64bit

17991f8df09b0ca9c5d26d62be7dcb682f2963041f609351860b26259c6fa057

Linux ARM 32bit

2112346bbaa379291d96353f657659c99ee6758cad99435f3162eb9c23ce5561

Linux ARM 64bit

8ab900bb4cc73be43aa317d76a2d21f0650600b7a474e524fbb2e6e8ddc13d41

macOS x86 64bit

0271a091d068c135b23927faa21e2b826d8e0b629ea7d84a2927577c03a56187

macOS ARM 64bit

8d958e96162dc8541fd99a4a501cac2b9344a95c2f95c57c5d8566f35f45d949

Windows x86 32bit

6338cac0d260dc5ad3fcec65c7bd68f2b2458efd5d1b2e626eeb74e30adc1ec7

Windows x86 64bit

45e4f9903f760c28cd1d37c1fbbfb91c0e75966509d33a144a53ae05f33d94c7

Windows 7, Windows 8, Windows Server 2008R2

c2aa344d14206cf4914274d72e6cc1a3bae75d7a8d03430cbb729cda006afb76

安装ossutil

Linux

  1. 安装ossutil。

    1. 下载ossutil压缩包。

      curl -o ossutil-2.0.6-beta.01091200-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.6-beta.01091200/ossutil-2.0.6-beta.01091200-linux-amd64.zip
      说明

      此处以Linux x86 64bit为例进行介绍。其他系统下载地址,请参见下载ossutil

    2. 在下载压缩包的所在目录执行以下解压命令。

      unzip ossutil-2.0.6-beta.01091200-linux-amd64.zip
    3. 进入ossutil-2.0.6-beta.01091200-linux-amd64目录。

      cd ossutil-2.0.6-beta.01091200-linux-amd64
    4. 在当前目录执行以下命令。

      chmod 755 ossutil
    5. 执行以下命令,实现ossutil的全局调用。

      sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
    6. 验证是否成功安装ossutil。

      ossutil

      返回ossutil的帮助信息即表示安装成功。

  2. 配置ossutil。

    1. 输入配置命令。

      ossutil config
    2. 根据提示设置配置文件路径。您可以直接回车使用默认的配置文件路径。

      Please enter the config file name,the file name can include path(default /root/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):

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

      ossutil ls oss://examplebucket -c /home/config
    3. 根据提示分别设置AccessKey ID、AccessKey Secret、地域ID信息。

      1. 输入您创建的AccessKey ID。

        Please enter Access Key ID [****************id]:LTAI****************
      2. 输入您创建的AccessKey Secret。

        Please enter Access Key Secret [****************sk]:R6vg*********************
      3. 输入您的OSS的数据中心所在的地域,如无任何输入,默认值为cn-hangzhou。

        Please enter Region [cn-hangzhou]:cn-hangzhou
      4. 输入您的OSS的数据中心的Endpoint,如果您不需要自定义 Endpoint,可以直接按回车跳过该参数的配置。

        在上一步配置完地域信息后,将默认使用该地域 ID 对应的外网 Endpoint。例如,如果您设置的 region-idcn-hangzhou,默认使用的外网 Endpoint 是 https://oss-cn-hangzhou.aliyuncs.com

        如果您需要自定义 OSS 数据中心所在地域的 Endpoint,请输入您的 Endpoint 信息。例如,如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpointhttps://oss-cn-hangzhou-internal.aliyuncs.com

        Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com

      参数说明如下:

      参数

      是否必填

      说明

      accessKeyID

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

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

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

      1.png

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

      1.png

      accessKeySecret

      Region

      填写Bucket所在的地域ID,本文以杭州地域为例,设置为cn-hangzhou,其他地域的ID参见OSS地域和访问域名

      endpoint

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

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

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

Windows

  1. 安装ossutil。

    1. 请根据您的系统架构或系统版本下载对应的安装包:

    2. 将下载好的.zip压缩包解压到目标文件夹,然后进入解压后的目录,如图所示。

      image

    3. 复制当前解压后ossutil文件夹路径配置系统环境变量。

      1. 单击当前目录的路径栏,复制其中显示的当前文件夹路径。

        image

      2. 打开环境变量对话框,在系统变量栏中找到并双击Path变量,单击新建按钮,然后将复制好的ossutil文件夹路径粘贴到新的条目框中。

        image

    4. 打开命令行,执行ossutil命令,返回ossutil的帮助信息即表示安装成功。

      ossutil
  2. 配置ossutil。

    1. 输入配置命令。

      ossutil config
    2. 根据提示设置配置文件路径。您可以直接回车使用默认的配置文件路径。

      Please enter the config file name,the file name can include path(default "C:\Users\issuser\.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):

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

      ossutil ls oss://examplebucket -c c:\ossutil\config
    3. 根据提示分别设置AccessKey ID、AccessKey Secret、地域ID信息。

      1. 输入您创建的AccessKey ID。

        Please enter Access Key ID [****************id]:LTAI****************
      2. 输入您创建的AccessKey Secret。

        Please enter Access Key Secret [****************sk]:R6vg*********************
      3. 输入您的OSS的数据中心所在的地域,如无任何输入,默认值为cn-hangzhou。

        Please enter Region [cn-hangzhou]:cn-hangzhou
      4. 输入您的OSS的数据中心的Endpoint,如果您不需要自定义 Endpoint,可以直接按回车跳过该参数的配置。

        在上一步配置完地域信息后,将默认使用该地域 ID 对应的外网 Endpoint。例如,如果您设置的 region-idcn-hangzhou,默认使用的外网 Endpoint 是 https://oss-cn-hangzhou.aliyuncs.com

        如果您需要自定义 OSS 数据中心所在地域的 Endpoint,请输入您的 Endpoint 信息。例如,如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpointhttps://oss-cn-hangzhou-internal.aliyuncs.com

        Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com

      参数说明如下:

      参数

      是否必填

      说明

      accessKeyID

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

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

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

      1.png

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

      1.png

      accessKeySecret

      Region

      填写Bucket所在的地域ID,本文以杭州地域为例,设置为cn-hangzhou,其他地域的ID参见OSS地域和访问域名

      endpoint

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

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

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

macOS

  1. 安装ossutil。

    1. 下载ossutil压缩包。

      curl -o ossutil-2.0.6-beta.01091200-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.6-beta.01091200/ossutil-2.0.6-beta.01091200-mac-arm64.zip
      说明

      此处以macOS ARM 64bit为例进行介绍。其他系统下载地址,请参见下载ossutil

    2. 在下载压缩包的所在目录执行以下解压命令。

      unzip ossutil-2.0.6-beta.01091200-mac-arm64.zip
    3. 进入ossutil-2.0.6-beta.01091200-mac-arm64目录。

      cd ossutil-2.0.6-beta.01091200-mac-arm64
    4. 在当前目录执行以下命令。

      chmod 755 ossutil
    5. 执行以下命令,实现ossutil的全局调用。

      sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
    6. 验证是否成功安装ossutil。

      ossutil

      返回ossutil的帮助信息即表示安装成功。

  2. 配置ossutil。

    1. 输入配置命令。

      ossutil config
    2. 根据提示设置配置文件路径。您可以直接回车使用默认的配置文件路径。

      Please enter the config file name,the file name can include path(default "/Users/user/.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands): 

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

      ossutil ls oss://examplebucket -c /home/config
    3. 根据提示分别设置AccessKey ID、AccessKey Secret、地域ID信息。

      1. 输入您创建的AccessKey ID。

        Please enter Access Key ID [****************id]:LTAI****************
      2. 输入您创建的AccessKey Secret。

        Please enter Access Key Secret [****************sk]:R6vg*********************
      3. 输入您的OSS的数据中心所在的地域,如无任何输入,默认值为cn-hangzhou。

        Please enter Region [cn-hangzhou]:cn-hangzhou
      4. 输入您的OSS的数据中心的Endpoint,如果您不需要自定义 Endpoint,可以直接按回车跳过该参数的配置。

        在上一步配置完地域信息后,将默认使用该地域 ID 对应的外网 Endpoint。例如,如果您设置的 region-idcn-hangzhou,默认使用的外网 Endpoint 是 https://oss-cn-hangzhou.aliyuncs.com

        如果您需要自定义 OSS 数据中心所在地域的 Endpoint,请输入您的 Endpoint 信息。例如,如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpointhttps://oss-cn-hangzhou-internal.aliyuncs.com

        Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com

      参数说明如下:

      参数

      是否必填

      说明

      accessKeyID

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

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

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

      1.png

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

      1.png

      accessKeySecret

      Region

      填写Bucket所在的地域ID,本文以杭州地域为例,设置为cn-hangzhou,其他地域的ID参见OSS地域和访问域名

      endpoint

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

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

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