v5.0.2
已同步的安全修复
- 为 /addTask 加入信任主机和本地目录过滤。
- 将 /listFiles 限制在演示目录内。
- 将 HTML 预览放入隔离沙箱，默认禁用脚本。
- 默认禁用文件删除；启用后使用 POST 和精确密码比较。
Release Timeline
版本发布记录
你可以先看最新版本的升级重点，再顺着时间轴继续了解历史版本细节。
当前版本 v5.0.2
上游发布日期 2026-08-14
JDK 21+ 强制要求
安全修复
2026
v5.0.0
优化
- 优化 xlsx、图片、tif、svg、json 解析效果。
- 优化 FTP 多客户端接入与 marked 解析。
- 首页支持目录访问，并切换为 POST 服务端分页。
- 压缩包预览页重构为单工作区布局，支持目录折叠与右侧内嵌预览。
- 优化压缩包内文件类型标识，以及单图预览页展示样式。
- 重构演示门户页面，包括首页、接入说明与版本记录。
新增
- 新增 msg、heic/heif、页码、高亮、AES、Basic Auth、秘钥等能力。
- 新增防重复转换、异步等待、上传限制与 cadviewer 转换方法。
- 新增 pptm 支持。
- 补充面向工程自动化与编码代理的仓库说明文档。
修复
- 修复压缩包路径问题与安全问题。
- 修复图片水印不完整。
- 修复 SSL 自签证书接入问题。
- 修复压缩包内 Office 文件重复解压后被追加写坏、导致一直加载中的问题。
- Office 默认预览切到 PDF 模式，并默认展开 PDF 缩略图侧栏。
- 修复 OFD 表格竖线溢出导致的渲染异常，并修正 PDF.js 兼容性补丁。
更新
- JDK 版本要求升级到 21 及以上。
- 前端解析链路升级：PDF、ODF、3D 模型。
- 后端异步转换升级：PDF、TIF、视频、CAD。
- 启动脚本改为自动发现当前发布包中的 jar，并同步更新 Docker 与发布辅助文档。
- 默认配置策略调整：Office 预览默认使用 PDF 模式，默认隐藏图片/PDF 模式切换按钮；如需保留旧的图片优先体验，请显式设置
office.preview.type=image与office.preview.switch.disabled=false。 - 信任域名配置匹配策略扩展：
trust.host及相关规则支持通配符与 CIDR 匹配；升级后请重新核对白名单和黑名单的匹配范围。
2025
v4.4.0
优化
- 升级 xlsx、markdown、dcm、PDF.JS、epub 等前端解析组件。
- Office 功能调整，支持批注、页码限制与水印。
- 自动检测 Office 安装路径，增强 LibreOffice 7.5 / 7.6 兼容。
- 优化 Dockerfile，支持真正跨平台构建镜像。
新增
- 新增 xlsx 打印、GZIP 压缩、CSV 前端解析、xbrl 预览。
- CAD 支持转换 SVG/TIF，新增超时结束与线程管理。
- 增加验证码删除、Host 黑名单、Office 转换超时设置。
修复
- 修复 forceUpdatedCache、本地缓存、PDF 解密、BPMN 跨域等问题。
- 修复视频跨域、TXT 二次分页、Markdown 转义、EPUB 跨域。
- 修复压缩包穿越漏洞和多类路径 / 水印问题。
升级重点
- PDF 预览新增签名、绘图、插图控制与搜索定位能力。
- Drawio 默认改为预览模式。
- ckplayer 替换旧视频播放器。
2024
v4.4.0-beta
能力铺垫
- 升级 OFD、xlsx、CAD、markdown、dcm、PDF.JS 与 epub 解析组件。
- 首页开始引入搜索、页码定位与显示内容定义能力。
- 加入 CSV 前端解析与 Office 转换超时配置。
安全与稳定
- 修复 forceUpdatedCache、PDF 解密后台报错与 bpmn 跨域问题。
- 增强视频跨域、压缩包路径、url 特殊符号与多媒体缓存清理逻辑。
- 加入 Host 黑名单与验证码删除能力。
历史归档
2023-07-04 · v4.3.0
- 新增 dcm、drawio、dwg、PDF 密码、PDF DPI 自定义和 front-end xlsx 解析。
- 加入 pages、eps、iges、igs、dwt、dng、ifc、dwfx、stl、cf2、plt 等格式支持。
- 优化 OFD 兼容性、美化 TXT 分页框，升级 Linux / Windows 内置 LibreOffice 7.5.3。
2023-04-18 · v4.2.1
- 修复 dwg 等 CAD 类型文件空指针问题。
2023-04-13 · v4.2.0
- 新增 SVG、加密 Office / 压缩包、xmind、bpmn、eml、epub、3D 模型等预览支持。
- 新增高风险文件上传限制、站点备案配置、删除文件密码功能。
- 优化演示页 UI、压缩包目录浏览，修复 XSS、OFD 跨域、OOM 与乱码等问题。
2022-12-14 · v4.1.0
- 全新首页视觉改版。
- tif 多页兼容、Docker 分层构建、加密文件基于 userToken 缓存、升级 LibreOffice 7.3。
- 感谢社区贡献者 @yl-yue、@wsd7747、@zhangzhen1979 等。
2021-07-06 · v4.0.0
- 底层集成从 OpenOffice 切换为 LibreOffice。
- 修复压缩目录穿越、PPT PDF 模式与图片预览异常。
- 首页上传能力可通过配置动态启停。
2021-06-17 · v3.6.0
- 新增 OFD 预览与 ffmpeg 视频转码预览支持。
- 美化 PPT / PPTX 预览效果并升级多个基础依赖。
2021-04-06 · v3.5.1
- 修复 tif / tiff 初始内存过小导致预览失败。
- 修复 PDF 预览模式跨域问题。
2021-03-17 · v3.5.0
- 新增 office-plugin 超时可配置、tiff/tif 预览、高亮代码文件预览和 wps 支持。
- 升级 Spring Boot 2.4.2，优化项目结构、脚本与下载 IO。
2021-01-28 · v3.3.1
- 更新 index、markdown、XML、simTxt 等页面 UI 风格。
- 修复图片、压缩包、多种编码与危险字符相关问题。
2020-12-27 · v3.3.0
- 大规模架构重构，增强 XML / Markdown 文本预览架构。
- 切换底层 web server 为 Jetty，引入 cpdetector，Base64 + urlencode 双编码。
- Office 组件加载异步化，明显提速应用启动速度。
2020-08-12 · v2.2.1
- 支持纯文本预览原样输出，升级 pdf.js，优化 Docker 镜像底层。
- 预览接口同时支持 GET 和 POST。
2020-05-20 · v2.2.0
- 新增全局水印、CAD 预览、base.url、环境变量配置与站点信任控制。
- 支持缓存清理 cron、自定义限制 PDF 下载、官网和 Docker 仓库建设。
2019-06-20 / 2019-04-08
- 支持自动清理缓存、HTTP/HTTPS 下载流 URL、FTP URL 与 Docker 构建。
- 缓存及队列实现抽象，提供 JDK 与 Redis 两种实现。
2018-01 到 2017-12
- 项目初始阶段补齐多图预览、压缩包内图片轮播、文本编码修复与 pdf.js 预览链路。
- 开放 Gitee / GitHub 仓库，逐步打磨 addTask 入队接口与 Redis 队列能力。