> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-zh/byos/connecting-shade-to-wasabi.md).

# 将 Shade 连接到 Wasabi

Shade 支持自带 S3（BYOS3），兼容多种提供商，如 AWS、GCP、MinIO、Wasabi、Backblaze 等。以下是如何将 Shade 连接到你现有的 Wasabi 账户。

### 在 Wasabi 中配置新存储桶

{% hint style="info" %}
虽然并非严格必须配置一个新存储桶，但我们强烈建议为 Shade 配置一个新存储桶。由于 ShadeFS 的特性，Shade 无法使用现有存储桶中的文件。Shade 将创建两个新文件夹 `blobs` 和 `chunks` 到你连接的任何存储桶中。
{% endhint %}

如果你还没有 Wasabi 账户，可以创建一个账户 [这里](https://console.wasabisys.com)。要在 Wasabi 中创建新存储桶，请登录你的账户，前往 Buckets，然后点击“Create Bucket”。

<figure><img src="/files/c9377a621926511e6cefacaf0f4fcc27eb825d32" alt=""><figcaption></figcaption></figure>

按照步骤和提示操作时，请务必记住你的 **存储桶名称**，以及你的 **存储桶区域** （这些信息很重要，并会在后续步骤中使用）。 *在这种情况下，我们的存储桶名称是“shade-bucket”，区域（未显示）是 us-east-1。*

{% hint style="info" %}
ShadeFS 不要求在该存储桶上设置任何其他特定属性。你可以根据业务需要选择复制数据、记录日志或设置版本控制。
{% endhint %}

#### 关于 CORS 的特别说明

跨域资源共享（Cross-Origin Resource Sharing）是一项重要特性，它允许存储桶可从其他来源访问（例如 <https://app.shade.inc>）。这对 Shade 来说至关重要，因为它需要通过我们的应用为你访问并下载原始媒体。默认情况下 [默认](https://docs.wasabi.com/apidocs/operations-on-buckets#bucket-crossorigin-resource-sharing-cors-support)，Wasabi 已正确设置 CORS 以允许所有来源。不过，如果你更改或限制了来源，则需要将 `*.shade.inc` 加入允许来源白名单。

你可以在仪表板中更新配置，正确的 JSON 如下：&#x20;

```
[
  {
    "AllowedHeaders": [
      "*"
    ],
    "AllowedMethods": [
      "GET",
      "PUT",
      "POST",
      "DELETE",
      "HEAD"
    ],
    "AllowedOrigins": [
      "*"
    ],
    "MaxAgeSeconds": 3000
  }
]
```

### 创建访问密钥

Shade 通过 S3 协议访问 Wasabi 存储桶，这意味着 Shade 需要存储桶名称、存储桶区域、访问密钥和密钥才能访问该存储桶。

前往 Access Keys > Create Access Key，并创建一个拥有访问你新配置存储桶权限的 Root 或 Sub-User 密钥。

<figure><img src="/files/5349fb341726158487f0f9a16cc05d36fb7adca1" alt=""><figcaption></figcaption></figure>

确保你已下载这些密钥并复制到剪贴板

### 在 Shade 中创建 BYOS 盘

到这一步，你应该已经成功获取以下项目：

1. Shade 工作区
2. 存储桶名称
3. 存储桶区域
4. 访问密钥
5. 密钥

如果你还没有工作区，可以创建一个 [这里](https://app.shade.inc).

在你的 Shade 工作区中，你现在可以创建一个盘。点击“My drives”旁边的加号按钮 > BYOS drive。

<figure><img src="/files/6679cdbfcbc519ed7c8e70077d8068247cc0d2fc" alt=""><figcaption></figcaption></figure>

#### 选择模板

<figure><img src="/files/c6f3857a47cf5df31888240c84ae7657fc9e12fc" alt=""><figcaption></figcaption></figure>

我们的模板通过额外的元数据和视图帮助你快速使用 Shade，从而帮助你组织文件和素材。有关我们的 AI 的更多信息，你可以查看我们的 [学院](https://academy.shade.inc/ai-tools/custom-and-automated-metadata)。在本例中，我们选择了 Video Production。

#### 创建我们的 Wasabi 盘

接下来，我们为盘命名，并选择提供商 Wasabi。

<figure><img src="/files/86e0768690efb2419b87d721aa89b65456ef6586" alt=""><figcaption></figcaption></figure>

#### 添加我们的 Wasabi 凭据

根据前面的步骤，我们添加 Wasabi 凭据，包括存储桶名称、区域、访问密钥和密钥。

{% hint style="info" %}
这必须是你在 Wasabi 中创建的存储桶名称。它不同于你在上一屏创建的盘名称。
{% endhint %}

<figure><img src="/files/a3eb2e4abe0e969181bb509641099ab771616d7c" alt=""><figcaption></figcaption></figure>

### 上传你的第一个文件

完成前面的步骤后，你现在就可以向你的 Shade 盘上传第一个文件了。如果配置成功，你应该能够上传文件，并从 [Shade 桌面应用](https://shade.inc/download)

<figure><img src="/files/7c64f598b86c32747981291b0b9e59e75b3ffeaa" alt=""><figcaption></figcaption></figure>

### 故障排除提示

如果你有更多问题——欢迎通过以下方式联系我们： <support@shade.inc> 或加入我们的 [Discord](https://discord.gg/h8wqFMJ4vK).

#### 我无法上传，怎么回事？

如果你无法上传，请检查存储桶的 CORS 设置，或者检查你的密钥/访问密钥及其关联权限。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/byos/connecting-shade-to-wasabi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.