文章目录
概述
官方的描述是:kkFileView为文件文档在线预览解决方案,该项目使用流行的spring boot搭建,易上手和部署,基本支持主流办公文档的在线预览,如doc,docx,xls,xlsx,ppt,pptx,pdf,txt,zip,rar,图片,视频,音频等等
官方文档链接:https://kkview.cn/zh-cn/docs/home.html
为啥要自己进行源码编译
因为从4.0开始,官方就不再提供发行版(就是编译后的,可以直接安装使用的版本)下载,只提供源码。想要发行版就需要加入社群,当然是有偿入群。
当然,开源不易,应该支持这种有偿服务。所以不差钱的人可以不用往下看了,本文主要讲解的是想通过源码自己编译获取发行版的小伙伴。
我不懂Java代码,可以编译吗
可以的,本文介绍的方法,不需要进行Java代码层面的修改,简单点说就是不进行二次开发。最最重要 Apache 协议开源,代码 pull 下来想干嘛就干嘛
为什么写这篇教程
- 首先,kkFileView确实非常优秀,集成到项目里,可以解决90%以上的文档解析(工作中能用的的文件类型基本都支持),用户体验非常好。
- 第二,我在研究过程中发现,网上很少详细的教程,多数教程是教大家如何使用IDE进行代码编译,这就需要Java功底了。
- 第三,编译的过程也是学习的过程,涨知识,学技能,自己动动手丰衣足食(省下¥99)。
废话不多说,下面是详细操作教程
安装JDK
- 需要JDK版本 1.8+以上,我的版本是这个
- 安装过程就不啰嗦了,这类教程太多了。
安装Git
- git版本没有严格要求,当然不安装也可以,就需要手动下载源码,然后上传到服务器上了。
- 安装教程也不啰嗦,这类教程也很多。
安装Maven
- 这类教程也很多,我用的3.8版本,能正常编译通过,其他版本没有尝试,简单记录以下。
- 下载maven安装包
shell
wget https://dlcdn.apache.org/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.tar.gz
- Maven 下载后,将 Maven 解压到
/usr/local/maven
- 配置环境变量
shell
vim /etc/profile
以下是内容:包括JDK和Maven两块
export JAVA_HOME=/usr/local/jdk1.8.0_202
export JRE_HOME=${JAVA_HOME}/jre
export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib:$CLASSPATH
export JAVA_PATH=${JAVA_HOME}/bin:${JRE_HOME}/bin
export PATH=$PATH:${JAVA_PATH}
MAVEN_HOME=/usr/local/maven/apache-maven-3.8.8
export PATH=${MAVEN_HOME}/bin:${PATH}
- 查看maven安装是否正常
编译kkFileView源码
- 下载源码
shell
地址:
git clone https://gitee.com/kekingcn/file-online-preview.git
未安装git的自己手动下载,然后上传,后续步骤一样。
码云代码地址:
https://gitee.com/kekingcn/file-online-preview
- 使用maven进行编译
shell
cd file-online-preview/
mvn clean package -DskipTests
然后就是漫长的等待,会自动下载所需的各种依赖,这里要保证你所用的网络要稳定。整个过程根据你机器和网络情况而定,我这里用了40多分钟
- 编译完成后,会提示你编译后的发行版具体目录,有window和Linux2个版本,非常贴心!!!
kkFileView安装和使用
编译后获得安装包,进行解压
解压到磁盘空间大的位置,后期kkfile解析文件都将存储在安装目录下file文件夹下。
tar -zxvf kkFileView-4.4.0.tar.gz
修改配置文件
配置文件修改
重点修改:端口号,和文件存储目录,file.dir:原始文件存放位置;Office.home:在线解析的文件存放位置。
shell
修改配置文件
server.port = ${KK_SERVER_PORT:8808}
执行在线安装,下载依赖
shell
进入bin目录,执行安装脚本
安装命令:
sh install.sh
启动并验证服务
bash
进入bin目录,执行
sh startup.sh
浏览器访问
浏览器访问:IP:8808(配置文件设置的端口)
至此,大功告成!!!