> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/data-settings/s3-compatible.md).

# S3 相容儲存備份

Cherry Studio 數據備份支援透過 S3 相容儲存（物件儲存）嘅方式進行備份。常見嘅 S3 相容儲存服務有：AWS S3、Cloudflare R2、阿里雲 OSS、騰訊雲 COS 以及 MinIO 等。

基於 S3 相容儲存可以透過 `A電腦` $$\xrightarrow{\text{备份}}$$ `S3儲存` $$\xrightarrow{\text{恢复}}$$ `B電腦` 嘅方式嚟實現多端數據同步。

### 配置 S3 相容儲存

1. 建立物件儲存桶（Bucket），並記低儲存桶名稱。**強烈建議將儲存桶設置為私有讀寫，以避免備份數據洩露！！**
2. 參考文件，前往雲服務控制台獲取 S3 相容儲存嘅 `Access Key ID`、`Secret Access Key`、`Endpoint`、`Bucket`、`Region` 等資訊。
   * **Endpoint**：S3 相容儲存嘅存取地址，通常似 `https://<bucket-name>.<region>.amazonaws.com` 或者 `https://<ACCOUNT_ID>.r2.cloudflarestorage.com`。
   * **Region**：儲存桶所在嘅區域，例如 `us-west-1`、`ap-southeast-1` 等，cloudflare R2 請填寫 `auto`。
   * **Bucket**：儲存桶名稱。
   * **Access Key ID** 同 **Secret Access Key**：用於身份驗證嘅憑據。
   * **Root Path**：可選，指定備份到儲存桶時嘅根路徑，預設為空。
   * **相關文件**
     * AWS S3：[獲取 Access Key ID 同 Secret Access Key](https://docs.aws.amazon.com/zh_cn/IAM/latest/UserGuide/id_credentials_access-keys.html)
     * Cloudflare R2：[獲取 Access Key ID 同 Secret Access Key](https://developers.cloudflare.com/r2/api/tokens/)
     * 阿里雲 OSS：[獲取 Access Key ID 同 Access Key Secret](https://help.aliyun.com/zh/oss/developer-reference/use-amazon-s3-sdks-to-access-oss#306596478ed3r)
     * 騰訊雲 COS：[獲取 SecretId 同 SecretKey](https://cloud.tencent.com/document/product/436/37421)
3. 喺 S3 備份設定入面填寫上面啲資訊，撳備份按鈕就可以進行備份，撳管理按鈕可以睇同管理備份文件列表。

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改進建議，請參考 [反饋同建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# 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://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/data-settings/s3-compatible.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.