腾讯云 COS
腾讯云对象存储接入指南
腾讯云 COS 是项目的默认存储目标。代码已内置兼容处理,会自动从 Bucket 名称提取 Appid 并注入请求头。
创建存储桶
登录 腾讯云 COS 控制台,创建一个存储桶。建议命名为 <项目名>-<用途>-<appid> 格式,例如 my-app-public-1303088253。
获取 API 密钥
进入 云 API 密钥管理,创建或查看 SecretId 和 SecretKey。
配置跨域(CORS)
在存储桶的「安全管理 > 跨域访问 CORS」中添加规则:
| 配置项 | 值 |
|---|---|
| 来源 Origin | http://localhost:7001(开发);生产环境填正式域名 |
| 允许 Methods | PUT, GET, HEAD |
| 允许 Headers | * |
| 暴露 Headers | ETag |
签名 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