kkFileView安装及使用——文件预览解决方案
目录
- 一、前言
- 二、kkFileView介绍
- 三、kkFileView安装
- 四、kkFileView的配置和使用
一、前言
网页端一般会遇到各种文件,比如:txt、doc、docx、pdf、xml、xls、xlsx、ppt、pptx、zip、png、jpg等等。
有时候我们不想要把文件下载下来,而是想在线打开文件预览 ,这个时候如果每一种格式都需要我们去写代码造轮子去实现预览功能就太复杂了,并且自己实现的话会有很多兼容性问题。
这个时候 kkFileView 的出现就解决了我们的问题。
二、kkFileView介绍
kkFileView 为文件文档在线预览解决方案,该项目使用流行的spring boot搭建,易上手和部署,基本支持主流办公文档的在线预览,如doc,docx,xls,xlsx,ppt,pptx,pdf,txt,zip,rar,图片,视频,音频等等
kkFileView 官网
kkFileView 码云地址官网
kkFileView github地址官网
三、kkFileView安装
自 v4.1.0 版本开始 kkFileView 不再免费提供 Windows 和 Linux 的发行安装包了,以前旧版本的安装包也取消了下载入口,要下载安装包还要花99块钱进那个KK开源社区群获取。不过我之前下载过 v4.0.0 版,也够用了,为了方便大家我已经上传百度云了,你可以通过下面文章中的链接进行下载,本文的安装使用教程也是基于 v4.0.0 版本进行操作 。
部署指南参考kkFileView - 在线文件预览 下面介绍Windows、Linux、docker三种安装方式。
1.下载Windows或Linux的 v4.0.0 安装包 :
1.1 windows安装包下载 (链接:https://pan.baidu.com/s/1hZCP5jcD5cKd-xCsMHfYxg 提取码:7uwd)
1.2 linux安装包下载 (链接:https://pan.baidu.com/s/1grhyoIQ_Tr2NHyCZPFYDWg 提取码:13hj)
2.Windows上安装:
2.1 下载的 zip 压缩包解压后进入 bin 目录,双击 startup.bat 启动 kkFileView
2.2 30秒后进入 log 目录查看 kkFileView.log 日志,打印【kkFileView 服务启动完成,耗时:26.8350973s,演示页请访问: http://127.0.0.1:8012 】则说明启动成功。
3.Linux上安装(centos为例):
3.1 root用户下将 kkFileView-4.0.0.tar.gz 上传到服务器 ,使用命令 tar -zxvf kkFileView-4.0.0.tar.gz 解压,开放 8012 端口。
3.2 root用户下解压后进入 kkFileView-4.0.0/bin 目录,执行 ./startup.sh 开始安装和启动,安装过程中会下载需要的组件需要输入y
3.3 安装字体。若不安装字体转化出的pdf文件可能会因为缺少字体乱码。
字体下载(链接:http://kkfileview.keking.cn/fonts.zip)
或者 百度云下载(链接:https://pan.baidu.com/s/1VMGERMHAI7W_Ys-MZC_YTQ 提取码:p6hq)将下载的字体fonts.zip上传到 /usr/share/fonts 目录解压后执行命令 mkfontscale
若 mkfontscale 提示没有命令则先 yum install mkfontscale 安装命令
再分别依次执行 mkfontscale、mkfontdir、fc-cache 命令。3.4 安装完成后 kkFileView-4.0.0/bin/ 目录下使用命令 ./showlog.sh 查看日志
如果出现: 【kkFileView 服务启动完成,耗时:5.99157928s,演示页请访问: http://127.0.0.1:8012 】,则表示安装启动成功。3.5 如果日志提示报错信息【找不到office组件,请确认’office.home’配置是否有误 】,则需要下载LibreOffice组件安装。
LibreOffice下载 (链接:https://downloadarchive.documentfoundation.org/libreoffice/old/7.1.4.2/rpm/x86_64/)
或者
百度云下载(链接:https://pan.baidu.com/s/18tLufbFQCOm11R7-U2f0-Q 提取码:0npj)
将 LibreOffice_7.1.4.2_Linux_x86-64_rpm.tar.gz 上传服务器,然后解压后进入RPMS目录执行 yum localinstall *.rpm 进行安装。3.6 如果日志提示报错信息【Caused by: java.lang.IllegalStateException: a process with acceptString ‘socket,host=127.0.0.1,port=2001’ is already running】
(1)用 ps -ef|grep java 命令查询出Java相关运行的进程,然后关闭kkFileView相关的进程,
并查看2001和2002端口的进程并关闭该进程。然后再执行 ./startup.sh 启动并查看日志。(2)如果是安装在Linux上并且关闭了kkFileView相关的进程以及2001和2002端口,启动日志任
然存在该问题,那么可能是你远程连接服务器的软件导致的这个问题,改用window的cmd,
用ssh连接服务器启动程序尝试。3.7 如果日志提示报错信息【Caused by: org.artofsolving.jodconverter.office.OfficeException: could not establish connection】,可参考 centos下启动失败:启动office组件失败,请检查office组件是否可用
4.通过docker安装:
4.1 拉取镜像: docker pull keking/kkfileview
4.2 运行: docker run -dit -p 8012:8012 keking/kkfileview
4.3 进入运行起来的容器中,然后可以进入 /opt/kkFileView-4.1.0-SNAPSHOT/bin 安装目录,
运行命令 ./showlog.sh 查看日志
四、kkFileView的配置和使用
1.修改启动脚本
测试发现如果 kkfileview 安装在 Windows 上预览 txt 文件会乱码,所以需要修改 kkfileview 的 bin 目录下的 startup.bat 脚本。
在最后一行的 java 后添加 -Dfile.encoding=UTF-8
修改后如下:
@echo off
set "KKFILEVIEW_BIN_FOLDER=%cd%"
cd "%KKFILEVIEW_BIN_FOLDER%"
echo Using KKFILEVIEW_BIN_FOLDER %KKFILEVIEW_BIN_FOLDER%
echo Starting kkFileView...
echo Please check log file in ../log/kkFileView.log for more information
echo You can get help in our official homesite: https://kkFileView.keking.cn
echo If this project is helpful to you, please star it on https://gitee.com/kekingcn/file-online-preview/stargazers
java -Dfile.encoding=UTF-8 -Dspring.config.location=..\config\application.properties -jar kkFileView-4.0.0.jar -> ..\log\kkFileView.log
2.关闭演示页面
kkFileView安装启动成功后可以打开 http://安装的ip:8012 (或者本机 http://127.0.0.1:8012) 查看演示页面上传文件以及查看预览效果。
如果项目上线后为了安全要关闭演示页面,可以在修改kkFileView安装目录的config文件夹中的 application.properties配置文件,将file.upload.disable设置为false禁用演示首页文件上传。
其他配置可根据 官网配置说明 进行配置。
2.kkFileView的使用
参照官网使用说明:使用说明
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/js-base64@3.6.0/base64.min.js"></script>var originUrl = 'http://127.0.0.1:8080/filedownload?fileId=1'; //要预览文件的访问地址,该接口返回文件流
var previewUrl = originUrl + '&fullfilename=test.txt'//fullfilename是必须的,有了该参数kkFileView才知道文件名是什么
//kkFileView的onlinePreview接口就会拿着参数去请求http://127.0.0.1:8080/filedownload接口,把文件下载到安装目录的file/demo文件夹下,然后转换后把预览界面展示到浏览器。
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(previewUrl)));
当然,为了文件安全和实效性,你可以在你的接口中加入token或者其他校验参数,满足了才能下载文件。
比如:
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/js-base64@3.6.0/base64.min.js"></script>var originUrl = 'http://127.0.0.1:8080/filedownload?token=sgdfhkkmlk&time=1659006176&fileID=4564sfd&filename=test.xls'; //要预览文件的访问地址,该接口返回文件流
var previewUrl = originUrl + '&fullfilename=test.xls'//fullfilename是必须的,该参数是kkFileView保存的文件名
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(previewUrl)));
注意:
encodeURIComponent(Base64.encode(previewUrl))
这里因为编码问题我踩过坑,所以需要注意下当使用 base64 对 previewUrl 进行编码时,如果采用MIME友好型 base64 加密会导致长度每大于 76 就会加入\r 或者 \n 这样的换行控制符,这样再使用encodeURIComponent进行编码就会产生 %0A 这样的字符,就会导致预览不了。解决办法就是base64编码后去除 \r 和 \n 然后再使用 encodeURIComponent 编码,encodeURIComponent 编码后再去除 %0A
参考:
gitee开源程序kkFileView踩坑及解决方案
kkFileView LibreOffice文件预览
kkfileView 使用问题年终答疑篇
centos下启动失败:启动office组件失败,请检查office组件是否可用
java实现(如:WORD、EXCEL、PPT、ZIP 等)文件在线预览功能
kkFileView安装及使用——文件预览解决方案相关推荐
- springboot搭建文件预览解决方案,支持目前主流格式office文件,txt文件,png,jpg等图片以及压缩文件的在线预览功能
应用场景及实现思路 应用场景:给定一个网址,输入网址后立即显示预览文件. 实现思路: 1.将文件下载到本地,存储到某个指定目录 2.进行文件转换,此处是重点 3.进行文件展示 实现过程 首 ...
- 基于开源项目kkFileView打造文件预览
1.需求 一般管理系统都有文件上传功能,基于此一般会诞生一个需求:用户需要在线预览自己上传的文件.需求很合理,但是没那么好做,原因在于浏览器默认支持图片.pdf等少量格式预览,而实际情况是你并不能要求 ...
- doc文件在线预览 vue_跨平台(uniapp)文件在线预览解决方案
一.前言 之前写过一篇文章关于上传目录文件:uni-app系统目录文件上传(非只图片和视频)解决方案,这次来解决文件预览问题. uni-app 是一个使用 Vue.js 开发所有前端应用的框架,开发者 ...
- 推荐一款文件文档在线预览解决方案
真正的大师,永远都怀着一颗学徒的心! 今天给大家推荐一款文件文档在线预览解决方案.同学们,我们在开发的过程中,对于一些管理系统肯定有文档在线预览的需求.对于简单的文档,用谷歌的在线文档可以直接处理.但 ...
- 跨平台(uni-app)文件在线预览解决方案
1024刚过,也祝愿各位码友在今后生活中,身体健康,事事顺心,再无Bug. 一.前言 之前写过一篇文章关于上传目录文件:uni-app系统目录文件上传(非只图片和视频)解决方案,这次来解决文件预览问题 ...
- KKFileView(十一)——文件预览
2021SC@SDUSC 上篇文章提到文件预览工厂以及实现具体文件预览功能的类,这篇报告着重于各个文件预览流程 一.文本文件预览 之前的报告中有提到DownloadUtils工具类,该类通过输入文件描 ...
- 文件预览——一路躺过来的那些坑
因为最近项目比较紧,所以dubbo源码系列是顾不上了. 恰巧这周花了几天在做文件预览这块,两三天的时间下来,有过一些走弯路的经验教训(准确说,全都是弯路),在这里给大家分享下~ 背景 基于产品需求,需 ...
- Java中如何实现文件预览的功能
文件预览方法总结 前言 一.kkfileview 文件在线预览 二.officetohtml纯前端的方式 三.JODConverter 四.Aspose 总结 前言 日常开发中常见的文件格式有pdf, ...
- (开源kkFileView、kkOffice)在线预览word、pdf、ofd、excel、ppt、压缩包、图片等等
(开源kkFileView.kkOffice)在线预览word.pdf.ofd.excel.ppt.压缩包.图片等 前言 此项目为文件文档在线预览项目解决方案,对标业内付费产品有[永中office][ ...
最新文章
- Java面试查漏补缺
- 深入解析Spring MVC与Web Flow
- 免费教材丨第52期:人工智能(复杂问题求解的结构和策略)、人工智能哲学
- Spring Cloud 微服务开发系列整理
- 阻塞队列 java 源码_Java源码解析阻塞队列ArrayBlockingQueue常用方法
- android按钮最底,Android:点击按钮后布局上的动画,最低SDK版本为14
- python qt designer 重定向_Python+PyQt5+QtDesigner+PyUic+PyRcc环境安装与配置
- 为什么移动硬盘的实际容量比标注容量小
- Oracle11g数据库快速安装
- C++ STL中vector的内存机制和性能分析
- MVCC(Multiversion concurrency control)
- 【bzoj2219-数论之神】求解x^a==b(%n)-crt推论-原根-指标-BSGS
- 数字信号处理-02- FPGA常用运算模块-加减法器和乘法器
- 爬取人民邮电出版社书籍信息
- pika在codis中的探索
- 增加表空间数据文件语句
- wow Warlock shushia
- 【接口自动化】3.写接口自动化case要注意的点
- 关于nose的简单用法
- python调用谷歌翻译Googletrans接口