当前位置：首页 > news >正文

linux服务器上安装oss对象存储（命令行工具使用oss）

news 2025/9/19 5:46:59

在 Linux 服务器上，使用阿里云的 OSS（对象存储服务） 需要安装并配置阿里云提供的命令行工具 ossutil。通过 ossutil，您可以方便地在命令行中管理 OSS 的存储空间（Bucket）和文件。以下是安装与使用 ossutil 的详细步骤：

1. 前置条件

在开始安装之前，需要确保以下准备工作完成：

阿里云账户：
- 已注册阿里云账户，并开通了 OSS 服务。
- 在阿里云控制台中，获取 AccessKey ID 和 AccessKey Secret。
服务器环境：
- Linux 操作系统。
- 已安装 wget 或其他下载工具。

2. 下载和安装 ossutil

2.1 下载 ossutil 工具

使用以下命令下载最新版本的 ossutil：

bash

wget http://gosspublic.alicdn.com/ossutil/1.7.16/ossutil64

注意：1.7.16 是当前最新版的版本号，可以访问阿里云官方文档检查最新版本。

2.2 设置执行权限

下载完成后，为 ossutil 文件赋予可执行权限：

bash

chmod +x ossutil64

2.3 移动到系统路径（可选）

为了方便全局使用 ossutil，可以将其移动到系统的环境变量路径中，例如 /usr/local/bin：

bash

sudo mv ossutil64 /usr/local/bin/ossutil

现在，您可以在终端中直接使用 ossutil 命令。

3. 配置 ossutil

在使用 ossutil 前，需要配置阿里云的 AccessKey 信息和默认区域。

3.1 配置命令

运行以下命令开始配置：

bash

ossutil config

系统会提示您输入以下信息：

Enter the endpoint：填写 OSS 的访问域名（Endpoint）。
- 示例：oss-cn-hongkong.aliyuncs.com（香港地域）。
- 您可以在 OSS 控制台的 Bucket 列表中查看相应的 Endpoint。
Enter the AccessKey ID：输入您的 AccessKey ID。
Enter the AccessKey Secret：输入您的 AccessKey Secret。

配置完成后，系统会显示类似以下信息：

plaintext

Config updated to: /root/.ossutilconfig

3.2 验证配置

运行以下命令验证配置是否成功：

bash

ossutil ls

如果配置成功，您将看到已创建的 Bucket 列表。

4. 常用操作命令

以下是一些常用的 ossutil 命令：

4.1 查看 Bucket 列表

bash

ossutil ls

4.2 创建 Bucket

bash

ossutil mb oss://<bucket-name>

示例：
bash
```
ossutil mb oss://my-bucket
```

4.3 删除 Bucket

bash

ossutil rb oss://<bucket-name>

示例：
bash
```
ossutil rb oss://my-bucket
```

4.4 上传文件到 OSS

bash

ossutil cp <local-file-path> oss://<bucket-name>/<object-name>

示例：

bash

ossutil cp /home/user/test.txt oss://my-bucket/test.txt

4.5 下载文件到本地

bash

ossutil cp oss://<bucket-name>/<object-name> <local-file-path>

示例：

bash

ossutil cp oss://my-bucket/test.txt /home/user/test.txt

4.6 查看文件列表

bash

ossutil ls oss://<bucket-name>/

示例：
bash
```
ossutil ls oss://my-bucket/
```

4.7 删除文件

bash

ossutil rm oss://<bucket-name>/<object-name>

示例：
bash
```
ossutil rm oss://my-bucket/test.txt
```

4.8 同步本地和 OSS 目录

bash

ossutil sync <local-folder> oss://<bucket-name>/<remote-folder>

示例：

bash

ossutil sync /home/user/data oss://my-bucket/data

5. 高级功能

5.1 设置文件的 ACL（访问权限控制）

可通过以下命令修改文件的访问权限：

bash

ossutil set-acl oss://<bucket-name>/<object-name> <acl>

ACL 值：
- private：私有权限。
- public-read：公共读权限。
- public-read-write：公共读写权限。

示例：

bash

ossutil set-acl oss://my-bucket/test.txt public-read

5.2 查看文件信息

查看 OSS 文件的详细信息：

bash

ossutil stat oss://<bucket-name>/<object-name>

示例：
bash
```
ossutil stat oss://my-bucket/test.txt
```

6. 常见问题及解决方法

6.1 无法连接 OSS

原因：网络问题或 Endpoint 配置错误。
解决办法：
- 确保服务器能够访问 oss-cn-hongkong.aliyuncs.com。
- 检查 Endpoint 是否正确（参考 OSS 控制台中的 Bucket 信息）。

6.2 提示权限不足

原因：AccessKey 的权限不足。
解决办法：
- 检查 AccessKey 是否具有对目标 Bucket 的读写权限。
- 在阿里云 RAM 控制台中调整 AccessKey 的权限策略。

6.3 文件上传速度慢

原因：网络延迟或带宽限制。
解决办法：
- 使用多线程上传：
  bash
```
ossutil cp <local-file-path> oss://<bucket-name>/<object-name> --parallel=10
```
- 尽量选择与服务器同一地域的 OSS Endpoint。