iconsulting/infrastructure/minio/README.md

MinIO 对象存储

iConsulting 项目的文件存储基础设施。

概述

MinIO 是一个高性能的 S3 兼容对象存储服务，用于存储：

• 用户上传的图片
• PDF 文档
• 其他附件文件

访问地址

• API 端点: http://localhost:9000
• 管理控制台: http://localhost:9001

默认凭据

用户名: minioadmin
密码: minioadmin123

生产环境请修改 .env 中的 MINIO_ROOT_USER 和 MINIO_ROOT_PASSWORD

Bucket 结构

iconsulting/
├── uploads/           # 用户上传的原始文件
│   ├── images/        # 图片文件
│   ├── documents/     # PDF/文档
│   └── temp/          # 临时文件
├── processed/         # 处理后的文件
│   ├── thumbnails/    # 缩略图
│   └── extracted/     # 提取的内容
└── exports/           # 导出文件

文件命名规则

{bucket}/{category}/{userId}/{year}/{month}/{uuid}.{ext}

示例: uploads/images/user123/2025/01/550e8400-e29b-41d4-a716-446655440000.jpg

生命周期策略

• temp/ 目录: 24小时后自动删除
• processed/thumbnails/: 30天后自动删除
• 其他文件: 永久保留

安全配置

1. 所有 bucket 默认私有
2. 通过预签名 URL 提供临时访问
3. 支持服务端加密 (SSE)