SpringBoot+RustFS保姆级教程！文件管理全场景实战，含分片上传企业级方案

# 拉取最新镜像
docker pull rustfs/rustfs:latest

# 运行RustFS容器
docker run -d \
  -p 9000:9000 \
  -p 9001:9001 \
  --name rustfs \
  -v /mnt/data:/data \
  -e "RUSTFS_ACCESS_KEY=admin" \
  -e "RUSTFS_SECRET_KEY=your_strong_password" \
  rustfs/rustfs:latest

参数说明：

-p 9000:9000：API端口，用于S3接口访问
-p 9001:9001：控制台端口，用于Web管理
-v /mnt/data:/data：数据持久化目录（生产环境务必使用绝对路径）
RUSTFS_ACCESS_KEY和RUSTFS_SECRET_KEY：管理员账号密码

2.2 二进制部署（生产环境）

对于生产环境，我建议采用二进制部署以获得更好性能：

# 下载预编译二进制包
wget https://github.com/rustfs/rustfs/releases/download/v0.9.3/rustfs_0.9.3_linux_amd64.tar.gz

# 解压并安装
tar -zxvf rustfs_0.9.3_linux_amd64.tar.gz
sudo mv rustfs /usr/local/bin/

# 创建数据目录
mkdir -p /data/rustfs
chmod 755 /data/rustfs

# 启动服务
rustfs serve --data-dir /data/rustfs \
  --address 0.0.0.0:9000 \
  --access-key admin \
  --secret-key your_strong_password \
  --console-enable \
  --console-address 0.0.0.0:9001

部署完成后，访问 http://localhost:9001使用设置的账号密码登录管理控制台。

三、SpringBoot集成RustFS：基础文件操作

3.1 项目搭建与依赖配置

首先创建SpringBoot项目，在pom.xml中添加必要依赖：

<dependencies>
    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- AWS S3 SDK（RustFS兼容S3协议） -->
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
        <version>2.20.59</version>
    </dependency>

    <!-- 工具库 -->
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
    </dependency>
    
    <!-- 简化IO操作 -->
    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.11.0</version>
    </dependency>
</dependencies>

3.2 配置RustFS连接

在application.yml中配置RustFS连接信息：

rustfs:
  endpoint: http://localhost:9000
  access-key: admin
  secret-key: your_strong_password
  bucket-name: my-bucket

spring:
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 100MB

3.3 创建RustFS配置类

@Configuration
@ConfigurationProperties(prefix = "rustfs")
public class RustFSConfig {
    private String endpoint;
    private String accessKey;
    private String secretKey;
    private String bucketName;

    @Bean
    public S3Client s3Client() {
        return S3Client.builder()
                .endpointOverride(URI.create(endpoint))
                .region(Region.US_EAST_1)
                .credentialsProvider(StaticCredentialsProvider.create(
                    AwsBasicCredentials.create(accessKey, secretKey)))
                .forcePathStyle(true)  // 关键配置！RustFS需启用Path-Style
                .build();
    }

    // getters and setters
}

3.4 实现基础文件操作服务

@Service
@Slf4j
public class FileStorageService {
    @Autowired
    private S3Client s3Client;
    
    @Value("${rustfs.bucket-name}")
    private String bucketName;

    /**
     * 上传文件
     */
    public String uploadFile(MultipartFile file) {
        try {
            // 检查存储桶是否存在，不存在则创建
            if (!bucketExists(bucketName)) {
                createBucket(buck