☁️ 腾讯云对象存储(COS)配置
🔄 上传流程
⚙️ 配置说明
基础配置示例
yaml
files:
- # 业务标识配置
business-type: demo # 业务类型标识
file-type: cos # 存储类型:腾讯云COS
# 访问配置
http-access-path: https://www.wueasy.com # 文件访问基础路径
# 腾讯云认证信息
access-key-id: 123456 # 访问密钥ID
access-key-secret: 123456 # 访问密钥密文
# COS存储配置
bucket: dddd-1251238510 # 存储桶名称
endpoint: ap-chengdu # 存储区域
# 上传限制
allowed-upload-suffix: jpg,png,gif,bmp,pdf,doc # 允许的文件类型
max-size: 1MIB # 单文件大小限制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
参数说明
参数名 | 必填 | 说明 | 示例值 |
---|---|---|---|
business-type | 是 | 业务类型标识 | demo |
file-type | 是 | 存储类型(固定为cos) | cos |
http-access-path | 是 | 文件访问域名 | https://www.wueasy.com |
access-key-id | 是 | 腾讯云访问密钥ID | AKIDxxxxxxxx |
access-key-secret | 是 | 腾讯云访问密钥密文 | xxxxxxxxxx |
bucket | 是 | COS存储桶名称 | example-1251238510 |
endpoint | 是 | COS地域 | ap-chengdu |
allowed-upload-suffix | 是 | 允许上传的文件后缀 | jpg,png,pdf |
max-size | 是 | 文件大小限制 | 1MIB |
💡 配置指南
1. 准备工作
创建腾讯云账号
- 访问腾讯云官网注册账号
- 开通对象存储COS服务
获取访问密钥
- 访问访问密钥页面
- 创建并保存 SecretId 和 SecretKey
创建存储桶
- 访问存储桶列表
- 创建新的存储桶
- 记录存储桶名称和所在地域
2. 安全建议
安全提示
- 建议为文件服务创建独立的子账号
- 仅分配必要的COS操作权限
- 定期轮换访问密钥
3. 性能优化
- 选择就近地域以提升上传速度
- 合理设置文件大小限制
- 建议开启CDN加速服务
❗ 常见问题
上传失败
- 检查密钥配置是否正确
- 验证存储桶权限设置
- 确认网络连接状态
访问路径问题
- 确保配置了正确的访问域名
- 检查CDN配置(如果使用)
- 验证存储桶访问权限