当前位置：首页 > news >正文

kkFileView安装及使用

news 来源：原创 2025/4/22 12:59:23

1.前言

文件类型很多,常见的就有txt、doc、docx、pdf、xml、xls、xlsx、ppt、pptx、zip、png、jpg等等,而且涉及到文件一般都会有在线预览功能,这个时候如果每一种格式都需要我们去写代码实现预览功能就太复杂了，并且自己实现的话会有很多兼容性问题,kkFileView就可以解决这个问题.

2.优点

kkFileView 为文件文档在线预览解决方案，该项目使用流行的spring boot搭建，易上手和部署，基本支持主流办公文档的在线预览，如doc,docx,xls,xlsx,ppt,pptx,pdf,txt,zip,rar,图片,视频,音频等等

3.官网

kkFileView 官网https://link.csdn.net/?target=https%3A%2F%2Fkkfileview.keking.cn%2Fzh-cn%2Findex.html
kkFileView 码云地址官网https://link.csdn.net/?target=https%3A%2F%2Fgitee.com%2Fkekingcn%2Ffile-online-preview
kkFileView github地址官网https://link.csdn.net/?target=https%3A%2F%2Fgithub.com%2Fkekingcn%2FkkFileView

4.安装

需要注意的是v4.1.0 版本开始 kkFileView 不再免费提供 Windows 和 Linux 的发行安装包了，以前旧版本的安装包也取消了下载入口，要下载安装包需要自己通过源码编译打包

一般v4.0.0也完全够用了.

说明:需要的环境

1.Java: 1.8+
2.LibreOffice或OpenOffice(Windows下已内置，CentOS或Ubuntu下会自动下载安装，MacOS下需要自行安装)

1.windows安装

1.启动

下载的 zip 压缩包解压后进入 bin 目录，双击 startup.bat 启动 kkFileView

2.验证

进入 log 目录查看 kkFileView.log 日志，打印【kkFileView 服务启动完成，耗时:26.50923173s，演示页请访问: http://127.0.0.1:8012 】则说明启动成功。

2.linux安装

1.解压

tar -zxvf kkFileView-4.0.0.tar.gz

2.启动

./startup.sh
会自己安装LibreOffice 组件

5.配置

1.kkFileView配置文件修改

需要修改的地方

1.server.context-path= /kkFileView

2.base.url = http://192.168.11.197:38004/kkFileView

这里就是nginx访问的路径

2.nginx代理

        location ^~/kkFileView/ {proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_pass http://127.0.0.1:8012/;}

6.可能遇到的问题

1.找不到office组件

原因 4.0版本linux依赖LibreOffice，需先下载（需要对应）LibreOffice_7.1.4.2_Linux_x86-64_rpm.tar.gz，,版本很重要

#解压
tar -zxvf LibreOffice_7.1.4.2_Linux_x86-64_rpm.tar.gz
#安装
cd LibreOffice_7.1.4.2_Linux_x86-64_rpm/RPMS
yum install *.rpm

2.安装LibreOffice后依旧报错

检查Libreoffice 安装是否完善,默认会安装在 /opt路径下

/opt/libreoffice7.1/program/soffice --headless --accept="socket,host=127.0.0.1,port=2001;urp;" --nofirststartwizard &

执行以上的命令查看office是否还缺少别的组件，缺什么就安装什么，安装完在运行，直到不缺了为止。

原因：无论是脚本还是手动安装的office组件都有可能不全。

dnf install xxx(缺少的组件名称)

缺少libcairo.so.2 运行 yum install gd

3.排查office组件是否已经启动

这里一点要注意,要把kk和office进程都杀掉

ps -ef | grep kk
ps -ef | grep office

4.乱码

主要是字体问题,
在centos上，使用如下命令进行安装：

yum install -y fontconfig mkfontscale

如果执行该命令有报错提示已存在安装包先，卸载掉再重新执行以上命令，卸载命令如下

yum erase xxxxxxxx(提示已存在的报名) -y

fc-list :lang=zh查看安装的中文字体

大部分Linux系统上并没有预装中文字体或字体不全，需要把常用字体拷贝到Linux服务器上，具体操作如下：
将Windows下的C:\Windows\Fonts 目录下的文件完整拷贝到Linux下的 /usr/share/fonts目录。然后依次执行mkfontscale 、mkfontdir 、fc-cache使字体生效