RustFS接口实战：Java+Docker实现实时上传下载，代码拿来即用！

最新推荐文章于 2025-11-24 14:38:43 发布

原创最新推荐文章于 2025-11-24 14:38:43 发布 · 1k 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#eureka #云原生 #RustFS #企业存储 #开发语言 #对象存储 #java

RustFS存储开发札记专栏收录该内容

121 篇文章

订阅专栏

新星杯·14天创作挑战营·第17期 10w+人浏览 490人参与

在日常开发中，对象存储的集成总让人头疼？本文通过完整可运行的Java代码，手把手教你实现RustFS的实时上传下载功能，带你彻底告别集成难题！

一、环境准备：5分钟快速搭建RustFS服务

1.1 Docker一键启动RustFS

1.2 验证服务可用性

二、Java项目配置：依赖引入与客户端初始化

四、RESTful API控制器：提供HTTP接口

一、环境准备：5分钟快速搭建RustFS服务

1.1 Docker一键启动RustFS

首先使用Docker快速搭建RustFS服务环境：

# 创建项目目录
mkdir rustfs-java-demo && cd rustfs-java-demo

# 创建docker-compose.yml
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  rustfs:
    image: rustfs/rustfs:latest
    container_name: rustfs-server
    ports:
      - "9000:9000"  # S3 API端口
      - "9001:9001"  # 控制台端口
    environment:
      RUSTFS_ACCESS_KEY: "admin"
      RUSTFS_SECRET_KEY: "password123"
    volumes:
      - ./data:/data
    restart: unless-stopped
EOF

# 启动服务
docker-compose up -d

# 验证服务状态
docker ps | grep rustfs

1.2 验证服务可用性

# 检查服务健康状态
curl http://localhost:9000/minio/health/live

# 访问Web控制台
echo "控制台地址: http://localhost:9001"
echo "用户名: admin"
echo "密码: password123"

二、Java项目配置：依赖引入与客户端初始化

2.1 Maven依赖配置

创建Spring Boot项目，在pom.xml中添加必要依赖：

<dependencies>
    <!-- Spring Boot Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- AWS S3 SDK -->
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
        <version>2.20.0</version>
    </dependency>
    
    <!-- 文件操作工具 -->
    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.13.0</version>
    </dependency>
</dependencies>

2.2 RustFS配置类

创建配置类RustFSConfig.java：

package com.rustfs.demo.config;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;

import java.net.URI;

@Configuration
public class RustFSConfig {
    
    @Value("${rustfs.endpoint:http://localhost:9000}")
    private String endpoint;
    
    @Value("${rustfs.access-key:admin}")
    private String accessKey;
    
    @Value("${rustfs.secret-key:password123}")
    private String secretKey;
    
    @Value("${rustfs.region:us-east-1}")
    private String region;
    
    @Bean
    public S3Client s3Client() {
        return S3Client.builder()
                .endpointOverride(URI.create(endpoint))
                .credentialsProvider(StaticCredentialsProvider.create(
                        AwsBasicCredentials.create(accessKey, secretKey)))
                .region(Region.of(region))
                .forcePathStyle(true)  // 必须设置为true用于兼容RustFS
                .build();
    }
}

2.3 应用配置文件

application.yml配置：

rustfs:
  endpoint: "http://localhost:9000"
  access-key: "admin"
  secret-key: "password123"
  region: "us-east-1"
  bucket-name: "my-bucket"

server:
  port: 8080

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