SaasOne v2.0 Docs
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。