onlyoffice minio

### OnlyOffice与MinIO集成配置教程

#### 一、环境准备
为了实现OnlyOffice与MinIO之间的集成，需先准备好必要的开发环境。确保已成功安装并运行了OnlyOffice和MinIO服务器。

对于OnlyOffice的部署可以参照相关指南[^1]；而关于MinIO的下载以及基础设置，则可以从官方渠道获取最新版本及其对应平台下的安装指令[^3]。

#### 二、修改OnlyOffice文档服务端代码适配MinIO对象存储
针对采用Java技术栈构建的应用场景，在完成上述准备工作之后，重点在于调整OnlyOffice的服务端逻辑来支持MinIO作为外部文件系统的接口。这通常涉及到更改原有的文件上传/下载路径至MinIO所提供的API地址，并正确传递认证参数（Access Key 和 Secret Key）。具体操作如下：

- **引入依赖库**

如果项目基于Maven管理依赖关系的话，那么可以在`pom.xml`中加入对MinIO SDK的支持：

  <!-- MinIO Java Client -->
  <dependency>
      <groupId>io.minio</groupId>
      <artifactId|minio|version>8.4.3</version>
  </dependency>

- **编写业务逻辑**

接下来就是按照实际需求编码处理文件读写请求的部分了。这里给出一段简单的例子用于说明如何利用MinIO客户端类创建bucket、上传本地图片到指定位置等常见任务。

  import io.minio.MinioClient;
  import java.io.FileInputStream;

  public class FileService {
    private final String bucketName = "onlyoffice-docs";
    
    public void initBucket() throws Exception{
        try (MinioClient client = new MinioClient("http://localhost:9000", 
                                                  "minio-access-key",
                                                  "minio-secret-key")) {

            boolean found = client.bucketExists(bucketName);
            if (!found){
                client.makeBucket(bucketName);   
            }
        } catch(Exception e){
            throw new RuntimeException(e.getMessage());
        }
    }

    public void uploadFile(String filePath, String objectName)throws Exception{
        try(MinioClient client = new MinioClient("http://localhost:9000", 
                                                 "minio-access-key",
                                                 "minio-secret-key")){
            FileInputStream fileInputStream = new FileInputStream(filePath);

            client.putObject(bucketName,
                             objectName,
                             fileInputStream,
                             null,"application/octet-stream");
            
            System.out.println(objectName+" has been uploaded successfully.");
        }catch(Exception ex){
           throw new RuntimeException(ex.getMessage()); 
        }
    }
  }

以上示例展示了怎样通过编程方式访问MinIO实例中的资源，同时也体现了在应用程序内部集成了第三方云储存解决方案的一种实践方法。

#### 三、更新应用属性配置
最后一步是要把之前提到过的MinIO连接详情录入到Spring Boot项目的配置文件里去，以便于程序启动时能够自动加载这些设定值。编辑位于src/main/resources目录下的application.properties文件，添加如下所示的内容即可[^2]：

# MinIO 连接信息
minio.url=http://localhost:9000
minio.accessKey=minio-access-key
minio.secretKey=minio-secret-key

这样就完成了整个集成过程的关键环节描述。当然，具体的实施细节可能会因个人项目结构的不同有所差异，但总体思路是一致的。