# 一、前言
网页端一般会遇到各种文件，比如：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 - 在线文件预览](https://kkfileview.keking.cn/zh-cn/index.html)
kkFileView 码云地址官网 : [kkFileView - 在线文件预览](https://kkfileview.keking.cn/zh-cn/index.html)
kkFileView github地址官网 : [GitHub - kekingcn/kkFileView: 基于 Spring Boot 的文件在线预览项目](https://github.com/kekingcn/kkFileView)
# 三、kkFileView安装
自 v4.1.0 版本开始 kkFileView 不再免费提供 Windows 和 Linux 的发行安装包了，你可以通过下面文章中的百度云链接进行下载 v4.0.0 版本，本文的安装使用教程也是基于 v4.0.0 版本进行操作 。
部署指南参考 下面介绍Windows、Linux、docker三种安装方式
## 1.windows或linux安装包下载
**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](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](http://kkfileview.keking.cn/fonts.zip)
将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](http://127.0.0.1:8012) 】
则表示安装启动成功
**3.5** 如果日志提示报错信息【找不到office组件，请确认'office.home'配置是否有误 】，
则需要下载LibreOffice组件安装，下载地址 ：[libreoffice_7.1.4.2_x86_64](https://downloadarchive.documentfoundation.org/libreoffice/old/7.1.4.2/rpm/x86_64/)
将 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连接服务器启动程序尝试。
## 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 安装在 Windows 上需要修改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) （或者本机 [http://127.0.0.1:8012](http://127.0.0.1:8012)） 查看演示页面上传文件以及查看预览效果。
如果项目上线后为了安全要关闭演示页面，可以在修改kkFileView安装目录的config文件夹中的
application.properties配置文件，将file.upload.disable设置为false禁用演示首页文件上传。
其他配置可根据官网 [https://kkfileview.keking.cn/zh-cn/docs/config.html](https://kkfileview.keking.cn/zh-cn/docs/config.html) 说明进行配置。
## 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才知道文件名是什么
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(previewUrl)));
```
kkFileView的onlinePreview接口就会拿着参数去请求 [http://127.0.0.1:8080/filedownload](http://127.0.0.1:8080/filedownload) 接口，把文件下载到安装目录的file/demo文件夹下，然后转换后把预览界面展示到浏览器。
当然，为了文件安全和实效性，你可以在你的接口中加入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)));
```
**参考：**
[gitee开源程序kkFileView踩坑及解决方案](https://blog.csdn.net/u010682330/article/details/122065416)
[kkFileView LibreOffice文件预览](https://blog.csdn.net/m0_51363655/article/details/125495711)
[kkfileView 使用问题年终答疑篇 ](https://blog.csdn.net/m0_51363655/article/details/125495711)
[java实现文件在线预览功能](https://blog.csdn.net/m0_37951794/article/details/126606939)
[centos下启动失败：启动office组件失败，请检查office组件是否可用 ](https://gitee.com/kekingcn/file-online-preview/issues/I40C4G#note_9774842)
