S3 存储设置指南：从 Backblaze B2、AWS、Cloudflare R2、Google Cloud Storage 串流音乐和视频

Cloudist 现已支持 S3 兼容云存储 —— 连接您的 Backblaze B2、AWS S3、Cloudflare R2、Google Cloud Storage、Wasabi、MinIO 或任何 S3 兼容服务，直接从您的 bucket 串流音乐和视频。

本指南将带您了解使用 Cloudist Play（音乐）和 Cloudist Watch（视频）设置 S3 存储所需的一切。

什么是 S3 Storage？

Amazon S3（Simple Storage Service）是对象存储的行业标准。许多提供商提供 S3 兼容的 API，这意味着您可以使用相同的协议访问不同公司的存储。这为您提供：

• 自由选择 —— 选择适合您预算和需求的任何提供商
• 无供应商锁定 —— 无需更改配置即可切换提供商
• 成本效益 —— 以每 GB 几分钱的价格存储大型媒体库
• 自托管选项 —— 在您自己的服务器上运行 MinIO

支持的提供商

Cloudist 可与任何 S3 兼容存储配合使用。以下是最受欢迎的选项：

我们的推荐

对于大多数用户，Backblaze B2 或 Cloudflare R2 提供最佳性价比。B2 提供 10 GB 免费存储和慷慨的免费出站流量，而 R2 的下载完全免费 —— 非常适合媒体串流。如果您已在 Google 生态系统中，Google Cloud Storage 提供 5 GB 永久免费的无缝集成。

分步设置指南

第 1 步：创建 S3 Bucket

首先，在您选择的提供商处创建一个 bucket：

Backblaze B2：

1. 在 backblaze.com 注册
2. 进入 Buckets → Create a Bucket
3. 给它起个名字（例如 my-music）并设置为 Private
4. 从 bucket 详情中记下您的 Endpoint 和 Region

AWS S3：

1. 打开 S3 控制台
2. 点击 Create bucket
3. 选择离您最近的区域（例如 ap-northeast-1）
4. 保持"阻止所有公共访问"为启用状态

Cloudflare R2：

1. 登录 Cloudflare Dashboard
2. 进入 R2 Object Storage → Create bucket
3. 从控制面板 URL 中记下您的 Account ID

Google Cloud Storage：

1. 打开 Cloud Storage 控制台
2. 点击 Create bucket
3. 选择离您最近的区域（例如 asia-east1）
4. 为经常访问的媒体选择 Standard 存储类别
5. 保持"强制执行公共访问预防"为启用状态

第 2 步：创建访问密钥

您需要一个 Access Key ID 和 Secret Access Key 来连接：

Backblaze B2：

1. 进入 Application Keys → Add a New Application Key
2. 给它起个名字，选择您的 bucket，并选择 Read Only
3. 保存 keyID（Access Key）和 applicationKey（Secret Key）

AWS S3：

1. 进入 IAM → Users → Create User
2. 附加 AmazonS3ReadOnlyAccess 策略
3. 在 Security Credentials 下创建 Access Key

Cloudflare R2：

1. 进入 R2 → Manage R2 API Tokens
2. 为您的 bucket 创建具有 Object Read 权限的令牌

Google Cloud Storage：

1. 进入 Cloud Storage → Settings → Interoperability
2. 点击 Create a key for a service account 或使用您的默认账户
3. 这将生成与 S3 兼容的 HMAC Access Key 和 Secret Key
4. 对于只读访问，请为服务账户分配 Storage Object Viewer 角色

第 3 步：上传您的媒体文件

将您的音乐或视频文件上传到 bucket。您可以使用文件夹来组织它们：

my-music/
  Rock/
    song1.mp3
    song2.flac
  Jazz/
    track1.m4a
  Podcasts/
    episode1.mp3

使用您的提供商的网页控制台、CLI 工具或 Cyberduck、rclone 等应用上传文件。

第 4 步：在 Cloudist 中连接

1. 打开 Cloudist Play 或 Cloudist Watch
2. 进入 账户 → 点击 + 按钮
3. 选择 S3 Storage
4. 从下拉菜单中选择您的提供商预设（Backblaze B2、AWS S3、Cloudflare R2、Wasabi 或 Custom）
5. Endpoint 和 Region 字段会根据您的预设自动填充
6. 输入您的 Access Key 和 Secret Key
7. 输入您的 Bucket 名称
8. 点击 Test & Connect

就是这样！Cloudist 将扫描您的 bucket 并将所有支持的媒体文件添加到您的媒体库中。

串流如何工作

Cloudist 使用 Pre-signed URL 来串流您的媒体。这意味着：

• 当您播放一首曲目时，Cloudist 会生成一个临时 URL（有效期 1 小时），授予对该特定文件的访问权限
• 不需要身份验证头 —— URL 本身包含签名
• 这在所有平台上与音频和视频播放器无缝配合
• URL 过期时会自动重新生成

这种方法既安全（URL 很快过期）又高效（不需要代理服务器）。

支持的文件格式

Cloudist Play（音乐）：

• MP3、M4A、WAV、FLAC、AAC、WMA、OGG

Cloudist Watch（视频）：

• MP4、MKV、WebM、AVI、MOV、M4V、FLV、WMV、TS、3GP

网页应用：CORS 配置

如果您使用网页应用（play.fromcloud.ist 或 watch.fromcloud.ist），您的 bucket 需要 CORS 配置以允许浏览器访问。以下是需要添加的 CORS 策略：

[{
  "AllowedHeaders": ["*"],
  "AllowedMethods": ["GET", "HEAD"],
  "AllowedOrigins": ["https://play.fromcloud.ist", "https://watch.fromcloud.ist"],
  "ExposeHeaders": ["ETag", "Content-Length"],
  "MaxAgeSeconds": 3600
}]

注意： CORS 配置仅用于网页播放。原生应用（iOS、Android、macOS）不需要它。

成本比较

以下是存储和串流典型音乐库（1,000 首曲目，约 8 GB）每月 100 次播放的费用：

视频库（200 个视频，约 100 GB）每月 50 次播放：

提示与最佳实践

• 使用只读密钥 —— Cloudist 只需要读取文件，从不写入。创建具有最低权限的密钥
• 使用文件夹组织 —— 使用清晰的文件夹结构。Cloudist 保留您的文件夹层次结构以便于浏览
• 选择就近区域 —— 选择靠近您位置的存储区域以获得更快的串流速度
• Backblaze B2 + Cloudflare —— 如果您将 B2 与 Cloudflare CDN 配合使用，两者之间的出站流量完全免费（Bandwidth Alliance）
• MinIO 用于自托管 —— 在 Raspberry Pi 或 NAS 上运行 MinIO，打造完全私有的自托管媒体服务器

常见问题

我的凭证会上传到某处吗？

不会。 您的 S3 访问密钥仅使用安全本地存储存储在您的设备上。它们永远不会被发送到 Cloudist 服务器或存储在云端。

我可以连接多个 S3 账户吗？

可以。 您可以添加任意数量的 S3 存储账户 —— 混合使用不同的提供商、bucket 或区域。

离线可以使用吗？

可以。 您可以下载曲目以供离线播放。下载的文件存储在您设备的本地。

如果我的 Pre-signed URL 过期了会怎样？

Cloudist 会在需要时自动生成新的 URL。您在播放过程中不会注意到任何中断。

立即开始

下载 Cloudist 并立即连接您的 S3 存储：

• Cloudist Play（音乐）：App Store · Google Play · Web
• Cloudist Watch（视频）：App Store · Google Play · Web