S3 兼容存储配置教程 — Framecho

01

开始前准备

先准备一个专用存储桶和一对权限受限的密钥,再打开 Framecho「设置 › 云端 › S3 兼容存储」。

  1. 新建一个专门用于 Framecho 的存储桶,记下存储桶名称和地域。
  2. 创建只能访问这个存储桶的应用密钥,至少允许上传、读取、分片上传和删除对象。不要使用主账号密钥。
  3. 选择私有或公开模式。私有模式不需要公开 Bucket;公开模式还要准备公开访问域名。
  4. 填完配置后点「验证连接」,Framecho 会上传、读取并删除一个小测试文件。

公开读 + 固定链接

链接不会过期,但任何拿到对象地址的人都能读取。只允许公共读,绝不要启用公共写;分享页最好使用自定义域名。

不要泄露密钥。

截图、工单和聊天中必须遮住 Access Key ID 与 Secret。建议为 Framecho 单独创建、限定到单个 Bucket 的密钥,泄露后立即撤销。

02

Framecho 字段怎么填

使用内置服务商时只填地域,Framecho 会生成 Endpoint;只有「自定义」需要手动填写服务地址。

服务商选择对应预设;七牛云、MinIO 等选择「自定义」。
地域服务商的 Region ID,例如 cn-hongkong、ap-shanghai、us-east-005。不要填写中文地域名。
接口 / EndpointS3 API 的公网服务地址,不是控制台网址,也不是 CDN 地址。内置预设会自动生成。
存储桶Bucket 的完整名称;腾讯云 COS 需要包含 APPID 后缀。
访问密钥 ID / 秘密访问密钥分别对应服务商的 AK/SK、SecretId/SecretKey 或 keyID/applicationKey。
存储桶访问推荐选择「私有」,并设置链接有效期。
公开访问域名只在公开模式填写,必须是能直接读取对象的 HTTPS 根地址,不要带路径。
路径前缀默认 framecho;所有文件会写入这个目录前缀。
生成分享页为图片或视频生成带预览、字幕、Framecho 图标和 favicon 的 HTML 页面。
Framecho S3 设置中文截图,用红色箭头标出 Endpoint、地域、存储桶、AK、SK 和公开访问域名
自定义 S3 的字段对应关系。图中密钥和域名已经隐藏。

选择你的服务商

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 控制台的阻止公共访问页面,红框标出关闭开关,箭头指向读写权限标签
只有选择公开模式时才需要关闭「阻止公共访问」并将 Bucket 设为公共读;私有模式无需修改。
查看服务商官方文档
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,密钥只保存在本机钥匙串。

返回字段说明