Easy同学正在独立开发

kkFileView 是一个开源的通用文件在线预览项目,基于 Spring Boot 开发。部署一个服务,业务系统里的 Office、PDF、图片、音视频、压缩包、CAD、3D 模型等文件就能直接在浏览器里预览,用户不用下载文件,也不用在本地装 Office。项目对外提供 REST API,前端把文件地址传过去,返回一个预览地址就能嵌入页面;官方在线演示站点是 file.kkview.cn,可以直接传文件体验。

这个项目从 2017 年 12 月开始维护,目前在 GitHub 上有 14.4k star、3.3k fork,采用 Apache License 2.0 协议。官网列出的登记企业用户超过 150 家,包括中国中车、烽火通信、金蝶精一、同济大学教务系统、开源中国等。

支持的文件类型有 20 多个大类:Office 文档(doc/docx/xls/xlsx/ppt/pptx)、WPS 格式、PDF、OFD 版式文件、图片、音频视频、zip/rar 压缩包、CAD 图纸(dwg/dxf)、3D 模型(obj/stl/fbx/gltf)、Visio、XMind、邮件文件(eml/msg)、epub 电子书、bpmn 流程图,以及 txt、md、java、py 等文本和代码文件。底层文件转换依赖 LibreOffice,Windows 自带、Linux 下自动安装;Redis 可选装,默认不需要。

部署方面提供 Docker 镜像和一键启动脚本,JDK 21 及以上即可运行,也支持配置 TrustHost 只允许信任来源的文件预览、给预览文件加水印。最新版本是 2026 年 7 月 13 日发布的 5.0.1,修复了两个安全问题:/addTask 接口绕过信任主机和本地目录过滤,可被利用做服务端请求伪造(SSRF);/listFiles 接口的目录参数可以越出演示目录,存在路径遍历和信息泄露风险。5.0.0 版本新增了 msg 邮件文件预览、HEIC 图片预览、CAD 查看器、AES 加密和 Basic 认证等功能,并要求 JDK 21 以上。

（由 流苏ªⁱ 撰写）

GitHub: 网页链接官网: 网页链接在线演示: 网页链接

kkFileView开源项目文件预览SpringBoot