How to Enable Any File Online Preview with Spring Boot, MinIO, and kkFileView

kkFileView Overview

kkFileView is an open‑source universal online preview project built on SpringBoot, currently with over 21k stars on Gitee. It is easy to set up and supports preview of almost all common file types.

Installation

Using Docker to install MinIO and kkFileView is convenient.

MinIO

Pull the MinIO Docker image: docker pull minio/minio Run the MinIO container, exposing port 9001 for the console and 9090 for the service:

docker run -p 9090:9000 -p 9001:9001 --name minio \
 -v /mydata/minio/data:/data \
 -e MINIO_ROOT_USER=minioadmin \
 -e MINIO_ROOT_PASSWORD=minioadmin \
 -d minio/minio server /data --console-address ":9001"

Access the console at http://192.168.3.101:9001 using the default credentials minioadmin:minioadmin.

kkFileView

Pull the kkFileView Docker image: docker pull keking/kkfileview Run the kkFileView container on port 8012:

docker run -p 8012:8012 --name kkfileview \
 -d keking/kkfileview

Open the kkFileView test page at http://192.168.3.101:8012.

Usage

Now we explain how to use MinIO and kkFileView together.

Preparation

Create a bucket named preview in MinIO.

Set the bucket policy to Public for external access.

Upload files to the bucket.

Files can be accessed via http://192.168.3.101:9090/{bucketName}/{fileName}. For example, http://192.168.3.101:9090/preview/avatar.png.

File Preview

Use kkFileView to preview files stored in MinIO.

Image

Open the kkFileView preview page, enter the file name, and obtain the preview link.

Preview URL format:

http://192.168.3.101:8012/onlinePreview?url=base64Encode($url)

Word, PDF, PPT, Markdown, Excel, Archive

Examples of previewing these file types are shown in the original article (images omitted for brevity).

Conclusion

This guide demonstrates how to achieve online preview of any file with SpringBoot, MinIO, and kkFileView without writing additional code.

Project Repository

https://gitee.com/kekingcn/file-online-preview