kkFileView国产化环境实战23类文件格式在线预览的搭建与调优完整指南【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView国产化办公环境里有个高频场景同事发来一份.wps合同、一个.ofd发票包你的浏览器打不开机器上又没装 WPS。传统做法是把文件下载下来、装好对应软件、再人工核对一来一回半天过去了。kkFileView 是一个基于 Spring Boot 的文件在线预览服务把 Office 文档、WPS 国产办公文档、OFD、CAD、3D 模型、压缩包、音视频等 23 类格式统一转成网页可直接浏览的形式。你只需要把文件地址拼进预览 URL就能在浏览器里看到渲染结果不必在每台终端上装一堆办公软件。先搞清楚哪些文件能直接扔给它选型前先看能力边界。kkFileView 覆盖的主流格式大致分五组办公文档doc/docx、xls/xlsx、ppt/pptx、csv 等同时支持国产 WPS 的wps、dps、et、wpt以及 ODF 系列odt、ods、odp国产化特色格式OFD 版式文档电子发票、公文归档常用、dcm 医疗影像工程文件dwg/dxf 等 CAD 模型、obj/3ds/stl 等 3D 模型、bpmn/drawio/xmind 流程图文本与代码txt、md、xml、json 及各类源码按语法高亮渲染多媒体与压缩包jpg/png 等图片、mp4/mp3 等音视频、zip/rar/7z压缩包可逐层点开看里面的文件对你来说最实际的一句话OA、邮件、网盘里那些点不开的附件绝大多数丢给它都能出画面。具体支持列表见 README.cn.md 开头的 23 条说明。最短上手路径两条命令跑起来依赖很少JDK 21、一个可转换 Office 的 LibreOfficeWindows 版已内置在仓库的server/LibreOfficePortableLinux 启动脚本会自动安装Redis 可选不装。方式一本地直接运行验证功能用git clone https://gitcode.com/GitHub_Trending/kk/kkFileView克隆后运行 server/src/main/java/cn/keking/ServerMain.java 的 main 方法访问http://localhost:8012/即看到首页把文件传上去或拼 URL 就能预览。方式二Docker 容器部署正式环境推荐项目根目录的 Dockerfile 基于keking/kkfileview-base:5.0.0基础镜像构建基础镜像在 docker/kkfileview-base/ 下基于 Ubuntu 24.04内置 OpenJDK 21、LibreOffice 和一批中文字体文泉驿、mscorefonts这一步对国产化环境很关键——中文文档转 PDF 时不会因为缺字体变成□□□。两个细节仓库同时支持linux/amd64 和 linux/arm64两种架构镜像构建方法在 docker/kkfileview-base/README.md在 arm64 机器上如国产飞腾、鲲鹏服务器直接构建即可5.0.0 起强制要求JDK 21老环境升级前先看这个国产化环境重点配置清单所有配置集中在 server/src/main/config/application.properties支持通过环境变量覆盖如KK_TRUST_HOST、KK_FILE_DIR容器化部署时不用改文件。按优先级给你排了序1. 信任主机白名单不配就白搭4.4.0 之后版本默认拒绝所有外部文件预览请求以防 SSRF 攻击。你的文件服务器/对象存储域名要写进trust.host例如trust.host your-cdn.com,10.20.30.*支持通配符和 CIDR。不配置时只有本机测试可用具体规则见 SECURITY_CONFIG.md。2. Office 预览模式office.preview.type5.0.0 默认改为pdf模式整个文档转 PDF 再渲染内网访问体验流畅且保留书签批注如果常见的是几百页大 Word、前端加载吃力可以切回image模式逐页转图片。Excel 则默认走office.type.webweb的前端 SheetJS 解析服务器压力小不需要转换。3. 缓存策略cache.type单机部署用默认的jdk进程内 Map即可集群或多实例部署切到redis支持单机/集群/哨兵/主从四种模式。缓存默认每天凌晨 3 点自动清理磁盘产物磁盘紧张可调整cache.clean.cron。4. 转换并发与超时PDF、CAD、TIF、视频各自有独立线程数和超时pdf.max.threads、cad.thread、media.convert.disable等。PDF 还内置了智能 DPI 分级50 页以下 150 DPI200 页以上自动降到 72 DPI大文件转换不会把 CPU 打满。视频转码默认是关的media.convert.disable默认 false 但转码极耗资源小内存机器建议显式关闭。5. 水印与访问控制office.watermark打开后 Office 转换会带水印水印文案、颜色、透明度、角度都有独立配置项适合对文档留痕有要求的单位。对外暴露时建议叠加kk.keyAPI 密钥或 Basic 认证并保留默认的prohibit exe,dll,dat危险类型拦截。部署运维注意事项字体问题Linux 下预览中文 WPS/OFD 若出现乱码或空白先查容器内中文字体是否齐全基础镜像已内置自建镜像时参考 docker/kkfileview-base/Dockerfile 的字体安装段路径与权限file.dir指定预览产物目录local.preview.dir指定允许预览的本地目录默认禁止安全考虑确保应用账号有读写权限反向代理用 Nginx 前置时记得设置base.url否则生成的预览地址会指向内网 IP资源预估Office 转换依赖 LibreOffice 进程池office.plugin.server.ports 2001,2002多端口可做负载均衡高峰期可按maxtasksperprocess控制单进程任务数防内存溢出完整的线上自动部署流程拉码、Maven 打包、健康检查、失败回滚可参考 doc/ci-auto-deploy.md 的思路小结与下一步kkFileView 的核心价值就三点23 类格式含 WPS、OFD 等国产化格式统一转网页预览、REST 接口跨语言接入简单、Docker 双架构镜像适配国产服务器。上手路径是——克隆仓库、跑ServerMain或docker build起容器、配好trust.host三条之内。下一步建议先用 5.0.0 的 Docker 镜像在测试机验证你要预览的实际业务文件尤其是 OFD 和 CAD确认效果后再按上文清单调线程数、缓存和安全白名单最后接入你的业务系统预览 URL 形如/onlinePreview?url文件地址。【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 kkFileView国产化环境实战：23类文件格式在线预览的搭建与调优完整指南
kkFileView国产化环境实战23类文件格式在线预览的搭建与调优完整指南【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView国产化办公环境里有个高频场景同事发来一份.wps合同、一个.ofd发票包你的浏览器打不开机器上又没装 WPS。传统做法是把文件下载下来、装好对应软件、再人工核对一来一回半天过去了。kkFileView 是一个基于 Spring Boot 的文件在线预览服务把 Office 文档、WPS 国产办公文档、OFD、CAD、3D 模型、压缩包、音视频等 23 类格式统一转成网页可直接浏览的形式。你只需要把文件地址拼进预览 URL就能在浏览器里看到渲染结果不必在每台终端上装一堆办公软件。先搞清楚哪些文件能直接扔给它选型前先看能力边界。kkFileView 覆盖的主流格式大致分五组办公文档doc/docx、xls/xlsx、ppt/pptx、csv 等同时支持国产 WPS 的wps、dps、et、wpt以及 ODF 系列odt、ods、odp国产化特色格式OFD 版式文档电子发票、公文归档常用、dcm 医疗影像工程文件dwg/dxf 等 CAD 模型、obj/3ds/stl 等 3D 模型、bpmn/drawio/xmind 流程图文本与代码txt、md、xml、json 及各类源码按语法高亮渲染多媒体与压缩包jpg/png 等图片、mp4/mp3 等音视频、zip/rar/7z压缩包可逐层点开看里面的文件对你来说最实际的一句话OA、邮件、网盘里那些点不开的附件绝大多数丢给它都能出画面。具体支持列表见 README.cn.md 开头的 23 条说明。最短上手路径两条命令跑起来依赖很少JDK 21、一个可转换 Office 的 LibreOfficeWindows 版已内置在仓库的server/LibreOfficePortableLinux 启动脚本会自动安装Redis 可选不装。方式一本地直接运行验证功能用git clone https://gitcode.com/GitHub_Trending/kk/kkFileView克隆后运行 server/src/main/java/cn/keking/ServerMain.java 的 main 方法访问http://localhost:8012/即看到首页把文件传上去或拼 URL 就能预览。方式二Docker 容器部署正式环境推荐项目根目录的 Dockerfile 基于keking/kkfileview-base:5.0.0基础镜像构建基础镜像在 docker/kkfileview-base/ 下基于 Ubuntu 24.04内置 OpenJDK 21、LibreOffice 和一批中文字体文泉驿、mscorefonts这一步对国产化环境很关键——中文文档转 PDF 时不会因为缺字体变成□□□。两个细节仓库同时支持linux/amd64 和 linux/arm64两种架构镜像构建方法在 docker/kkfileview-base/README.md在 arm64 机器上如国产飞腾、鲲鹏服务器直接构建即可5.0.0 起强制要求JDK 21老环境升级前先看这个国产化环境重点配置清单所有配置集中在 server/src/main/config/application.properties支持通过环境变量覆盖如KK_TRUST_HOST、KK_FILE_DIR容器化部署时不用改文件。按优先级给你排了序1. 信任主机白名单不配就白搭4.4.0 之后版本默认拒绝所有外部文件预览请求以防 SSRF 攻击。你的文件服务器/对象存储域名要写进trust.host例如trust.host your-cdn.com,10.20.30.*支持通配符和 CIDR。不配置时只有本机测试可用具体规则见 SECURITY_CONFIG.md。2. Office 预览模式office.preview.type5.0.0 默认改为pdf模式整个文档转 PDF 再渲染内网访问体验流畅且保留书签批注如果常见的是几百页大 Word、前端加载吃力可以切回image模式逐页转图片。Excel 则默认走office.type.webweb的前端 SheetJS 解析服务器压力小不需要转换。3. 缓存策略cache.type单机部署用默认的jdk进程内 Map即可集群或多实例部署切到redis支持单机/集群/哨兵/主从四种模式。缓存默认每天凌晨 3 点自动清理磁盘产物磁盘紧张可调整cache.clean.cron。4. 转换并发与超时PDF、CAD、TIF、视频各自有独立线程数和超时pdf.max.threads、cad.thread、media.convert.disable等。PDF 还内置了智能 DPI 分级50 页以下 150 DPI200 页以上自动降到 72 DPI大文件转换不会把 CPU 打满。视频转码默认是关的media.convert.disable默认 false 但转码极耗资源小内存机器建议显式关闭。5. 水印与访问控制office.watermark打开后 Office 转换会带水印水印文案、颜色、透明度、角度都有独立配置项适合对文档留痕有要求的单位。对外暴露时建议叠加kk.keyAPI 密钥或 Basic 认证并保留默认的prohibit exe,dll,dat危险类型拦截。部署运维注意事项字体问题Linux 下预览中文 WPS/OFD 若出现乱码或空白先查容器内中文字体是否齐全基础镜像已内置自建镜像时参考 docker/kkfileview-base/Dockerfile 的字体安装段路径与权限file.dir指定预览产物目录local.preview.dir指定允许预览的本地目录默认禁止安全考虑确保应用账号有读写权限反向代理用 Nginx 前置时记得设置base.url否则生成的预览地址会指向内网 IP资源预估Office 转换依赖 LibreOffice 进程池office.plugin.server.ports 2001,2002多端口可做负载均衡高峰期可按maxtasksperprocess控制单进程任务数防内存溢出完整的线上自动部署流程拉码、Maven 打包、健康检查、失败回滚可参考 doc/ci-auto-deploy.md 的思路小结与下一步kkFileView 的核心价值就三点23 类格式含 WPS、OFD 等国产化格式统一转网页预览、REST 接口跨语言接入简单、Docker 双架构镜像适配国产服务器。上手路径是——克隆仓库、跑ServerMain或docker build起容器、配好trust.host三条之内。下一步建议先用 5.0.0 的 Docker 镜像在测试机验证你要预览的实际业务文件尤其是 OFD 和 CAD确认效果后再按上文清单调线程数、缓存和安全白名单最后接入你的业务系统预览 URL 形如/onlinePreview?url文件地址。【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考