☁️ S3协议对象存储配置

🔄 上传流程

⚙️ 配置说明

基础配置示例

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

参数说明

参数名	必填	说明	示例值
business-type	是	业务类型标识	demo
file-type	是	存储类型(固定为s3)	s3
http-access-path	是	文件访问域名	https://www.wueasy.com
access-key-id	是	S3访问密钥ID	AKIAXXXXXXXX
access-key-secret	是	S3访问密钥密文	xxxxxxxxxxxxxxxx
bucket	是	S3存储桶名称	cn-east-2
endpoint	是	S3访问域名	s3.cn-east-2.jdcloud-oss.com
allowed-upload-suffix	是	允许上传的文件后缀	jpg,png,pdf
max-size	是	文件大小限制	1MIB

💡 配置指南

1. 支持的S3兼容存储

兼容性说明

本服务支持以下S3兼容存储服务：

• Amazon S3
• 京东云 OSS
• MinIO
• Ceph RGW
• 其他兼容S3协议的存储服务

2. 准备工作

1. 创建存储服务账号

   • 注册相应的云服务账号
   • 开通对象存储服务
   • 获取服务endpoint

2. 获取访问密钥

   • 创建访问密钥（Access Key）
   • 保存 Access Key ID 和 Secret
   • 配置适当的访问权限

3. 创建存储桶

   • 在存储服务控制台创建Bucket
   • 配置存储桶访问权限
   • 记录存储桶名称和访问域名

3. 安全建议

安全提示

• 使用独立的子账号访问存储服务
• 配置最小必要的访问权限
• 定期更新访问密钥
• 开启存储桶加密
• 配置跨域和防盗链策略

4. 性能优化

1. 存储配置优化

   • 选择合适的存储类型
   • 配置生命周期规则
   • 启用版本控制（如需要）

2. 访问优化

   • 配置CDN加速
   • 选择就近的地域
   • 使用分片上传
   • 配置合适的缓存策略

❗ 常见问题

1. 连接问题

   • 检查endpoint配置是否正确
   • 验证网络连接是否正常
   • 确认防火墙设置

2. 认证失败

   • 验证密钥配置是否正确
   • 检查密钥权限是否足够
   • 确认存储桶权限设置

3. 性能问题

   • 检查网络带宽
   • 优化文件大小
   • 考虑使用CDN
   • 调整并发上传配置

📚 相关文档

• Amazon S3文档
• MinIO文档
• S3协议规范

版本说明

• 支持S3协议标准接口
• 支持分片上传
• 支持服务端加密
• 支持访问控制
• 支持CDN加速