用途:该技能面向使用 Firebase Cloud Storage 构建文件上传、下载与安全访问的场景,适用于图片/文件上传、生成下载 URL、实现文件管理等需求。资料标注状态为 Production Ready,最后更新 2026-01-25,无依赖,为独立技能;涉及版本 firebase@12.8.0、firebase-admin@13.6.0。
主要能力:客户端 SDK 支持基础上传、带进度上传、带元数据上传、从 Data URL/Base64 上传;下载方面支持获取下载 URL、以 Blob 下载、读取文件元数据;文件管理支持删除、列出目录文件(含分页)、更新元数据。服务端 Admin SDK 支持从服务器上传、生成签名 URL(读/写)、删除文件与整个目录。安全规则部分给出基于认证、所有者、文件类型与大小的规则结构,并可用 firebase deploy --only storage 部署。
使用方式:客户端通过 initializeApp 与 getStorage 初始化;服务端通过 firebase-admin/app 与 firebase-admin/storage 初始化。Web 端需配置 CORS,创建 cors.json 后执行 gsutil cors set cors.json gs://your-bucket-name.appspot.com,否则浏览器上传会因 CORS 报错。资料还提供 React 文件上传与图片预览上传组件示例,以及常见错误码(如 storage/unauthorized、storage/quota-exceeded 等)与处理建议。
限制:资料未提供收费、价格、平台支持范围或性能效果等事实,暂未提供;具体配额与计费需参考官方文档。