kkFileView:基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

kkFileView简介

kkFileView可以用来搭建文件在线预览服务,在Github上已有5.7k+Star。该项目使用流行的SpringBoot搭建,易上手和部署,基本支持主流办公文档的在线预览,如docx、xlsx、pptx、pdf、txt、zip、图片、视频、音频等等。项目特性可以参考下图。

基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

安装

kkFileView支持在Windows和Linux下安装,下面我们介绍下它的安装,基本就是开箱即用!

Windows

  • 首先下载最新版的安装包,下载地址:https://gitee.com/kekingcn/file-online-preview/releases
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 下载成功后,解压到指定目录,然后运行bin目录下的startup.bat命令即可;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 由于是SpringBoot项目,想要修改配置的话,只需修改config目录下的application.properties文件即可。
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

Linux

  • 在Linux下使用Docker安装非常简单,只需两个命令即可,首先下载kkFileView的Docker镜像;
docker pull keking/kkfileview
  • 下载完成后运行kkfileview的Docker容器,服务将运行在8012端口上;
docker run -p 8012:8012 --name kkfileview -d keking/kkfileview
  • 运行成功后,可以访问kkfileview的测试页,地址地址:http://192.168.7.109:8012
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

使用

之前我们使用MinIO搭建了对象存储服务 ,接下来我们就把kkfileview和MinIO结合起来使用,首先将需要在线预览的文件存储到MinIO中去,然后预览文件。

  • 我们可以使用S3 Browser来管理MinIO中的文件,首先创建一个存储桶为preview,然后将文件都上传上去;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 上传成功后需要修改存储桶的访问策略,让匿名用户可以访问;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 修改策略时直接参考Policy Examples即可,注意修改下version为2012-10-17;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 修改成功后就可以在线预览文件了,我们来看下在线预览文件的URL格式,只需传入url(需要预览的文件地址)即可,这里要注意的是这个url需要进行base64编码才可以;
http://192.168.7.109:8012/onlinePreview?url=base64Encode($url)
  • 接下来我们来预览个图片试试,首先获取图片的访问地址;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 然后找个网站把url进行base64编码,我使用的是这个:https://tool.oschina.net/encrypt?type=3
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 接下来把url参数放入访问路径中即可预览图片了,是不是很简单!
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 再来预览下word文档,我们可以发现右侧有个JPG的按钮,可以切换到JPG视图,其实kkfileview是通过把word文档转换为pdf或者JPG来实现文档预览的;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 再来预览下ppt文档,发现ppt文档也是通过转化为pdf和JPG来实现预览的;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 再来预览下pdf文档,和上面两个并没有啥区别;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 再来预览下excel文档,这预览效果有待提高;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 再来预览下纯文本的Markdown文档;
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

  • 最后再来预览下压缩文件,支持查看压缩文件中的内容,点击文件可直接预览。
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

配置

kkfileview的配置众多,具体直接参考config目录下的application.properties文件即可,这里介绍下如何自定义Docker容器中的配置。

  • 如果你想修改kkfileview的配置文件的话,可以先从Docker容器中拷贝出配置文件目录;
docker cp kkfileview:/opt/kkFileView-3.5.1/config /mydata/kkFileView/
  • 然后将配置目录、文件目录、日志目录挂载到宿主机并运行;
docker run -p 8012:8012 --name kkfileview 
-v /mydata/kkFileView/config:/opt/kkFileView-3.5.1/config 
-v /mydata/kkFileView/file:/opt/kkFileView-3.5.1/file 
-v /mydata/kkFileView/log:/opt/kkFileView-3.5.1/log 
-d keking/kkfileview
  • 如果我们想要给预览文件添加水印的话,可以修改application.properties文件中的如下配置,比如我想添加macrozheng这个水印;
#水印内容
#如需取消水印,内容设置为空即可,例:watermark.txt = ${WATERMARK_TXT:}
watermark.txt = ${WATERMARK_TXT:macrozheng}
  • 修改成功后,再次预览图片就会发现水印已经添加了。
基于SpringBoot的文件在线预览神器,支持99%的文件在线预览

总结

通过对kkFileView的一波实践,我们发现kkFileView可以满足Office文档、视频、图片等主流文件的在线预览需求,使用和配置也非常简单。由于它是通过将word、ppt文档转化为pdf来实现预览的,如果你对Office文档预览没有特别高的要求,完全可以使用它搭建一个全能的文件在线预览服务!

内容出处:,

声明:本网站所收集的部分公开资料来源于互联网,转载的目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。如果您发现网站上有侵犯您的知识产权的作品,请与我们取得联系,我们会及时修改或删除。文章链接:http://www.yixao.net/share/27281.html

发表评论

登录后才能评论