> 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/zi-dai-cun-chu/connecting-shade-to-wasabi.md).

# 将 Shade 连接到 Wasabi

Shade 支持 Bring-Your-Own-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="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FGby1mYxLsZf9KGOzceCb%2FScreenshot%202025-07-21%20at%209.42.04%E2%80%AFPM.png?alt=media&amp;token=2ea4c448-f288-44eb-a582-f929313f6cde" 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 如下：

```
[
  {
    "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="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F7iyAtxn3btAvZdeL4akq%2FScreenshot%202025-07-21%20at%209.42.54%E2%80%AFPM.png?alt=media&amp;token=2c31fa4e-f2ee-477d-b4f3-e464b33409fb" alt=""><figcaption></figcaption></figure>

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

### 在 Shade 中创建 BYOS 驱动器

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

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

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

在您的 Shade 工作区中，您现在可以创建一个驱动器。选择“我的驱动器”旁边的加号按钮 > BYOS drive。

<figure><img src="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FjqzLgveMAH1u4Jue0PBb%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM.png?alt=media&amp;token=f29ba862-4ea3-454a-9b60-6a14622fa1e5" alt=""><figcaption></figcaption></figure>

#### 选择模板

<figure><img src="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FPE80uq4lWAvyvhx7ZpEn%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM.png?alt=media&amp;token=72b36257-7e12-4c7e-95b5-7d8e29632adc" alt=""><figcaption></figcaption></figure>

我们的模板可帮助您快速开始使用 Shade，并提供额外的元数据和视图，帮助您整理文件和素材。要了解更多关于我们 AI 的信息，您可以查看我们的 [学院](https://academy.shade.inc/ai-tools/custom-and-automated-metadata)。在本例中，我们选择了视频制作。

#### 创建我们的 Wasabi 驱动器

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

<figure><img src="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FG4IELRlQGdywO97eQ7SS%2FScreenshot%202025-07-21%20at%209.43.34%E2%80%AFPM.png?alt=media&amp;token=6bdbe5bc-af88-4bd2-81c1-9b3ad362415a" alt=""><figcaption></figcaption></figure>

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

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

{% hint style="info" %}
这必须是您在 Wasabi 中创建的存储桶名称。这与您在上一屏幕中创建的驱动器名称不同。
{% endhint %}

<figure><img src="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FaYZgOmWk6xhdFkGjAk4z%2FScreenshot%202025-07-21%20at%209.44.02%E2%80%AFPM.png?alt=media&amp;token=33a14d3c-569a-4ab8-994c-a10a847c9bd8" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F64bJhaCemet6iLpQFXWz%2FScreenshot%202025-07-21%20at%209.45.00%E2%80%AFPM.png?alt=media&amp;token=32cda603-88ed-4cb6-a0e9-4124c8734011" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/zi-dai-cun-chu/connecting-shade-to-wasabi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
