2026-11-21·5 分钟
存储:D1 存储库与 R2 对象存储
S3 协议对象存储一套代码兼容本地 MinIO 与 Cloudflare R2,大文件上传、私有签名下载与 D1/R2 分工。
S3 协议存储与配置#
数字资产(技能源码包、模板截图、用户头像)统一走 S3 协议对象存储:@aws-sdk/client-s3 一套代码同时兼容本地 MinIO 与 Cloudflare R2,跨运行时(Workers / Node)零改动:
env.env.local(存储段)
# 本地开发:MinIO
S3_ENDPOINT=http://localhost:9000
S3_REGION=auto
S3_ACCESS_KEY_ID=minioadmin
S3_SECRET_ACCESS_KEY=minioadmin
S3_BUCKET=saasone-assets
# 生产:Cloudflare R2(endpoint 换成 R2 S3 网关即可)
# S3_ENDPOINT=https://<account>.r2.cloudflarestorage.com上传与签名下载#
typescript上传 / 签名下载
import { S3Client, PutObjectCommand, GetObjectCommand } from '@aws-sdk/client-s3';
import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
const s3 = new S3Client({
region: process.env.S3_REGION,
endpoint: process.env.S3_ENDPOINT,
credentials: {
accessKeyId: process.env.S3_ACCESS_KEY_ID!,
secretAccessKey: process.env.S3_SECRET_ACCESS_KEY!,
},
});
await s3.send(new PutObjectCommand({
Bucket: process.env.S3_BUCKET,
Key: 'skills/introduction.zip',
Body: zipBuffer,
}));
// 私有桶限时签名下载(15 分钟)
const url = await getSignedUrl(s3, new GetObjectCommand({
Bucket: process.env.S3_BUCKET, Key: 'skills/introduction.zip',
}), { expiresIn: 900 });D1 与 R2 的分工#
Cloudflare 体系里 D1 承担结构化数据(配合 KV 做热缓存),R2 承担大文件;两者都在 Workers 部署拓扑中原生绑定,无需额外网络跳数。
选择原则
需要 SQL 查询 / 关联 / 聚合的数据进 D1;单文件大于几百 KB 或需要公开 CDN 分发的资产进 R2。
