SuperAPI AI 工具集

vercel-blob

前端与建站

查看项目

更新于 10-15 22:39

技能介绍

用途:把 Vercel Blob 对象存储接入 Next.js 及其他 Vercel 应用,用于存放图片、文档、视频等文件,文件经 CDN 自动分发。

主要能力:服务端用 put 上传;客户端通过 handleUpload 生成上传令牌直传,避免暴露 BLOB_READ_WRITE_TOKEN;用 list 列出文件(支持 prefix 与 cursor 分页);用 del 删除单个或多个文件;支持流式上传与大于 500MB 文件的分片上传(createMultipartUpload、uploadPart、completeMultipartUpload)。access 可选 public(CDN 缓存)或 private(需鉴权)。

使用方式:在 Vercel 控制台 Storage → Create Database → Blob 创建存储,执行 vercel env pull .env.local 获取 BLOB_READ_WRITE_TOKEN,安装 npm install @vercel/blob,然后在 Server Action 或 API Route 中调用 put 上传。客户端上传需服务端用 handleUpload 签发令牌,客户端用 upload 配合 handleUploadUrl 完成。

适用场景:头像与商品图上传、博客配图、SaaS 文档与导出文件存储等。

限制与注意:单文件上限 500MB,超出需分片;免费额度为每月 100GB 带宽;服务端函数有超时限制,大文件建议客户端直传;需校验文件类型与大小、显式设置 contentType、用时间戳或 UUID 避免重名、及时删除旧文件;列表需处理分页游标。资料未提供具体收费价格与其他平台支持细节。