> 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/bring-your-own-s3-storage.md).

# 使用你自己的 S3 存储

Shade 允许你连接自托管的 S3 存储桶作为 Shade 的存储后端。

您可以将自己的 S3 存储连接到 Shade 云，从而为您的团队配置自己的存储桶、区域和权限。实际上，这相当于按服务付费使用 Shade，并且可以挂载和搜索您的资产，而无需支付存储费用。

{% hint style="danger" %}
Shade 需要对您的存储桶进行格式化，以匹配我们的后端 API。这意味着您的文件将被分块，并使用不规则的 UUID 名称，且不包含任何文件夹。您的团队将无法将 S3 存储桶用作带文件夹的“常规”文件存储。如需更多信息，请联系我们 [这里](https://cal.com/team/shade-inc/shade-demo).
{% endhint %}

## 设置 BYOS3 驱动器

<figure><img src="https://3843445310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FeRbjfeKFykYE80HGi1Pv%2FNewBYOSStudio.gif?alt=media&amp;token=7b75bd58-20b0-4e38-8d80-cd20f5ae8010" alt=""><figcaption></figcaption></figure>

通过浏览器、桌面应用或 ShadeFS 挂载上传到 Shade 的文件，将会以“blob”和“chunk”的形式出现在您的 S3 存储桶中。


---

# 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/bring-your-own-s3-storage.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.
