浏览器直接打开 docxdwg 图纸在线看kkFileView 文档在线预览快速上手指南3 步跑通【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView还在为一页 docx 内容让别人装 OfficekkFileView 是一个基于 Spring Boot 的文档在线预览项目服务起好之后docx、dwg 甚至 dcm 医疗影像都能在浏览器里直接渲染出来。本文用 3 步把预览服务跑起来并拆解两个最有价值的预览功能读完即可上手。先看 kkFileView 能干什么支持格式与几个值得知道的默认值kkFileView 干的事一句话把任何 http 文件地址变成浏览器里可预览的网页。单 jar 启动Maven 打包出一个 jarJDK 21 直接跑不依赖数据库20 多种格式大类Office、WPS、PDF/OFD、CAD、3D 模型、dcm 医疗影像、压缩包、音视频都有双模式输出Office 与 CAD 都支持逐页转图片和整份转 PDF两种预览方式REST 接口跨语言接入java、php、python、go 的系统都能生成预览链接默认即安全内置文件源白名单机制未配置的外部请求默认被拒可扩展预览逻辑抽象成接口加新格式不动主框架一个容易忽略的默认值Excelxlsx默认走纯前端解析服务器只把原文件递给浏览器解析在浏览器里完成大表格预览不卡服务端3 步跑通构建并启动 kkFileView 预览服务克隆源码、打包、启动 jar看到控制台输出启动完成日志说明服务已起来# 需要 JDK 21克隆后打包并直接运行 git clone https://gitcode.com/GitHub_Trending/kk/kkFileView cd kkFileView mvn -q -pl server -DskipTests package java -jar server/target/kkFileView-5.0.0.jar浏览器打开http://localhost:8012默认端口 8012改端口用server.port看到首页即代表预览服务就绪。在地址栏拼出预览链接把文件的 http 地址做 Base64 编码放到/onlinePreview的url参数后回车就能看到预览页http://localhost:8012/onlinePreview?url文件http地址的Base64编码结果提醒不配白名单时外部文件源会被拒绝白名单怎么配下面场景演练里走一遍。Office 双模式预览PDF 与图片怎么选5.0.0 起默认是PDF 模式整份文档转成 PDF缩放不失真、可搜索定位页码缩略图侧栏默认打开。想要旧的逐页图片观感或需要用户自己切换模式改 主配置文件 里两个值# Office 预览模式pdf默认或 image逐页转图片 office.preview.type image # 预览页的模式切换按钮默认 true 隐藏false 才显示 office.preview.switch.disabled false选择逻辑PDF 模式保矢量排版适合细节核对与打印代价是大文件转换耗时图片模式每页输出一张 JPG加载轻外网慢线首选清晰度由office.quality1~100默认 80控制【效果】docx、ppt、pdf 变成外观一致的网页缩放、翻页、搜索都能用。 【适用场景】内网和快线选 PDF 模式大文件加外网访问选图片模式。浏览器里看 CAD dwg 图纸工程侧最关心 CADkkFileView 支持 dwg、dxf、dwf、iges 等十余种格式电脑不装制图软件也能看图。关键配置同样在主配置文件里cad.preview.type输出格式默认svg缩放不失真可改pdf便于打印标注cad.timeout转换超时默认 90 秒cad.thread转换线程数默认 5默认引擎是 aspose-cad效果稳但吃服务器性能觉得吃力可换成 cadviewer 转换模块支持 dwg/dxf/dwf。【效果】几百页的装配图在浏览器里直接打开滚轮缩放不装软件。 【适用场景】跨部门图纸评审、存档核查、外包方图纸确认。场景演练让内网文件变得可预览把整条链路走一遍。假设一台 docx 放在公司文件服务器files.yourcompany.comhttp 可访问目标是浏览器直接打开它。配白名单在 application.properties 加trust.host files.yourcompany.com。4.4.0 之后这步不能省——kkFileView 默认拒绝所有未入白名单的文件源防 SSRF 攻击不配就直接不信任的文件源。该项属于动态配置组一般几秒内生效图稳就重启一次。拼链接把 docx 的 http 地址做 Base64 编码挂到/onlinePreview?url上格式见前面的代码块。打开验证浏览器直达预览页Office 默认进 PDF 模式左侧缩略图栏展开翻页、缩放、搜索内容都对得上。整条链路只有两个动作配一行白名单、拼一条链接没有中间环节。常见报错速查三类打不开的预览1. 页面提示不信任的文件源现象预览链接进不去文件本身完好原因没配trust.host4.4.0 起默认拒绝全部外部文件源解法trust.host 你的文件域名多个用逗号隔开支持通配符与 CIDR细节见安全配置说明2. 升级 5.0.0 后 Office 预览没有模式切换按钮现象升级后预览页只有 PDF切换图片模式入口消失原因5.0.0 默认改为 PDF 模式并隐藏切换开关office.preview.switch.disabledtrue解法把它设成false恢复按钮想回到图片优先再加office.preview.typeimage3. CAD 转换超时服务高峰期吃紧现象大图纸等满 90 秒后报转换超时CPU 飙高原因默认 aspose-cad 引擎吃性能大图纸超出默认cad.timeout解法cad.timeout提到 180 观察或换更省资源的 cadviewer 转换模块kkFileView 把文件变在线预览压缩成了一个 Spring Boot 服务克隆、打包、启动第一条预览链接 10 分钟内就能生成。完整格式清单与接入示例见官方详细文档上线前逐项核对一遍安全配置指南。下一篇聊聊 kkFileView 的水印与 PDF 下载、打印禁用怎么配。【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考