腾讯云 COS

腾讯云对象存储接入指南

腾讯云 COS 是项目的默认存储目标。代码已内置兼容处理,会自动从 Bucket 名称提取 Appid 并注入请求头。

创建存储桶

登录 腾讯云 COS 控制台,创建一个存储桶。建议命名为 <项目名>-<用途>-<appid> 格式,例如 my-app-public-1303088253

获取 API 密钥

进入 云 API 密钥管理,创建或查看 SecretId 和 SecretKey。

配置跨域(CORS)

在存储桶的「安全管理 > 跨域访问 CORS」中添加规则:

配置项
来源 Originhttp://localhost:7001(开发);生产环境填正式域名
允许 MethodsPUT, GET, HEAD
允许 Headers*
暴露 HeadersETag

签名 URL 直传需要浏览器直接向 COS 发起 PUT 请求,必须配置 CORS,否则浏览器会拦截。

填写环境变量

S3_ENDPOINT=https://cos.ap-guangzhou.myqcloud.com
S3_REGION=ap-guangzhou
S3_ACCESS_KEY_ID=你的SecretId
S3_SECRET_ACCESS_KEY=你的SecretKey
S3_BUCKET=my-app-public-1303088253
NEXT_PUBLIC_S3_ENDPOINT=https://my-app-public-1303088253.cos.ap-guangzhou.myqcloud.com