☁️ 阿里云对象存储(OSS)配置

🔄 上传流程

⚙️ 配置说明

基础配置示例

files:
- # 业务标识配置
  business-type: demo           # 业务类型标识
  file-type: oss               # 存储类型：阿里云OSS
  
  # 访问配置
  http-access-path: https://www.wueasy.com  # 文件访问基础路径
  
  # 阿里云认证信息
  access-key-id: 123456        # 访问密钥ID
  access-key-secret: 123456    # 访问密钥密文
  
  # OSS存储配置
  bucket: file1234            # 存储桶名称
  endpoint: oss-cn-wuhan-lr.aliyuncs.com  # 访问域名
  
  # 上传限制
  allowed-upload-suffix: jpg,png,gif,bmp,pdf,doc  # 允许的文件类型
  max-size: 1MIB              # 单文件大小限制

参数说明

参数名	必填	说明	示例值
business-type	是	业务类型标识	demo
file-type	是	存储类型(固定为oss)	oss
http-access-path	是	文件访问域名	https://www.wueasy.com
access-key-id	是	阿里云访问密钥ID	LTAI4XXXXXXXXXX
access-key-secret	是	阿里云访问密钥密文	xxxxxxxxxxxxxxxx
bucket	是	OSS存储空间名称	file1234
endpoint	是	OSS访问域名	oss-cn-wuhan-lr.aliyuncs.com
allowed-upload-suffix	是	允许上传的文件后缀	jpg,png,pdf
max-size	是	文件大小限制	1MIB
allow-delete	否	是否允许删除文件	true

💡 配置指南

1. 准备工作

1. 创建阿里云账号

   • 访问阿里云官网注册账号
   • 开通对象存储OSS服务

2. 获取访问密钥

   • 访问RAM访问控制
   • 创建RAM用户并获取AccessKey
   • 保存AccessKey ID和AccessKey Secret

3. 创建Bucket

   • 访问OSS管理控制台
   • 创建新的Bucket
   • 记录Bucket名称和访问域名

2. 安全建议

安全提示

• 使用RAM用户访问OSS，禁止使用主账号
• 遵循最小权限原则配置RAM权限
• 定期轮换AccessKey
• 开启服务端加密功能
• 配置防盗链和跨域访问策略

3. 性能优化

1. 存储类型选择

   • 标准存储：频繁访问的文件
   • 低频访问：月访问次数较少的文件
   • 归档存储：长期存储且极少访问的文件
   • 冷归档存储：超长期存储的文件

2. 访问优化

   • 开启CDN加速
   • 选择合适的地域
   • 使用断点续传
   • 配置图片处理规则

❗ 常见问题

1. 上传失败

   • 检查AccessKey配置
   • 验证Bucket权限设置
   • 确认网络连接状态
   • 检查文件大小限制

2. 访问速度慢

   • 检查CDN配置
   • 确认地域选择是否合适
   • 验证网络带宽

📚 相关文档

• 阿里云OSS文档

版本说明

• 支持阿里云OSS所有地域
• 支持服务端加密
• 支持图片处理
• 支持防盗链配置
• 支持CDN加速