SpringBoot实现任意文件在线预览功能

更新时间：2025年07月29日 10:19:33 作者：白露与泡影

在现代工作与生活环境中,文件共享与查看已经成为日常不可或缺的一部分,不过传统的文件处理方式要求用户下载文件到本地后才能查看,不仅占用了设备的存储空间,还可能导致文件传播效率低下,所以本文给大家介绍了SpringBoot实现任意文件在线预览功能,需要的朋友可以参考下

一文件在线预览

在现代工作与生活环境中，文件共享与查看已经成为日常不可或缺的一部分。不过传统的文件处理方式要求用户下载文件到本地后才能查看，这不仅占用了设备的存储空间，还可能导致文件传播效率低下，甚至存在安全隐患。

因此，现在很多应用都支持文件在线预览，像我们常见的 docx、pptx、xlsx、md、图片、pdf 等等都可以在浏览器中直接查看文件内容，无需下载，大大提高了文件处理的便捷性和安全性。

二 kkFileView

kkFileView 是一个基于 Spring Boot 框架构建的开源文件文档在线预览解决方案。它不仅支持广泛的文件类型，而且使用非常简单。

kkFileView 主要有如下一些特点：

广泛支持的文件类型：kkFileView 支持包括但不限于 doc、docx、xls、xlsx、ppt、pptx、pdf、txt 等主流办公文档，以及 jpg、jpeg、png、gif 等图像文件，mp3、wav、mp4、flv 等音视频格式，zip、rar、jar 等压缩包文件，还有多种类文本及代码文件，如 html、xml、json、yaml、java、py、cpp 等。
易部署性：kkFileView 提供了 ZIP、TAR.GZ 发行包和 Docker 镜像，支持一键启动脚本和丰富的配置项，无论是物理机、虚拟机还是 Docker 容器环境，都能轻松部署。
跨平台服务：kkFileView 支持 Windows、Linux 和 MacOS 等多种操作系统，实现了跨平台的无缝使用。
高性能：基于高效的文件读取与流传输策略，kkFileView 在处理大文件时也能保持流畅，提升用户体验。
安全性：通过设置访问权限和时效性 token，kkFileView 可以有效保护文件安全，防止未授权访问和恶意操作。
API 接口：提供 RESTful API，支持 Java、PHP、Python、Go 等多种开发语言，方便与其他系统集成。
开源免费：kkFileView 遵循 Apache 2.0 许可证，用户可以根据需要自由修改和分发。
扩展性强：支持多种文件类型，且易于添加新的文件类型支持或自定义显示模板。

三使用 kkFileView

kkFileView 是独立部署运行的，所以使用起来非常方便。

3.1 安装部署

kkFileView 需要先安装才能使用。这也是官方推荐的使用方式。

安装有两种方式。

下载源码启动

从 https://gitee.com/kekingcn/file-online-preview/releases 下载最新版发行包
解压 kkFileView-x.x.x 文件（Windows 用 .zip 包，Linux/MacOS 用 .tar.gz 包）
打开解压后文件夹的 bin 目录，运行 startup 脚本（Windows 下以管理员身份运行startup.bat，Linux 以 root 用户运行 startup.sh）
浏览器访问本机 8012 端口 http://127.0.0.1:8012 即可看到项目演示用首页

Docker 启动

启动脚本：

docker run -it -p 8012:8012 keking/kkfileview:4.1.0

如果网络不畅，可以通过如下方式启动：

wget https://kkfileview.keking.cn/kkFileView-4.1.0-docker.tar
docker load -i kkFileView-4.1.0-docker.tar
docker run -it -p 8012:8012 keking/kkfileview:4.1.0

启动之后，页面如下：

3.2 文件预览

当我们的项目内需要预览文件时，只需要调用浏览器打开 kkFileView 的预览接口，并传入须要预览文件的 url，类似下面这样：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/js-base64@3.6.0/base64.min.js"></script>
</head>
<body>
<script>
    var url1 = 'http://192.168.43.178:8080/1.csv';
    var url2 = 'http://192.168.43.178:8080/2.png';
    var url3 = 'http://192.168.43.178:8080/3.doc';
    var url4 = 'http://192.168.43.178:8080/4.pdf';
    var url5 = 'http://192.168.43.178:8080/5.pptx';
    var url6 = 'http://192.168.43.178:8080/6.md';
</script>
<button onclick="window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url1)));">csv</button>
<br>
<button onclick="window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url2)));">png</button>
<br>
<button onclick="window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url3)));">doc</button>
<br>
<button onclick="window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url4)));">pdf</button>
<br>
<button onclick="window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url5)));">pptx</button>
<br>
<button onclick="window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url6)));">md</button>
<br>
</body>
</html>

url1~url6 是我这里几个不同格式文件的访问地址，调用 kkFileView 的预览接口 http://127.0.0.1:8012/onlinePreview，并将我们的文件 url 作为参数传递进去，就可以预览文件内容了。

是不是很简单！

这是官方给的使用方式。如果想把这个项目合并到自己现有项目中，也是可以的，只是稍微麻烦一些，需要分析接口并且手动合并代码了，不过对于有经验的小伙伴来说，应该也不是啥难事。

以上就是SpringBoot实现任意文件在线预览功能的详细内容，更多关于SpringBoot任意文件预览的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Java中反射的应用
这篇文章主要介绍了Java中反射的应用,通过反射,我们可以在运行时检查类的属性、方法和构造函数,并且可以在不知道类名的情况下创建对象、调用方法和访问属性,需要的朋友可以参考下
2023-10-10
Java数据结构之实现跳表
今天带大家来学习Java数据结构的相关知识,文中对用Java实现跳表作了非常详细的图文解说及代码示例,对正在学习java的小伙伴们有很好地帮助,需要的朋友可以参考下
2021-05-05
启用Spring事务管理@EnableTransactionManagement示例解析
这篇文章主要为大家介绍了启用Spring事务管理@EnableTransactionManagement示例解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-09-09
Java中的LinkedList集合详解
这篇文章主要介绍了Java中的LinkedList集合详解, LinkedList 是一个双向链表结构（JDK1.6 之前为循环链表,JDK1.7 取消了循环）,在任意位置插入删除都很方便,但是不支持随机取值,每次都只能从一端开始遍历,直到找到查询的对象,然后返回,需要的朋友可以参考下
2023-09-09
IDEA自定义setter和getter格式的设置方法
这篇文章主要介绍了IDEA自定义setter和getter格式的设置方法,本文通过图文并茂的形式给大家介绍的非常详细,需要的朋友参考下吧
2023-12-12
java8学习教程之lambda表达式的使用方法
Java8最值得学习的特性就是Lambda表达式，下面这篇文章主要给大家介绍了关于java8学习教程之lambda表达式使用的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧。
2017-09-09
SpringCloud组件OpenFeign之默认HTTP请求方式详解
这篇文章主要介绍了SpringCloud组件OpenFeign之默认HTTP请求方式详解,在SpringMvcContract类中有个这样的方法processAnnotationOnMethod,见名思意,这个方法就是处理Feign接口下方法上的注解的,需要的朋友可以参考下
2024-01-01
java获取request中的参数以及java解析URL问号后的参数
这篇文章主要介绍了java获取request中的参数以及java解析URL问号后的参数问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-12-12
Maven中resources标签的用法详解
本文主要介绍了Maven中resources标签的用法详解，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-01-01
JAVA构造函数不能使用void关键字问题
这篇文章主要介绍了JAVA构造函数不能使用void关键字问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-03-03