Files
ai-soulmate-local-deployment/decisions/ADR-0002-local-object-storage.md
T

1017 B

ADR-0002:本地对象存储通过兼容层接入

  • 状态:待验证
  • 日期:2026-08-05

背景

平台后端和管理端当前直接依赖阿里 OSS SDK。只替换连接地址不能构成本地部署,必须先解耦 SDK 和业务逻辑。

暂定决策

业务代码使用统一对象存储接口,至少实现 Alibaba OSS 与本地 S3 兼容存储两个 provider。具体本地产品不在完成兼容性测试前锁定;优先评估客户已有 S3 服务与许可证清晰、可离线交付的候选方案。

准入测试

  • 服务端上传/下载/删除、对象存在性和元数据;
  • 浏览器预签名 PUT/GET、CORS 和过期行为;
  • 分片上传、大文件、中文文件名和内容类型;
  • 权限隔离、凭证轮换、审计和容量配额;
  • 备份、恢复、升级、磁盘满和异常断电恢复;
  • 与现有 OSS URL/对象数据的迁移和回滚。

通过准入测试并确认许可证、运维与备份责任后,再将选定实现加入正式 Compose。