Vercel Blob 支持 TTL 自动删除,临时文件管理更省心

Vercel Blob 新增 TTL,写入时声明 1-730 天生命周期,到期自动删除。
Vercel Blob 加入 TTL 能力,开发者可在写入时通过 ttlDays 参数指定 1 至 730 天的生命周期,到期自动删除,计时从上上传日期开始。TTL 覆盖 put()、copy()、putImage()、multipart 上传和预签名上传 URL,写入结果与 head() 均返回 expiresAt。setTtl() 支持修改或清除已有 blob 的 TTL,可单 URL 或最多 1,000 个批量操作,无需重新上传。CLI 65.16.0 起同步支持 --ttl-days 与 vercel blob set-ttl。计费上,设置 TTL 按每 60 天计一次 Advanced Operation,7 天记 1 次、730 天记 13 次,清除与删除免费。这标志着数据留存策略从「事后补救」前移到「写入即声明」。
Vercel 为 Blob 存储加入了 TTL(Time to Live)能力,开发者可以在写入时直接指定过期天数,让临时文件到期自动消失。这件事看起来只是一个存储功能的小补丁,但它解决的是对象存储里长期被忽视的一类脏活:手动清理。

TTL 能做什么:写入即约定生命周期
Vercel Blob 现在允许在写入 blob 时传入 ttlDays 参数,取值为 1 到 730 天。计时起点是 blob 的上传日期,到期后系统自动删除。Vercel 官方点名的适用场景包括会话记录(session transcripts)、数据导出和临时上传——这些内容的共同点是生命周期明确、留存价值随时间快速衰减,却往往因为开发者忘记清理而长期堆在存储桶里。
在默认情况下,对象存储的生命周期管理通常依赖定时任务或云厂商的 bucket 规则,前者要自己写调度逻辑,后者配置粒度粗、跨平台不一致。把 TTL 做进写入 API,等于把「这份数据活多久」变成一次调用里的显式声明,减少了后续运维的认知负担。
对象存储生命周期管理(Lifecycle Management)是云存储服务的一项基础能力,用于在对象达到指定条件(如创建后 N 天)时自动执行删除或转储操作。AWS S3 通过 Bucket Lifecycle Configuration 实现,规则以 JSON 定义并绑定到前缀或标签;Google Cloud Storage 和 Azure Blob Storage 也提供类似机制,但配置语法和生效语义各不相同。这类规则通常是桶级别的批量策略,粒度较粗,且依赖后台异步扫描,实际删除时间可能存在延迟。与之相比,Vercel Blob 的 TTL 是写入级别的显式声明,每个 blob 可以独立设定过期时间,语义更精确,也让「这份数据活多久」成为应用代码的一部分,而非云平台侧的运维配置。
覆盖面:不只是 put()
TTL 的支持范围是这次更新里比较扎实的部分。ttlDays 在 put()、copy()、putImage()、multipart 上传以及预签名上传 URL 上都可用。预签名 URL 的场景值得一提:当服务端把上传权限下放给客户端或第三方时,TTL 让上传方也能带上生命周期约定,而不必由服务端在上传完成后再补一次调用。
配套的 expiresAt 字段会出现在每个写入结果和 head() 响应里,开发者可以据此判断某个 blob 何时到期,而不需要自己在业务数据库里维护一张过期时间表。
import { put, setTtl } from '@vercel/blob';
// Delete this export 7 days after upload
const blob = await put('exports/report.csv', csv, {
access: 'private',
ttlDays: 7,
});
console.log(blob.expiresAt); // 2026-11-24T00:00:00.000Z
预签名上传 URL(Presigned URL)是一种临时授权的上传机制:服务端用存储凭证生成一个带签名和有效期的 URL,客户端或第三方凭此 URL 直接向存储桶上传文件,无需经过服务端中转,也不需要暴露长期密钥。由于上传动作发生在客户端,服务端无法在上传完成的瞬间附加元数据或调用后续 API。Vercel Blob 允许在生成预签名 URL 时嵌入 ttlDays,等于把生命周期约定提前到授权阶段,上传方一落地就自带过期时间,避免了服务端在上传后补一次调用的竞态和遗漏问题。
setTtl:给已存在的 blob 改命
如果只能在写入时设定 TTL,这个功能的实用性会打折扣——毕竟需求变化往往发生在数据落盘之后。setTtl() 补上了这一环:它可以修改或移除已有 blob 的 TTL,支持单个 URL 或一次性最多 1,000 个 URL 批量操作,且无需重新上传文件。
// Change your mind later: extend to 30 days, or clear it with null
await setTtl(blob.url, { ttlDays: 30 });
await setTtl(blob.url, { ttlDays: null });
把 ttlDays 设为 null 即清除 TTL,blob 回到永久保留状态。这种「先设短、需要时再延长」的用法,和「先永久保存、定期清理」相比,更适合那些不确定会不会被再次访问的中间产物。
CLI 同步跟进
命令行侧也做了对齐。在 Vercel CLI 65.16.0 及更高版本中,vercel blob put、put-image、copy、presign 支持 --ttl-days 参数,已有 blob 则通过 vercel blob set-ttl 操作,--clear-ttl 用于清除。对习惯在终端里处理一次性任务的开发者来说,这条路径比写脚本更短。
vercel blob put report.csv --ttl-days 7
vercel blob set-ttl exports/a.csv exports/b.csv --ttl-days 30
vercel blob set-ttl exports/a.csv --clear-ttl
计费逻辑:按 60 天递增的 Advanced Operation
TTL 并非免费功能,但计费方式相对克制。设置 TTL 会计入一次 Advanced Operation,按每开始的 60 天计算,叠加在写入操作之上。按官方给出的例子,7 天 TTL 记一次,730 天的上限则记 13 次。清除 TTL 以及删除动作本身不收费。
这个定价结构实际上在鼓励短周期 TTL:生命周期越短,计费单位越少。对于会话记录、临时导出这类本就该快速过期的数据,成本几乎可以忽略。较长的保留周期才会触发多单位计费,而这类需求本身对成本也更敏感。TTL 操作可以在 Observability 标签页的 Blob 区域追踪,费用归属是可查的。
Advanced Operation 是 Vercel Blob 计费体系中对超出基础读写之外的操作所设的计量单位,通常包括复制、列出、设置元数据等。它与简单的 PUT/GET 基础操作分开计价,目的是让计费更贴近实际资源消耗。TTL 的计费采用「按每开始的 60 天计一次」的阶梯方式:7 天和 60 天都算 1 次,61 天则算 2 次,730 天上限对应 13 次。这种设计让短周期 TTL 的边际成本趋近于零,而长周期保留则按占用的管理周期线性增长,实质上是用价格信号引导开发者缩短不必要的数据留存时间。
这背后的产品信号
对象存储的竞争点过去集中在容量、吞吐和一致性上,生命周期管理常被当作附属能力。Vercel 把 TTL 做成 API 的一等参数,说明其用户结构中「短生命周期数据」的占比在上升——AI 应用产生的会话记录、函数执行产生的中间导出、用户上传后即刻处理的临时文件,都属于这一类。
对开发者而言,直接的收益是少写一套清理逻辑;更深一层的影响是数据留存策略从「事后补救」前移到「写入即声明」。在数据合规要求日益具体的背景下,能证明某类数据在 N 天后必然消失,本身就是一种可审计的属性。
升级方式为 npm install @vercel/blob@2.9.0,更多细节可查阅 Vercel Blob 文档。
相关推荐

ClawDOS:为DOS系统注入AI编程能力
ClawDOS是一个面向DOS系统的AI编程代理项目,探索在资源受限的复古计算环境中引入AI编码辅助的可能性,本文分析其定位、使用场景与社区反响。

Baseten发布Bison-1与Groundhog-1登顶决策模型榜
Baseten发布基于Gemma 4的开放权重决策模型bison-1和groundhog-1,bison-1在AA Decision Index v2.1上得分76登顶,两款模型均支持128k上下文与图像输入,本文分析其能力组合、基准含义与开发者选型建议。

Cline CLI v3.0.75 发布:单次运行默认启用 yolo 模式
Cline CLI v3.0.75 发布:单次运行默认切换为 yolo 模式,--timeout 与 Ctrl+C 可中断首轮,read_files 不再截断到 8k 字符,并修复多项推理参数兼容问题、刷新模型目录新增 94 个 provider。