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

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

版本

当前版本：2.1.1

下载ossutil

下载地址	SHA256校验和
Linux x86 32bit	af77d281229d51df7fd15d645a842dec97f6be4eeb245db20f90f197ac1cdfb3
Linux x86 64bit	60f3a808cbbdfd4b5269b8f967c6a66f564c9dacff52d93a5d21a588976ab5a2
Linux ARM 32bit	0861cca6454307f884a4f54d73c8af42f8abe4fea4cb189b1481f37ca6aee3a8
Linux ARM 64bit	a22a50d528b54c806aeadbc65289ac03769b64265d2121e9221df7678bdb4f63
macOS x86 64bit	10a6b6189542c21577513e18e6d4804bf80d99e88a6264801bdb7b1ec4419725
macOS ARM 64bit	ee699ca71a98ca9d42ad345058376f10f4e917f452b454a3e26b59911c7b08fc
Windows x86 32bit	f2d8cf95e9718d894d3f207b05b0d4649636c862cf25a05e4e38f4291732c8e9
Windows x86 64bit	8797230d56ade91e7002fca3bdd72ab6a5e0d215867f0998241d91611afce120
Windows 7, Windows 8, Windows Server 2008R2	00b46eee2e9899a1cd6b26a3e6b8162f0f4dd488b4ae0afe2f84314b1f530701

安装ossutil

Linux

安装ossutil。
1. 下载ossutil压缩包。
```
curl -o ossutil-2.1.1-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2/2.1.1/ossutil-2.1.1-linux-amd64.zip
```
  说明
  此处以Linux x86 64bit为例进行介绍。其他系统下载地址，请参见下载ossutil。
2. 在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.1.1-linux-amd64.zip
```
3. 进入ossutil-2.1.0-linux-amd64目录。
```
cd ossutil-2.1.1-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.1-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2/2.1.1/ossutil-2.1.1-mac-arm64.zip
```
  说明
  此处以macOS ARM 64bit为例进行介绍。其他系统下载地址，请参见下载ossutil。
2. 在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.1.1-mac-arm64.zip
```
3. 进入ossutil-2.1.0-mac-arm64目录。
```
cd ossutil-2.1.1-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地域和访问域名。