> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置 ossctl

> 了解如何获取访问密钥、下载并配置 ossctl。

`ossctl` 是访问 OSS 的命令行工具。配置完成后，您可以通过命令行上传、下载和列出 OSS 存储桶中的对象。

## 操作前确认

* 已创建需要访问的 OSS 存储桶（Bucket），并已获得访问该存储桶的权限。
* 当前环境可以访问存储桶所在地域的 OSS 访问端点。

## 获取访问端点

1. 登录 [GPU 云服务控制台](https://console.siflow.cn/gpu-cloud/home)，进入 **存储 > 对象存储** 页面。

2. 在右上角选择存储桶所在地域。

3. 在 **存储桶** 页签中，复制列表上方展示的 **访问端点**。

   不同地域使用不同访问端点。配置 `ossctl` 时，请使用存储桶所在地域对应的访问端点。

## 获取访问密钥

1. 进入 **存储 > 对象存储** 页面。

2. 单击 **访问密钥** 页签，然后创建访问密钥。

3. 配置访问密钥参数，然后提交。

   | 参数 | 说明 |
   | - | - |
   | **Access Key** | 系统生成的访问密钥 ID。 |
   | **Secret Key** | 系统生成的访问密钥 Secret。 |
   | **过期时间** | 访问密钥过期时间。 |
   | **名称** | 访问密钥名称，用于区分不同用途的密钥。 |
   | **描述** | 访问密钥说明，可填写使用场景或管理备注。 |

4. 保存生成的 Access Key 和 Secret Key。

<Warning>
  Secret Key 仅用于访问鉴权。请妥善保存，不要通过公开渠道传递或写入日志。
</Warning>

## 下载 ossctl

根据本地操作系统下载 `ossctl`。

### Windows 下载

```bash theme={null}
curl -LO https://oss-cn-shanghai.siflow.cn/oss-tools/packages/ossctl/latest/windows-amd64/ossctl.exe
```

### Linux amd64 下载

```bash theme={null}
curl -LO https://oss-cn-shanghai.siflow.cn/oss-tools/packages/ossctl/latest/linux-amd64/ossctl
```

### macOS amd64 下载

```bash theme={null}
curl -LO https://oss-cn-shanghai.siflow.cn/oss-tools/packages/ossctl/latest/darwin-amd64/ossctl
```

### macOS arm64 下载

```bash theme={null}
curl -LO https://oss-cn-shanghai.siflow.cn/oss-tools/packages/ossctl/latest/darwin-arm64/ossctl
```

## 配置 OSS

下载完成后，按操作系统添加 OSS 访问配置。

### Linux 或 macOS 配置

```bash theme={null}
chmod +x ossctl
./ossctl config add <CONFIGNAME> <ENDPOINT> <ACCESSKEY> <SECRETKEY>
```

### Windows 配置

```powershell theme={null}
.\ossctl.exe config add <CONFIGNAME> <ENDPOINT> <ACCESSKEY> <SECRETKEY>
```

### 参数说明

| 参数 | 说明 |
| - | - |
| `<CONFIGNAME>` | 本地 OSS 访问配置名称。您可以根据需要替换为自定义名称。 |
| `<ENDPOINT>` | 存储桶所在地域的 OSS 访问端点。 |
| `<ACCESSKEY>` | 访问密钥中的 Access Key。 |
| `<SECRETKEY>` | 访问密钥中的 Secret Key。 |

## 验证配置

配置完成后，可以列出已授权存储桶中的对象，验证 `ossctl` 是否可用。

```bash theme={null}
./ossctl ls <CONFIGNAME>/<BUCKET>
```

其中：

* `<CONFIGNAME>` 是本地 OSS 访问配置名称。
* `<BUCKET>` 是已授权访问的存储桶名称。

如果命令执行失败，请先检查访问端点、访问密钥、配置名称、存储桶授权和网络连通性。如果仍无法解决，请记录错误信息并联系技术支持。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.