ossutil 2.0 使用指南

此工具适合专业人士，熟悉命令行操作。ossutil支持在Windows、Linux、macOS等系统中运行，您可以根据实际环境下载和安装合适的版本

Linux

macOS

Windows

使用 curl 获取安装包：

curl -o ossutil-2.2.1-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2/2.2.1/ossutil-2.2.1-linux-amd64.zip

在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.2.1-linux-amd64.zip
```
进入ossutil-2.2.1-linux-amd64目录。
```
cd ossutil-2.2.1-linux-amd64
```
授予执行权限
```
chmod 755 ossutil
```
无需全局安装，完成以上步骤后已经可以使用 ossutil；在当前目录可通过相对路径执行，也可以在任意目录通过绝对路径执行。可先在当前目录执行以下命令验证是否可用：
```
./ossutil
```
可选：如果希望普通用户在任意目录下都能直接使用 ossutil 命令，可将其放到当前用户目录下并加入 PATH。此步骤仅用于简化命令输入，不影响当前目录下通过 ./ossutil 使用。
```
mkdir -p "$HOME/.local/bin" && mv ossutil "$HOME/.local/bin/ossutil"
export PATH="$HOME/.local/bin:$PATH"
```
可选：完成第 6 步后，可执行以下命令验证 PATH 配置是否成功。此步骤仅用于确认命令行环境配置，不是安装必需步骤；如果不想配置 PATH，也可以继续在当前目录使用 ./ossutil，或在任意目录使用 ossutil 文件的绝对路径。
```
ossutil
```
可选：如需系统级全局调用，再根据实际环境使用 sudo 将其放到 /usr/local/bin。此步骤仅在需要给多个用户共享或希望以系统级命令方式调用时才需要，普通用户场景通常不必执行。

打开终端，使用 curl 获取安装包，以mac-arm64架构为例：

curl -o ossutil-2.2.1-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2/2.2.1/ossutil-2.2.1-mac-arm64.zip

在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.2.1-mac-arm64.zip
```
进入ossutil目录。
```
cd ossutil-2.2.1-mac-arm64
```
授予执行权限
```
chmod 755 ossutil
```
无需全局安装，完成以上步骤后已经可以使用 ossutil；在当前目录可通过相对路径执行，也可以在任意目录通过绝对路径执行。可先在当前目录执行以下命令验证是否可用：
```
./ossutil
```
可选：如果希望普通用户在任意目录下都能直接使用 ossutil 命令，可将其放到当前用户目录下并加入 PATH。此步骤仅用于简化命令输入，不影响当前目录下通过 ./ossutil 使用。
```
mkdir -p "$HOME/.local/bin" && mv ossutil "$HOME/.local/bin/ossutil"
export PATH="$HOME/.local/bin:$PATH"
```
可选：完成第 6 步后，可执行以下命令验证 PATH 配置是否成功。此步骤仅用于确认命令行环境配置，不是安装必需步骤；如果不想配置 PATH，也可以继续在当前目录使用 ./ossutil，或在任意目录使用 ossutil 文件的绝对路径。
```
ossutil
```
可选：如需系统级全局调用，再根据实际环境使用 sudo 将其放到 /usr/local/bin。此步骤仅在需要给多个用户共享或希望以系统级命令方式调用时才需要，普通用户场景通常不必执行。

下载 ossutil x86 64bit
将下载好的.zip压缩包解压到目标文件夹，然后进入解压后的目录。
复制当前解压后ossutil文件夹路径配置系统环境变量。

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

b.打开环境变量对话框，在系统变量栏中找到并双击Path变量，单击新建按钮，然后将复制好的ossutil文件夹路径粘贴到新的条目框中。
验证安装成功：执行ossutil命令返回帮助信息即表示安装成功。
```
ossutil
```

输入命令行下载数据，请先创建好保存目录。

注意：和原来的ossutil 1.0 命令有所不同，去除-e Endpoint参数，添加--region参数，请注意版本正确

ossutil cp -rfu 填写OSS路径 填写本地保存路径 -i 填写AccessKeyId -k 填写AccessKeySecret --region 填写region

示例

ossutil cp -rfu oss://bucket/dest/ D:/localpath/ -i LTA4*** -k MYW**** --region cn-hangzhou

参数解释如下

accessKeyID：详见发货邮件

accessKeySecret：详见发货邮件

OSS路径：发货邮件中预设 OSS 路径

区域region:发货邮件中为 oss-cn-hangzhou 该参数请填写 cn-hangzhou (去除"OSS-"前缀)

耐心等待下载完成，下载速度取决于您的带宽。

#ossutil 2.0 使用指南