返回首页
published
healthy

COS 前端直传工具

基于腾讯云 COS 的文件上传工具集,提供后端 API 上传和前端 STS 直传两种接入方案。

https://cos-ebon.vercel.app

访问 Bob
Cloud
Storage
API
Tool

-

项目说明

COS 前端直传工具与文件操作示例

一句话介绍

基于腾讯云 COS 的完整文件上传解决方案,提供后端 API 直传和前端 STS 临时密钥直传两种接入模式,附带 Next.js 前端示例。

项目定位

本项目为需要接入腾讯云对象存储的项目提供开箱即用的上传方案。通过 FastAPI 后端封装 COS 操作,同时提供 STS 临时密钥生成接口,让前端可以直接上传文件到 COS,避免经过后端中转,降低服务器带宽压力。

主要功能

1. 后端 API 上传

通过 FastAPI 后端接口上传文件到 COS,适合小文件和服务端场景。

功能特性:

  • POST /upload 一键上传
  • 自动按年/月分文件夹存储
  • 返回 COS 访问 URL
  • 支持多 API Key 对应多桶

2. 前端 STS 直传

浏览器端获取临时密钥后直接上传到 COS,适合大文件和高并发场景。

直传优势:

  • 文件不经过后端中转
  • STS 临时密钥安全可控
  • 支持分片上传
  • 权限限定在指定目录
  • 附带 cos-js-sdk-v5 Next.js 示例

3. 多桶多密钥管理

支持配置多个 COS 桶和对应的 API Key,灵活适配不同项目。

映射规则:

  • API_KEY → COS_BUCKET + COS_REGION
  • API_KEY_2 → COS_BUCKET_2 + COS_REGION_2
  • 支持无限扩展
  • 区域配置可回退到全局默认

4. CORS 与 Web 界面

内置 CORS 配置和 Web 上传界面,开箱即用。

界面功能:

  • HTML 上传页面
  • 拖拽上传支持
  • 上传进度显示
  • 文件 URL 复制

应用场景

前端项目文件上传

为 Next.js、React 等前端项目提供即插即用的 COS 直传方案。

多项目共享上传服务

一个后端服务管理多个 COS 桶,不同项目通过不同 API Key 接入。

大文件上传场景

利用 STS 直传和分片上传能力,处理视频、压缩包等大文件。

快速原型开发

作为新项目的文件上传基础设施,快速搭建无需从零配置。

产品价值

  • 两种上传模式覆盖不同业务需求
  • STS 直传降低后端带宽压力
  • 多桶管理灵活适配多项目
  • 附带完整前端示例,降低接入成本
  • PM2 部署配置支持生产环境