# 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 備份設定中填寫上述資訊，撳備份按鈕就可以進行備份，撳管理按鈕可以睇同管理備份檔案列表。
