此项目为文件文档在线预览项目解决方案,对标业内付费产品有【永中office】【office365】【idocv】等,在取得公司高层同意后以Apache协议开源出来反哺社区,在此特别感谢@唐老大的支持以及@端木详笑的贡献。该项目使用流行的spring boot搭建,易上手和部署,基本支持主流办公文档的在线预览,如doc,docx,Excel,pdf,txt,zip,rar,图片等等
- 支持 office, pdf, cad 等办公文档
- 支持 txt, xml(渲染), md(渲染), java, php, py, js, css 等所有纯文本
- 支持 zip, rar, jar, tar, gzip 等压缩包
- 支持 jpg, jpeg, png, gif, tif, tiff 等图片预览(翻转,缩放,镜像)
- 使用 spring-boot 开发,预览服务搭建部署非常简便
- rest 接口提供服务,跨语言、跨平台特性(java,php,python,go,php,....)都支持,应用接入简单方便
- 抽象预览服务接口,方便二次开发,非常方便添加其他类型文件预览支持
- 最最重要 Apache 协议开源,代码 pull 下来想干嘛就干嘛
地址:https://kkfileview.keking.cn
请善待公共服务,会不定时停用
- 详细wiki文档:https://gitee.com/kekingcn/file-online-preview/wikis/pages
- 中文文档:https://gitee.com/kekingcn/file-online-preview/blob/master/README.md
- English document:https://gitee.com/kekingcn/file-online-preview/blob/master/README.en.md
我们会用心回答解决大家在项目使用中的问题,也请大家在提问前至少 Google 或 baidu 过,珍爱生命远离无效的交流沟通
QQ群号:613025121(已满) 2群:484680571
支持所有类型的文本文档预览, 由于文本文档类型过多,无法全部枚举,默认开启的类型如下 txt,html,htm,asp,jsp,xml,json,properties,md,gitignore,log,java,py,c,cpp,sql,sh,bat,m,bas,prg,cmd
文本预览效果如下
支持jpg,jpeg,png,gif等图片预览(翻转,缩放,镜像),预览效果如下
支持doc,docx文档预览,word预览有两种模式:一种是每页word转为图片预览,另一种是整个word文档转成pdf,再预览pdf。两种模式的适用场景如下
支持ppt,pptx文档预览,和word文档一样,有两种预览模式
图片预览模式预览效果如下
pdf预览模式预览效果如下
支持pdf文档预览,和word文档一样,有两种预览模式
图片预览模式预览效果如下
pdf预览模式预览效果如下
支持zip,rar,jar,tar,gzip等压缩包,预览效果如下
可点击压缩包中的文件名,直接预览文件,预览效果如下
理论上支持所有的视频、音频文件,由于无法枚举所有文件格式,默认开启的类型如下
mp3,wav,mp4,flv
视频预览效果如下
音频预览效果如下
支持CAD dwg文档预览,和word文档一样,有两种预览模式
图片预览模式预览效果如下
pdf预览模式预览效果如下
考虑说明篇幅原因,就不贴其他格式文件的预览效果了,感兴趣的可以参考下面的实例搭建下
项目使用技术
- spring boot: spring boot开发参考指南
- freemarker
- redisson
- jodconverter
依赖外部环境
- redis (可选,默认不用)
- OpenOffice 或者 LibreOffice( Windows 下已内置,Linux 脚本启动模式会自动安装,Mac OS 下需要手动安装)
-
第一步:pull 项目 https://github.com/kekingcn/file-online-preview.git
-
第二步:运行 ServerMain 的 main 方法,服务启动后,访问 http://localhost:8012/ 会看到如下界面,代表服务启动成功
2021年7月6日,v4.0.0 版本发布 :
- 底层集成OpenOffice替换为LibreOffice,Office文件兼容性增强,预览效果提升
- 修复压缩文件目录穿越漏洞
- 修复PPT预览使用PDF模式无效
- 修复PPT图片预览模式前端显示异常
- 新增功能:首页文件上传功能可通过配置实时开启或禁用
- 优化增加Office进程关闭日志
- 优化Windows环境下,查找Office组件逻辑(内置的LibreOffice优先)
- 优化启动Office进程改同步执行
2021年6月17日,v3.6.0 版本发布 :
ofd 类型文件支持版本,本次版本重要功能均由社区开发贡献,感谢 @gaoxingzaq、@zhangxiaoxiao9527 的代码贡献
- 新增 ofd 类型文件预览支持,ofd 是国产的类似 pdf 格式的文件
- 新增了 ffmpeg 视频文件转码预览支持,打开转码功能后,理论上支持所有主流视频的预览,如 rm、rmvb、flv 等
- 美化了 ppt、pptx 类型文件预览效果,比之前版本好看太多
- 更新了 pdfbox、xstream、common-io 等依赖的版本
2021年1月28日 :
2020农历年最后一个版本发布,主要包含了部分 UI 改进,和解决了 QQ 群友、 Issue 里反馈的 Bug 修复,最最重要的是发个新版,过个好年
- 引入galimatias,解决不规范文件名导致文件下载异常
- 更新index接入演示界面UI风格
- 更新markdown文件预览UI风格
- 更新XML文件预览UI风格,调整类文本预览架构,更方便扩展
- 更新simTxT文件预览UI风格
- 调整多图连续预览上下翻图的UI
- 采用apache-common-io包简化所有的文件下载io操作
- XML文件预览支持切换纯文本模式
- 增强url base64解码失败时的提示信息
- 修复导包错误以及图片预览 bug
- 修复发行包运行时找不到日志目录的问题
- 修复压缩包内多图连续预览的bug
- 修复大小写文件类型后缀没通用匹配的问题
- 指定Base64转码采用Apache Commons-code中的实现,修复base64部分jdk版本下出现的异常
- 修复类文本类型HTML文件预览的bug
- 修复:dwg文件预览时无法在jpg和pdf两种类型之间切换
- escaping of dangerous characters to prevent reflected xss
- 修复重复编码导致文档转图片预览失败的问题&编码规范
2020年12月27日 :
2020年年终大版本更新,架构全面设计,代码全面重构,代码质量全面提升,二次开发更便捷,欢迎拉源码品鉴,提issue、pr共同建设
- 架构模块调整,大量的代码重构,代码质量提升N个等级,欢迎品鉴
- 增强XML文件预览效果,新增XML文档数结构预览
- 新增markdown文件预览支持,预览支持md渲染和源文本切换支持
- 切换底层web server为jetty,解决这个issue:kekingcn#168
- 引入cpdetector,解决文件编码识别问题
- url采用base64+urlencode双编码,彻底解决各种奇葩文件名预览问题
- 新增配置项office.preview.switch.disabled,控制offic文件预览切换开关
- 优化文本类型文件预览逻辑,采用Base64传输内容,避免预览时再次请求文件内容
- office预览图片模式禁用图片放大效果,达到图片和pdf预览效果一致的体验
- 直接代码静态设置pdfbox兼容低版本jdk,在IDEA中运行也不会有警告提示
- 移除guava、hutool等非必须的工具包,减少代码体积
- Office组件加载异步化,提速应用启动速度最快到5秒内
- 合理设置预览消费队列的线程数
- 修复压缩包里文件再次预览失败的bug
- 修复图片预览的bug
2020年05月20日 :
- 新增支持全局水印,并支持通过参数动态改变水印内容
- 新增支持CAD文件预览
- 新增base.url配置,支持使用nginx反向代理和使用context-path
- 支持所有配置项支持从环境变量里读取,方便Docker镜像部署和集群中大规模使用
- 支持配置限信任站点(只能预览来自信任点的文件源),保护预览服务不被滥用
- 支持配置自定义缓存清理时间(cron表达式)
- 全部能识别的纯文本直接预览,不用再转跳下载,如.md .java .py等
- 支持配置限制转换后的PDF文件下载
- 优化maven打包配置,解决 .sh 脚本可能出现换行符问题
- 将前端所有CDN依赖放到本地,方便没有外网连接的用户使用
- 首页评论服务由搜狐畅言切换到Gitalk
- 修复url中包含特殊字符可能会引起的预览异常
- 修复转换文件队列addTask异常
- 修复其他已经问题
- 官网建设:https://kkfileview.keking.cn
- 官方Docker镜像仓库建设:https://hub.docker.com/r/keking/kkfileview
2019年06月18日 :
- 支持自动清理缓存及预览文件
- 支持http/https下载流url文件预览
- 支持FTP url文件预览
- 加入Docker构建
2019年04月08日 :
- 缓存及队列实现抽象,提供JDK和REDIS两种实现(REDIS成为可选依赖)
- 打包方式提供zip和tar.gz包,并提供一键启动脚本
2018年01月19日 :
- 大文件入队提前处理
- 新增addTask文件转换入队接口
- 采用redis队列,支持kkFIleView接口和异构系统入队两种方式
2018年01月17日 :
- 优化项目结构,抽象文件预览接口,更方便的加入更多的文件类型预览支持,方便二次开发
- 新增英文文档说明(@幻幻Fate,@汝辉)贡献
- 新增图片预览文件支持类型
- 修复压缩包内轮播图片总是从第一张开始的问题
2018年01月12日 :
- 新增多图片同时预览
- 支持压缩包内图片轮番预览
2018年01月02日 :
- 修复txt等文本编码问题导致预览乱码
- 修复项目模块依赖引入不到的问题
- 新增spring boot profile,支持多环境配置
- 引入pdf.js预览doc等文件,支持doc标题生成pdf预览菜单,支持手机端预览
如果这个项目解决了你的实际问题,可在 https://gitee.com/kekingcn/file-online-preview/issues/IGSBV 登记下,如果节省了你的三方预览服务费用,也愿意支持下的话,可点击下方【捐助】请作者喝杯咖啡,也是非常感谢