不用下载到本地：kkFileView 文件在线预览服务搭建指南
【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView
收到文件想先扫一眼内容，你是不是习惯先下载下来，打开对应软件，看完再关掉？上周客户发来一份两百页的 Word，让我"先看看表格齐不齐"，下载、打开、翻完，十分钟就过去了。为了解决这事我接触了 kkFileView，一个基于 Spring-Boot 的开源文件在线预览项目，把一个文件的 URL 交给它的接口，返回的就是浏览器里能直接看的页面，Word、Excel、PDF、图片都支持。
它底层怎么干活的
它不是自己解析文件格式，而是调用装在服务器上的 LibreOffice（OpenOffice）转换引擎，把 Office 文档转成 PDF（5.0 版默认预览模式）或图片，再交给浏览器展示。图片、音视频这类走浏览器原生能力，文本文件直接读取渲染。一句话：服务端做转换，浏览器做展示，客户端什么都不用装。
最简部署命令，两步跑起来
有 Docker 的话两条命令就够：
docker pull keking/kkfileview:5.0.0 docker run -p 8012:8012 keking/kkfileview:5.0.0容器起来后，浏览器打开 http://localhost:8012/ 就能看到预览首页，直接粘贴一个网络文件地址就能试。想接到自己的系统里，只要把url参数指向文件地址，拼出预览链接就行。坚持用源码构建的话，clone 仓库后在 server 目录执行mvn clean package，注意 5.0 版要求 JDK 21，本机还是老 JDK 的话直接用镜像省事。
支持哪些格式预览
50 多种格式就不逐一列举了，挑常用的说。Office 文档是大头：doc/docx、xls/xlsx、ppt，WPS 的 wps、et、dps 都能直接开；PDF、OFD、RTF 也支持。图片（jpg、png、webp、heic）、txt/md/JSON 这类文本，zip/rar/tar 压缩包也都能在浏览器里看——zip 里套的文件不解压就能点进去翻。做工程、图纸的同学，dwg/dxf/stl 这类 CAD 和 3D 模型、mp4/mp3 音视频也在支持列表里。完整的格式清单可以看仓库里的 README.cn.md，对得上就用。
适合放进哪些场景
给甲方审合同 📄：把扫描版合同 PDF 放到内部文件服务器，预览链接指过去，法务在浏览器里翻页就行，没装 Office 的笔记本也没关系。
团队共享盘：业务同事点文档链接直接出预览页，不用先把两百兆的 pptx 下载到本地再打开。
电商或内容站：下载页加个"预览"按钮，转换都在服务端完成，不受用户设备环境影响。
上手前值得知道的几件事
内存方面，LibreOffice 转换跑在服务内部，部署机器至少留 2GB 内存，常转大文件的话再往上加，不然转换卡住甚至 OOM。首次预览会慢一些：转换服务第一次启动要预热，第一个 doc 转起来可能几秒到十几秒，同一文件后面再转就命中缓存，快很多。不是每种格式都转得好：复杂 Word 的表格、图表转完可能有点错位，3D、CAD 这类属于"能看个大概"，要精确还得用专业软件开。要调整行为的话，水印、转换超时这些开关都在 application.properties 里，多数支持环境变量覆盖，不用改代码。
【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
