From 3a0803192947d0b211c12f4e8ce7a09ac0fe4b33 Mon Sep 17 00:00:00 2001 From: kl Date: Mon, 13 Jul 2026 17:12:40 +0800 Subject: [PATCH] chore(release): prepare v5.0.1 --- Dockerfile | 4 +- README.cn.md | 23 +++++++++ README.md | 23 +++++++++ pom.xml | 2 +- server/pom.xml | 2 +- server/src/main/resources/web/main/record.ftl | 50 +++++++++++++++++-- 6 files changed, 96 insertions(+), 8 deletions(-) diff --git a/Dockerfile b/Dockerfile index dff9781e..3a434b70 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,4 +1,4 @@ FROM keking/kkfileview-base:5.0.0 ADD server/target/kkFileView-*.tar.gz /opt/ -ENV KKFILEVIEW_BIN_FOLDER=/opt/kkFileView-5.0.0/bin -ENTRYPOINT ["java","-Dfile.encoding=UTF-8","-Dspring.config.location=/opt/kkFileView-5.0.0/config/application.properties","-jar","/opt/kkFileView-5.0.0/bin/kkFileView-5.0.0.jar"] +ENV KKFILEVIEW_BIN_FOLDER=/opt/kkFileView-5.0.1/bin +ENTRYPOINT ["java","-Dfile.encoding=UTF-8","-Dspring.config.location=/opt/kkFileView-5.0.1/config/application.properties","-jar","/opt/kkFileView-5.0.1/bin/kkFileView-5.0.1.jar"] diff --git a/README.cn.md b/README.cn.md index 32ceaa08..8f7d21e8 100644 --- a/README.cn.md +++ b/README.cn.md @@ -149,6 +149,29 @@ pdf预览模式预览效果如下 ### 历史更新记录 +#### > 2026年07月13日，v5.0.1 补丁版本发布 ： + +#### 安全修复 +1. 修复 `/addTask` 未经过信任主机和本地目录过滤，可能导致服务端请求伪造（SSRF）的问题（GHSA-gwwj-52hv-6g2m） +2. 修复 `/listFiles` 的 `directory` 参数可越出演示目录，造成路径遍历和目录信息泄露的问题（GHSA-pmp8-g8p2-p6jq） + +#### 修复问题 +1. 修复 PDF 跨域、页码定位、文本高亮、打印和打印水印相关问题 +2. 修复 PDF 在反向代理场景下的绝对路径问题，以及水印和高亮内容包含特殊字符时的解析失败 +3. 修复 Redis 单机、集群、主从、哨兵模式配置不一致和地址协议缺失问题 +4. 修复下载 MIME 类型校验失败后仍返回成功、HTTP 错误原因不明确，以及共享 HTTP Client 被错误关闭的问题 +5. 修复 LuckyExcel 数据校验类型未映射时的 xlsx 解析崩溃 + +#### 优化内容 +1. 大型 xlsx 文件改用 Web Worker 执行 LuckyExcel 解析，并在 Worker 不可用或异常时自动回退主线程 +2. 新增 `pdf.sidebar.open` 配置，可控制 PDF 预览是否默认打开侧栏 +3. Maven CI 增加 Linux、Windows、macOS 构建验证 +4. 新增仓库安全策略和私密漏洞报告入口 + +#### 升级说明 +1. 建议所有 v5.0.0 及更早版本用户尽快升级到 v5.0.1 +2. 本版本继续要求 JDK 21 及以上，现有 v5.0.0 配置可直接沿用 + #### > 2026年04月14日，v5.0.0 版本发布 ： #### 优化内容 1. xlsx 前端解析优化 - 提升Excel文件前端渲染性能 diff --git a/README.md b/README.md index 474cb41c..f4d93e23 100644 --- a/README.md +++ b/README.md @@ -65,6 +65,29 @@ URL：[https://file.kkview.cn](https://file.kkview.cn) ## Change History +### Version 5.0.1 (July 13, 2026) + +#### Security Fixes +1. Fixed `/addTask` bypassing trusted-host and local-directory filters, which could allow server-side request forgery (SSRF) (GHSA-gwwj-52hv-6g2m) +2. Fixed the `/listFiles` `directory` parameter escaping the demo directory, which could allow path traversal and directory information disclosure (GHSA-pmp8-g8p2-p6jq) + +#### Fixes +1. Fixed PDF cross-origin access, page positioning, text highlighting, printing, and print watermark issues +2. Fixed PDF absolute paths behind reverse proxies and parsing failures when watermark or highlight text contains special characters +3. Fixed inconsistent Redis settings across standalone, cluster, master-replica, and sentinel modes, including missing address protocols +4. Fixed successful responses after MIME validation failures, unclear HTTP error reporting, and accidental closure of a shared HTTP client +5. Fixed xlsx parsing crashes when LuckyExcel data-validation types have no mapping + +#### Improvements +1. Moved LuckyExcel parsing for large xlsx files into a Web Worker, with automatic main-thread fallback when the Worker is unavailable or fails +2. Added `pdf.sidebar.open` to control whether the PDF sidebar opens by default +3. Added Linux, Windows, and macOS validation to Maven CI +4. Added a repository security policy and private vulnerability reporting guidance + +#### Upgrade Notes +1. All users running v5.0.0 or earlier are strongly encouraged to upgrade to v5.0.1 +2. JDK 21 or higher remains required, and existing v5.0.0 configuration can be reused + ### Version 5.0.0 (April 14, 2026) #### Improvements diff --git a/pom.xml b/pom.xml index 61e104db..a33c3b7d 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,7 @@ cn.keking kkFileView-parent - 5.0.0 + 5.0.1 diff --git a/server/pom.xml b/server/pom.xml index bf620c30..c60cb36d 100644 --- a/server/pom.xml +++ b/server/pom.xml @@ -6,7 +6,7 @@ kkFileView-parent cn.keking - 5.0.0 + 5.0.1 kkFileView diff --git a/server/src/main/resources/web/main/record.ftl b/server/src/main/resources/web/main/record.ftl index 115ce7fa..e1e9455f 100644 --- a/server/src/main/resources/web/main/record.ftl +++ b/server/src/main/resources/web/main/record.ftl @@ -41,10 +41,10 @@ 你可以先看最新版本的升级重点，再顺着时间轴继续了解历史版本细节。

- 最新版本 v5.0.0 - 发布日期 2026-04-14 + 最新版本 v5.0.1 + 发布日期 2026-07-13 JDK 21+ 强制要求 - 压缩包工作区预览 / PDF 默认模式 + 安全补丁 / PDF、Redis、XLSX 修复
@@ -52,11 +52,53 @@
2026
+
+

v5.0.1

+
+ 2026-07-13 + 最新稳定版本 + 建议尽快升级 +
+
+
+

安全修复

+
    +
  • 修复 /addTask 未覆盖信任主机和本地目录过滤导致的 SSRF 风险。
    • +
  • 修复 /listFiles 可越出演示目录导致的路径遍历和目录信息泄露。
    • +
+
+
+

修复

+
    +
  • 修复 PDF 跨域、页码、高亮、打印、打印水印及反向代理路径问题。
    • +
  • 修复 Redis 多种运行模式的配置兼容问题。
    • +
  • 修复 HTTP 错误处理、共享 Client 生命周期和 xlsx 数据校验解析问题。
    • +
+
+
+

优化

+
    +
  • 大型 xlsx 文件使用 Web Worker 解析，并保留主线程自动回退。
    • +
  • 新增 pdf.sidebar.open，支持配置 PDF 默认侧栏状态。
    • +
  • Maven CI 增加 Linux、Windows、macOS 构建验证。
    • +
+
+
+

升级重点

+
    +
  • 建议所有 v5.0.0 及更早版本用户尽快升级。
    • +
  • 继续要求 JDK 21 及以上。
    • +
  • 现有 v5.0.0 配置可直接沿用。
    • +
+
+
+
+

v5.0.0

2026-04-14 - 最新稳定版本 + 5.0 功能版本 升级需 JDK 21+