8 年磨一剑，kkFileView 5.0.0 正式发布。

作为一个长期服务于文件文档在线预览场景的开源项目，kkFileView 在这次 5.0.0 版本里，不只是继续补格式、补能力、补稳定性，更把首页风格和压缩包预览体验做了一轮完整升级。

这次版本里，用户最容易感知到的变化主要有两块：一是演示门户页面整体改版，首页、接入说明、版本记录与赞助页的视觉风格统一重做；二是压缩包预览页从旧的目录跳转模式升级成单工作区布局，目录树、文件选择和右侧预览整合到同一个页面里，视觉效果和连续浏览体验都有明显提升。

kkFileView 是一个基于 Spring Boot 构建的文件文档在线预览开源解决方案，部署后可独立提供预览服务，通过 HTTP 接口访问，不需要和业务系统强耦合集成，适合跨系统、跨语言场景使用。项目提供 Windows / Linux 发行包、自定义配置文件，以及一键启动 / 停止脚本，同时也支持 Docker 部署。

本次 5.0.0 版本的重点更新如下：

1. 重构压缩包预览体验

• 压缩包预览页重构为单工作区布局，支持目录折叠与右侧内嵌预览。

• 优化压缩包内文件类型标识，连续浏览包内文件时不再频繁跳转页面。

• 从视觉层次、信息布局到操作路径，都围绕“连续浏览压缩包内文件”重新设计。

• 修复压缩包内 Office 文件重复解压后被追加写坏、导致一直卡在加载中的问题。

2. 调整 Office 默认预览策略

• Office 预览默认切换为 PDF 模式。

• PDF 预览默认展开缩略图侧栏。

• 图片 / PDF 模式切换按钮默认隐藏。

3. 补充多项格式与能力支持

• 新增 msg 邮件预览、HEIC/HEIF 预览、pptm 支持。

• 新增页码定位、文本高亮、AES、Basic Auth、秘钥访问等能力。

• 新增防重复转换、异步等待、上传限制与 cadviewer 转换能力。

4. 持续优化预览链路和门户页面

• 优化 xlsx、图片、tif、svg、json 等格式的解析效果。

• 重构演示门户页面，包括首页、接入说明、版本记录与赞助页。

• 修复 OFD 表格竖线溢出导致的渲染异常，并修复 PDF.js 兼容性补丁问题。

• trust.host 及相关规则现已支持通配符和 CIDR 匹配。

升级说明

• JDK 21 及以上现已成为必需要求。

• 如果升级后仍需保持旧的图片优先 Office 预览体验，请显式设置 office.preview.type=image 和 office.preview.switch.disabled=false。

• 如果你依赖域名 / IP 模式匹配，请在升级后重新检查 trust.host 与相关白名单、黑名单规则的实际生效范围。

UI 升级示例

相关链接

• GitHub Release

• Gitee Release

• 项目官网

• 在线体验

• kk 开源社区：https://t.zsxq.com/09ZHSXbsQ