概览

最近更新时间:2026-05-15 14:53:01

我的收藏
EdgeOne Pages 提供内置的持久化存储能力,可在 Pages Functions 中直接使用,无需额外搭建后端或对接第三方服务。
目前支持两种存储类型:
KV — 分布式键值存储,适合存放配置、计数器、Session 等单点状态。
Blob — 分布式对象存储,适合存放图片、文档、用户上传文件、AI 生成内容等非结构化数据,支持目录层级。

如何选择

简单判断:存几个小键值用 KV;存对象、需要目录层级或较大数据用 Blob。
特性
KV 存储
Blob 存储
定位
分布式变量
分布式对象集合
数据组织
扁平 key → value
/ 路径组织,支持目录层级
单值上限
25 MB
25 MB
运行环境
仅 Edge Functions
Edge Functions / Cloud Functions
接入方式
控制台开通 → 创建命名空间 → 绑定项目
getStore('name') 即用即得,无需配置
一致性
60s 最终一致
60s 最终一致

适合 KV 的场景

访问计数器、点击统计、限流计数。
Feature Flag(功能开关)、AB 实验配置。
用户 Session、登录态。
API 密钥等敏感配置。

适合 Blob 的场景

用户上传的图片、附件、文档。
AI 生成的图片、文档、报告。
按目录组织的结构化数据集(多个 JSON、批量记录等)。
需要写入后立即读到最新值的场景。

快速对比

// KV:通过绑定变量名访问
await my_kv.put("visitCount", "1");
const count = await my_kv.get("visitCount");
// Blob:通过 SDK 直接使用
import { getStore } from "@tencent/pages-blob";
const store = getStore("uploads");
await store.set("photos/cat.jpg", imageData);
const file = await store.get("photos/cat.jpg");
各存储类型的完整使用指南和 API 参考详见 KVBlob