---
kind: external_dependency
name: MinIO 对象存储服务
slug: minio
category: external_dependency
category_hints:
    - vendor_identity
scope:
    - '**'
---

### MinIO 对象存储
- 角色：文件模块（crm-file）的底层对象存储，用于直传/分片上传、下载、预览的文件持久化
- 集成点：`crm-file` 模块通过 `io.minio:minio` SDK 访问；配置前缀 `crm.file.minio`（endpoint/access-key/secret-key/bucket）
- 使用模式：单 bucket（默认 `crm`），按业务域隔离 objectKey（`{bizDomain}/{yyyy}/{MM}/{fileId}.{ext}`）；浏览器不直接接触 MinIO，通过后端签发的 presigned URL 或 kkFileView 回源访问
- 关键约束：分片大小下限 5MB（composeObject 要求）；孤儿分片由定时任务清理
- verify exact API/params against official docs