kkFileView

kkFileView是什么？

kkFileView是一款基于 Spring Boot 构建的开源文件在线预览解决方案，适用于web系统在线浏览多种格式的文件资料（Word/Excel/PPT/pdf/txt、图片、音视频、压缩包等）。用户无需下载就可以直接在浏览器上打开和查看文档内容，大大改善了系统用户的交互体验与操作使用效率

该工具支持 Windows 和 Linux 平台一键部署，仅需两行 JS 代码即可快速实现业务接入。kkFileView 提供 RESTful 接口，适用于微服务架构，语言无关，可根据实际需要配置设置预览界面方式：分页图、轮播图、pdf视图等切换样式。

kkFileView的主要功能特点

• 支持多种文件格式：在线预览 word/excel/ppt/pdf/txt 类文档，图片、音视频、zip/rar 等主流文件浏览。
• 无需下载，直接浏览器预览：在网页直接预览此内容文件，更友好交互体验。
• 多种预览模式灵活切换：支持分页图、轮播图或 pdf 视图等可自由切换浏览视图，不同文件类型自适应展示。
• 跨平台部署与调用：支持 Windows、Linux 等系统，提供 RESTful 接口，适用于 Java、Python、PHP、Go 等语言调用。
• 快速集成与一键部署：提供 Docker 镜像与压缩包，两行 JS 即可嵌入业务系统，适合微服务架构。
• 高兼容性与稳定性：能准确解析新版 Office 文档，支持 WPS 格式，适配多种终端设备。
• 开源免费，可二次开发：基于 Spring Boot 构建，架构清晰，便于扩展与定制 。

支持的文件类型

1. 支持 doc, docx, xls, xlsx, xlsm, ppt, pptx, csv, tsv, dotm, xlt, xltm, dot, dotx, xlam, xla, pages 等 Office 办公文档
2. 支持 wps, dps, et, ett, wpt 等国产 WPS Office 办公文档
3. 支持 odt, ods, ots, odp, otp, six, ott, fodt, fods 等OpenOffice、LibreOffice 办公文档
4. 支持 vsd, vsdx 等 Visio 流程图文件
5. 支持 wmf, emf 等 Windows 系统图像文件
6. 支持 psd, eps 等 Photoshop 软件模型文件
7. 支持 pdf ,ofd, rtf 等文档
8. 支持 xmind 软件模型文件
9. 支持 bpmn 工作流文件
10. 支持 eml 邮件文件
11. 支持 epub 图书文档
12. 支持 obj, 3ds, stl, ply, gltf, glb, off, 3dm, fbx, dae, wrl, 3mf, ifc, brep, step, iges, fcstd, bim 等 3D 模型文件
13. 支持 dwg, dxf, dwf, iges , igs, dwt, dng, ifc, dwfx, stl, cf2, plt 等 CAD 模型文件
14. 支持 txt, xml(渲染), md(渲染), java, php, py, js, css 等所有纯文本
15. 支持 zip, rar, jar, tar, gzip, 7z 等压缩包
16. 支持 jpg, jpeg, png, gif, bmp, ico, jfif, webp 等图片预览（翻转，缩放，镜像）
17. 支持 tif, tiff 图信息模型文件
18. 支持 tga 图像格式文件
19. 支持 svg 矢量图像格式文件
20. 支持 mp3,wav,mp4,flv 等音视频格式文件
21. 支持 avi,mov,rm,webm,ts,rm,mkv,mpeg,ogg,mpg,rmvb,wmv,3gp,ts,swf 等视频格式转码预览
22. 支持 dcm 等医疗数位影像预览
23. 支持 drawio 绘图预览

适用场景 

• 企业系统：在线预览合同、方案、报告等文档，提升协作效率
• 教育平台：教师与学生可直接浏览课件、作业，无需下载或安装软件
• 政务门户：公众可在线查阅政策文件、公告，提升信息公开体验
• 知识库系统：支持图书、资料的在线阅读，适配多种格式与终端设备 

kkFileView的使用方法 

1. 部署服务端程序
   • 下载 kkFileView 的分发包（支持 Windows、Linux 或 Docker）
   • 解压后进入 bin 目录，执行 startup.bat（Windows）或 startup.sh（Linux）启动服务
   • 启动成功后，默认访问地址为 http://127.0.0.1:8012
2. 集成到业务系统
   • 在前端页面中添加两行 JS 代码，即可接入预览功能
   • 示例：

     var previewUrl = 'http://127.0.0.1:8012/onlinePreview?url=' + encodeURIComponent(文件下载地址);
     window.open(previewUrl);
     

3. 调用 RESTful 接口
   • kkFileView 提供标准 HTTP 接口，支持跨语言调用（Java、Python、PHP、Go 等）
   • 可通过接口传入文件地址，实现预览跳转或嵌入式展示
4. 配置预览模式（可选）
   • 支持 PDF视图、分页图、轮播图等多种预览方式
   • 可在配置文件中设置默认模式或根据文件类型自动切换