ymlisoft/kkfileview repository overview

⁠ymlisoft/kkfileview

文档在线预览精简版。项目地址：https://gitee.com/jinxing-ahstar/file-online-preview⁠

只支持 doc / docx / wps / xls / xlsx / csv / ppt / pptx / pdf / ofd。图片、压缩包、音视频、CAD、文本 / 代码、邮件等其它后缀一律不支持。

预览入口：/onlinePreview?url=<Base64(文件地址)>。Word / PPT 可走 PDF 或图片模式；表格用 Univer（.xls 先转 xlsx），预览只读、禁止新增工作表。

运行栈：Spring Boot 4.1.1、Temurin 25、Tomcat 11.0.25、JODConverter 4.4.11、PDF.js 6.3.289、Univer 0.25.1。镜像同时提供 linux/amd64 与 linux/arm64。
系统层在底包 ymlisoft/kkfileview-base⁠；本仓库镜像只叠应用发行包。

⁠使用

当前推荐 tag：5.0.2-9（与 latest 同一构建）。

docker run -d --name kkfileview \
  -p 8080:8080 \
  -e KK_SERVER_PORT=8080 \
  ymlisoft/kkfileview:5.0.2-9

常用覆盖：KK_TRUST_HOST、KK_OFFICE_HOME、KK_OFFICE_PREVIEW_TYPE（pdf/image）、KK_INDEX_PREVIEW_ENABLED、KK_ASSET_VERSION、KK_PDF2JPG_DPI、WATERMARK_TXT、JAVA_OPTS；可挂载 file 与 application.properties。

⁠项目能力

• REST 接入：业务系统只需拼 /onlinePreview?url=…，不依赖首页表单
• Word / PPT：pdf（PDF.js）或 image（页图）两种模式；可按模式提前进预览，互不串路
• PDF 模式提前页写 {name}.preview.pdf、全量写 {name}.pdf；图片模式 PPT 优先逐页出 JPG，Word 等先整份 PDF 再 pdf2jpg
• 图片页用 GET /imagePages/status 轮询已落盘页，避免对未出图 jpg 刷 404
• 下载 / 转换各默认 3 分钟超时，合计硬顶 6 分钟；等待页到点可重试。大 PPTX 容忍 LibreOffice 断连
• 表格：xls / xlsx / csv 走 Univer；.xls 先转 xlsx；预览侧隐藏并拦截加 sheet
• OFD 独立预览页；源 PDF 直接 PDF.js 或按模式出图
• 壳静态资源 /static/{kk.asset.version}/，转换产物统一 /docs/
• 转换等待页仅转圈 +「文档转换中」；失败只显示简短中文，Office 错误保留原文
• 水印：office.watermark + watermark.txt / WATERMARK_TXT；空文本则不打水印；PDF.js 缩放后按页重绘
• PDF.js 不暴露 LibreOffice 元数据，避免 Chrome 密码框误报
• 正式 trust.host 默认空；连接阶段拦截本机 / 内网。详见仓库 SECURITY_CONFIG.md
• LibreOffice 默认自动查找；本机路径用 KK_OFFICE_HOME 覆盖，不要写进发行默认

⁠镜像说明

• 仅上述 10 种文档后缀
• JDK Temurin 25（Ubuntu 26.04），可用 JAVA_OPTS / -XX:MaxRAMPercentage
• 字体只用可再分发的 Liberation / Carlito / Caladea / 文泉驿 / Noto CJK
• 默认禁止 html / htm / xhtml / js 以及常见可执行与脚本后缀
• 版本记录见仓库 CHANGELOG⁠

kk 官网：https://kkview.cn/⁠