# SpringbootMinioTest

**Repository Path**: ohmok/springboot-minio-test

## Basic Information

- **Project Name**: SpringbootMinioTest
- **Description**: Spring Boot MinIO 集成示例
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-13
- **Last Updated**: 2025-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# Spring Boot MinIO 集成示例

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
![Java Version](https://img.shields.io/badge/Java-8%2B-orange)
![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.4.1-brightgreen)
![MinIO](https://img.shields.io/badge/MinIO-8.2.0-ff69b4)

一个基于 Spring Boot 的 MinIO 文件存储集成示例，提供完整的文件管理 API 和 Docker 部署方案。

## 快速开始

### 环境要求
- JDK 8+
- Maven 3.6+
- Docker 18.09+

### 1. 启动 MinIO 服务
```bash
docker run -d \
  -p 9000:9000 \
  -p 9001:9001 \
  --name minio \
  -v /mnt/data:/data \
  -e "MINIO_ROOT_USER=admin" \
  -e "MINIO_ROOT_PASSWORD=admin123" \
  minio/minio server /data --console-address ":9001"
```

访问控制台：http://localhost:9001  
默认凭证：admin/admin123

### 2. 配置应用
```yaml
# application.yaml
minio:
  endpoint: http://localhost:9000
  access-key: admin
  secret-key: admin123
  bucket: my-bucket
```

### 3. 构建与运行
```bash
mvn clean package
java -jar target/SpringBootMinioTest-1.0-SNAPSHOT.jar
```

访问 API 文档：http://localhost:8080/swagger-ui/index.html

## 主要 API 接口

| 方法 | 端点                         | 描述               |
|------|-----------------------------|--------------------|
| POST | /minio/buckets/{bucketName}/upload | 文件上传          |
| GET  | /minio/buckets/{bucketName}/download/** | 文件下载      |
| GET  | /minio/buckets/{bucketName}/url/** | 获取临时访问链接 |
| POST | /minio/copy                | 文件复制           |
| GET  | /minio/buckets             | 列出所有存储桶     |

## 项目结构
```
src/
├── main/
│   ├── java/
│   │   ├── config/         # 配置类
│   │   ├── controller/     # REST 控制器
│   │   ├── dto/            # 数据传输对象
│   │   ├── service/        # MinIO 服务层
│   ├── resources/
│       ├── application.yaml # 配置文件
```