S3 相容儲存設定教學 — Framecho

01

開始前準備

先準備專用儲存桶與權限受限的金鑰,再開啟 Framecho「設定 › 雲端 › S3 相容儲存」。

  1. 建立專用儲存桶,記下名稱與區域。
  2. 建立只能存取此 Bucket 的應用程式金鑰,允許上傳、讀取、分段上傳與刪除。
  3. 選擇私有或公開模式;私有模式不必公開 Bucket。
  4. 按「驗證連線」,Framecho 會上傳、讀取並刪除小型測試檔。

公開讀取 + 固定連結

連結不會過期,但持有物件網址者皆可讀取。只能允許公開讀取,絕不可公開寫入。

不要洩漏金鑰。

截圖與支援單必須遮住 Access Key ID 與 Secret。請建立限定單一 Bucket 的專用金鑰。

02

Framecho 欄位怎麼填

使用內建服務商時只填區域;只有「自訂」需要手動填 Endpoint。

服務商選擇對應預設;七牛雲、MinIO 等選擇「自訂」。
區域Region ID,例如 cn-hongkong、ap-shanghai、us-east-005。
EndpointS3 API 公網服務位址,不是控制台或 CDN 網址。
儲存桶完整 Bucket 名稱;騰訊 COS 必須包含 APPID 後綴。
Access Key ID / Secret對應 AK/SK、SecretId/SecretKey 或 keyID/applicationKey。
儲存桶存取建議私有模式並設定有效期限。
公開網域僅公開模式需要,填可直接讀取物件的 HTTPS 根網址。
路徑前綴預設 framecho。
產生分享頁產生媒體預覽、字幕、Framecho 圖示與 favicon。
Framecho S3 设置中文截图,用红色箭头标出 Endpoint、地域、存储桶、AK、SK 和公开访问域名
簡體中文介面的欄位對應,金鑰與網域已隱藏。

選擇服務商

OSS
03

阿里云 OSS

使用 RAM 用户的 AccessKey。推荐 Bucket 保持私有;若要让 HTML 分享页直接在浏览器打开,公开模式应绑定自定义域名。

  1. 创建 OSS Bucket 并记下地域 ID。
  2. 在 RAM 中创建专用用户和 AccessKey,授权它读写、删除该 Bucket 内的对象。
  3. Framecho 选择「阿里云 OSS」,填写地域、Bucket、AccessKey ID 和 AccessKey Secret。
  4. 推荐选择「私有」并验证连接;只有确需永久公开链接时才配置公共读。
地域cn-hongkong
存储桶your-bucket
Access Key IDRAM AccessKey ID
Secret Access KeyRAM AccessKey Secret
注意

OSS 默认域名访问 HTML 会强制下载。要在线打开分享页,请在公开模式绑定自定义域名;不要把 Bucket 设为公共读写。

阿里云 OSS 控制台的阻止公共访问页面,红框标出关闭开关,箭头指向读写权限标签
只有公開模式需要關閉「阻止公共存取」並設為公開讀取。
查看服務商官方文件
COS
04

腾讯云 COS

COS 使用 CAM 的 SecretId 与 SecretKey。Bucket 名称通常包含 APPID,例如 example-1250000000。

  1. 创建 COS Bucket,复制地域 ID 和包含 APPID 的完整 Bucket 名称。
  2. 在 CAM 新建子用户或密钥,并只授予目标 Bucket 所需的对象读写与删除权限。
  3. Framecho 选择「腾讯云 COS」;SecretId 填入 Access Key ID,SecretKey 填入 Secret Access Key。
  4. 保持私有可使用有效期链接;公开模式需给对象匿名读权限并填写可访问域名。
地域ap-shanghai
存储桶example-1250000000
Access Key IDSecretId
Secret Access KeySecretKey
注意

COS 默认域名可能强制下载 HTML。需要浏览器分享页时,使用已备案的自定义域名或 CDN 域名,并在 Framecho 选择公开模式。

查看服務商官方文件
R2
05

Cloudflare R2

R2 需要 Account ID 和专门生成的 R2 API Token 凭据,不是普通 Cloudflare API Token。

  1. 在 R2 创建 Bucket。
  2. 在 R2「Manage API Tokens」创建 Object Read & Write Token,并限制到目标 Bucket。
  3. 保存只显示一次的 Access Key ID 与 Secret Access Key,并复制 Cloudflare Account ID。
  4. Framecho 选择「Cloudflare R2」,填写三项凭据和 Bucket 后验证。
Account IDCloudflare Account ID
地域auto
Access Key IDR2 Access Key ID
Secret Access KeyR2 Secret Access Key
注意

公开模式可使用绑定到 Bucket 的自定义域名;r2.dev 仅适合开发测试且有限速。私有模式不需要开启 Public Development URL。

查看服務商官方文件
B2
06

Backblaze B2

必须创建普通 Application Key。Master Application Key 不支持 B2 的 S3 Compatible API。

  1. 在 Bucket 详情复制 Endpoint,并取出其中的地域,例如 s3.us-east-005.backblazeb2.com 对应 us-east-005。
  2. 进入 Application Keys,新增可读写目标 Bucket 的普通密钥。
  3. 将 25 位 keyID 填入 Access Key ID,将只显示一次的 applicationKey 填入 Secret Access Key。
  4. Framecho 选择「Backblaze B2」,填写地域和 Bucket 后验证。
地域us-east-005
存储桶your-bucket
Access Key ID25-character keyID
Secret Access KeyapplicationKey
注意

不要填写 12 位 Account / Master Key ID、Bucket ID 或密钥名称。地域必须与 Bucket 页面显示的 Endpoint 完全一致。

查看服務商官方文件
AWS
07

Amazon S3

使用 IAM 用户或角色对应的长期访问密钥,限定到 Framecho Bucket 和前缀。

  1. 创建 S3 Bucket 并记下 Region。
  2. 创建专用 IAM 身份与 Access Key,授予目标 Bucket 的 Put/Get/Delete、ListBucket 和分片上传权限。
  3. Framecho 选择「Amazon S3」,填写 Region、Bucket、Access Key ID 和 Secret Access Key。
  4. 推荐保持 Block Public Access 开启并使用私有有效期链接。
地域ap-east-1
存储桶your-bucket
Access Key IDIAM Access Key ID
Secret Access KeyIAM Secret Access Key
注意

不要使用 AWS Root 用户密钥。公开模式需要明确关闭对应的 Block Public Access 并添加只读 Bucket Policy,风险高于私有模式。

查看服務商官方文件
S3
08

七牛云、MinIO 与其他 S3

任何支持 HTTPS、SigV4、PUT、分片上传、GET 和批量删除的 S3 兼容服务都可以尝试。

  1. 从服务商控制台复制 S3 API 公网 Endpoint 和签名 Region。
  2. Framecho 选择「自定义」,填写完整 HTTPS Endpoint、Region、Bucket 和密钥。
  3. 根据服务商文档选择虚拟主机或路径式地址;MinIO 常用路径式。
  4. 先运行验证;上传、读取和删除三项都通过后再用于正式分享。
Endpointhttps://s3.example.com
地域us-east-1
路径式地址按服务商要求
密钥S3 Access Key / Secret Key
注意

七牛云 Kodo 可使用空间概览中的 S3 外网地址;Region 是该地址中的地域段。Endpoint 必须能从当前 Mac 解析和访问。

查看服務商官方文件
09

常見錯誤

SignatureDoesNotMatch

通常是 Secret、Region、Endpoint 或系统时间不一致。重新复制密钥,确认地域来自同一个 Bucket。

NoSuchBucket

Bucket 名称或地域不匹配;腾讯云还要确认名称包含 APPID。

InvalidAccessKeyId

填错了密钥类型或字段。B2 必须用普通 Application Key 的 25 位 keyID。

NSURLErrorDomain -1003

Endpoint 主机名无法解析。检查是否误填控制台地址、内网地址、Bucket 域名或拼写错误。

链接直接下载

通常是 OSS/COS 默认域名策略或文件类型导致。私有签名链接仍可下载;HTML 分享页要在线打开请使用公开模式与自定义域名。

验证上传成功但读取失败

密钥有写权限,但 Bucket/域名没有读权限,或公开域名指向了另一个 Bucket。

最後再驗證一次

三項皆通過後,檔案會直接寫入你的 Bucket,金鑰只保存在本機鑰匙圈。

返回欄位說明