如何安装ossutil_对象存储(OSS)-阿里云帮助中心

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

版本

当前版本：2.1.2

下载ossutil

下载地址	SHA256校验和
Linux x86 32bit	3002f1334e65eb3b2b6f31feccc35cb9142c114e276c23371157432a20665201
Linux x86 64bit	133bf2dc824b221710f4ff34fdc82b4b8b1b557cf79f2b684ea9e1af4161acaf
Linux ARM 32bit	fddac6d5dcaa8eecde8afa365d73ae5a5538c51b7a3854d79be251483acb2f86
Linux ARM 64bit	7b0fc62939f6d0a6efb9f8e1d07a8fa4fc45817827628a4624d3b467a7bac5a1
macOS x86 64bit	20e685892bcc0b8a3731082409471735641f5359fc55c46890ec882f5441fec8
macOS ARM 64bit	8de04983ec17c8d1ce7ddfd99e031b7ad69fe385d57d9957f4a10f93f2da73af
Windows x86 32bit	4b820504c9d5df2486fbb1245a86fd2011f5a098f6795656adfa14d687031323
Windows x86 64bit	ea4bf1e8451b6e3d557f968bd77ff26586c95f5f6061fa560cadaff388a775f3
Windows 7, Windows 8, Windows Server 2008R2	0d84a7f38fbb97f97fbe06a06f3669de3b47082ade9347df4c92a8af1082bb6b

安装ossutil

Linux

安装ossutil。
1. 下载ossutil压缩包。
```
curl -o ossutil-2.1.2-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2/2.1.2/ossutil-2.1.2-linux-amd64.zip
```
  说明
  此处以Linux x86 64bit为例进行介绍。其他系统下载地址，请参见下载ossutil。
2. 在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.1.2-linux-amd64.zip
```
3. 进入ossutil-2.1.2-linux-amd64目录。
```
cd ossutil-2.1.2-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的帮助信息即表示安装成功。

配置ossutil。

输入配置命令。
```
ossutil config
```
根据提示设置配置文件路径。您可以直接回车使用默认的配置文件路径。
```
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
```

根据提示分别设置AccessKey ID、AccessKey Secret、地域ID信息。

输入您创建的AccessKey ID。

Please enter Access Key ID [****************id]:LTAI****************

输入您创建的AccessKey Secret。

Please enter Access Key Secret [****************sk]:R6vg*********************

输入您的OSS的数据中心所在的地域，如无任何输入，默认值为cn-hangzhou。
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
输入您的OSS的数据中心的Endpoint，如果您不需要自定义 Endpoint，可以直接按回车跳过该参数的配置。
在上一步配置完地域信息后，将默认使用该地域 ID 对应的外网 Endpoint。例如，如果您设置的 region-id 为 cn-hangzhou，默认使用的外网 Endpoint 是 https://oss-cn-hangzhou.aliyuncs.com。
如果您需要自定义 OSS 数据中心所在地域的 Endpoint，请输入您的 Endpoint 信息。例如，如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint如https://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控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。创建完成后，在输出中，复制创建的AccessKey。
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

安装ossutil。
1. 请根据您的系统架构或系统版本下载对应的安装包：
  - x86_32架构：Windows x86 32bit。
  - x86_64架构：Windows x86 64bit。
  - Windows 7、Windows8以及Windows Server 2008R2系统版本请下载：Windows 7, Windows 8, Windows Server 2008R2。
2. 将下载好的.zip压缩包解压到目标文件夹，然后进入解压后的目录，如图所示。
3. 复制当前解压后ossutil文件夹路径配置系统环境变量。
  1. 单击当前目录的路径栏，复制其中显示的当前文件夹路径。
  2. 打开环境变量对话框，在系统变量栏中找到并双击Path变量，单击新建按钮，然后将复制好的ossutil文件夹路径粘贴到新的条目框中。
4. 打开命令行，执行ossutil命令，返回ossutil的帮助信息即表示安装成功。
```
ossutil
```

配置ossutil。

输入配置命令。
```
ossutil config
```
根据提示设置配置文件路径。您可以直接回车使用默认的配置文件路径。
```
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
```

根据提示分别设置AccessKey ID、AccessKey Secret、地域ID信息。

输入您创建的AccessKey ID。

Please enter Access Key ID [****************id]:LTAI****************

输入您创建的AccessKey Secret。

Please enter Access Key Secret [****************sk]:R6vg*********************

输入您的OSS的数据中心所在的地域，如无任何输入，默认值为cn-hangzhou。
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
输入您的OSS的数据中心的Endpoint，如果您不需要自定义 Endpoint，可以直接按回车跳过该参数的配置。
在上一步配置完地域信息后，将默认使用该地域 ID 对应的外网 Endpoint。例如，如果您设置的 region-id 为 cn-hangzhou，默认使用的外网 Endpoint 是 https://oss-cn-hangzhou.aliyuncs.com。
如果您需要自定义 OSS 数据中心所在地域的 Endpoint，请输入您的 Endpoint 信息。例如，如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint如https://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控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。创建完成后，在输出中，复制创建的AccessKey。
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

安装ossutil。
1. 下载ossutil压缩包。
```
curl -o ossutil-2.1.2-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2/2.1.2/ossutil-2.1.2-mac-arm64.zip
```
  说明
  此处以macOS ARM 64bit为例进行介绍。其他系统下载地址，请参见下载ossutil。
2. 在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.1.2-mac-arm64.zip
```
3. 进入ossutil-2.1.2-mac-arm64目录。
```
cd ossutil-2.1.2-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的帮助信息即表示安装成功。

配置ossutil。

输入配置命令。
```
ossutil config
```
根据提示设置配置文件路径。您可以直接回车使用默认的配置文件路径。
```
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
```

根据提示分别设置AccessKey ID、AccessKey Secret、地域ID信息。

输入您创建的AccessKey ID。

Please enter Access Key ID [****************id]:LTAI****************

输入您创建的AccessKey Secret。

Please enter Access Key Secret [****************sk]:R6vg*********************

输入您的OSS的数据中心所在的地域，如无任何输入，默认值为cn-hangzhou。
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
输入您的OSS的数据中心的Endpoint，如果您不需要自定义 Endpoint，可以直接按回车跳过该参数的配置。
在上一步配置完地域信息后，将默认使用该地域 ID 对应的外网 Endpoint。例如，如果您设置的 region-id 为 cn-hangzhou，默认使用的外网 Endpoint 是 https://oss-cn-hangzhou.aliyuncs.com。
如果您需要自定义 OSS 数据中心所在地域的 Endpoint，请输入您的 Endpoint 信息。例如，如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint如https://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控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。创建完成后，在输出中，复制创建的AccessKey。
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地域和访问域名。