跳到主要内容

云存储

CloudBase 云存储提供稳定、安全、低成本、简单易用的云端存储服务,支持任意数量和形式的非结构化数据存储,如图片、文档、音频、视频、文件等。底层基于腾讯云 COS(对象存储),并集成 CDN 加速、数据万象、内容审核等能力。

两种云存储模式​

云存储分为传统模式与 PG 模式两种类型,取决于环境形态:

维度传统模式云存储PG 模式云存储
适用环境传统形态环境(默认)PG 模式环境
Bucket 概念与环境强绑定,主要做路径前缀storage.buckets 表的一行,支持 SQL 级控制
权限模型内置权限模式(READONLY / PRIVATE 等)+ JSON 安全规则PostgreSQL RLS Policy(SQL)
上传链路客户端 SDK 拿签名后直传 COS客户端 → Storage API → COS,事务内协调元数据与对象
元数据业务侧补齐由 Storage API 自动写入 storage.objects,可 SQL 查询
选择方式创建环境时默认创建环境时选择 PostgreSQL 数据库
阅读路径
  • 传统模式:本目录大部分文档(控制台 / SDK / 权限 / HTTP API)
  • PG 模式:PG 模式云存储 + 同目录下的 HTTP API
  • CDN / 内容审核 / 图片处理 / 数据万象:两种模式共用,见本目录下的"高级功能"与"数据万象"分组

下文以传统模式为主介绍。如果你正在使用 PG 模式环境,请直接前往 PG 模式云存储。

管理方式​

CloudBase 云存储提供多种管理方式,您可以根据自己的需求选择最适合的方式:

管理方式特点适用场景优势
控制台管理图形化界面,可配置权限、缓存设置日常管理上手快速,可视化操作
SDK 管理可集成到应用中应用程序集成灵活性高,可定制化程度高
CLI 工具管理命令行操作,支持批量处理自动化脚本、批量处理高效批量操作,适合自动化部署
cosBrowser图形化界面,支持批量处理频繁文件管理结合图形界面便捷性与批量操作的高效性
HTTP API标准 RESTful 接口服务端集成、跨语言调用跨语言、跨平台,可在任意后端调用

根据您的具体需求和使用场景,选择合适的管理方式可以显著提高工作效率。例如,开发阶段可以使用 SDK,运维阶段可以使用 CLI 工具,而日常管理则可以使用控制台或 cosBrowser,跨语言后端集成可使用 HTTP API。

主要特性​

默认支持 CDN 加速​

云存储无需进行繁杂的配置,默认支持 CDN 加速,并提供免费的 CDN 域名。CDN 会将云存储的内容分发至最接近用户的节点,直接由服务节点快速响应,可以有效降低用户访问延迟。

身份验证集成​

CloudBase 云存储与 CloudBase 用户身份验证无缝集成,您可以结合用户身份认证和安全规则对云存储里的文件设置访问权限——例如云存储的文件只对已登录用户公开或仅限使用微信登录的用户访问等。

在 PG 模式下,身份认证与权限均由 PostgreSQL 的 auth schema 与 RLS 策略统一承载,详见 PG 模式云存储 - 权限管理。

高可扩展性​

CloudBase 云存储可以与 CloudBase 其它多种服务配合使用,例如:

  • 将文件的 fileID 存储到数据库
  • 配合 CloudBase 扩展能力使用,如图像安全审核、图像处理、图像标签、图像盲水印等

HTTP API​

云存储提供完整的 RESTful HTTP API,可在任意后端语言中调用:

  • 传统模式 HTTP API:对象上传 / 下载 / 删除 / 复制等基础操作
  • PG 模式 HTTP API:完整的 Bucket / Object CRUD、签名 URL、对象元信息、分片上传等,权限由 RLS 控制