linux系统kkFileView安装及使用个人使用问题记录

原创于 2025-12-26 14:52:40 发布 · 361 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#linux #运维 #服务器

参考笔记：kkFileView安装及使用——文件预览解决方案-优快云博客

使用笔记中的v4.0.0版本，作者写的挺详细的，基本上按照这个流程安装下来成功了。

注意的点有：

1、一定要安装字体，缺少字体会导致pdf乱码，笔记中也有介绍怎么安装字体

2、启动kkFileView时，报的错误【找不到office组件，请确认’office.home’配置是否有误】，需要手动安装LibreOffice ，用的作者百度云连接。下载完成后，将 LibreOffice_7.1.4.2_Linux_x86-64_rpm.tar.gz 上传服务器，然后解压后进入RPMS目录执行 yum localinstall *.rpm 进行安装。

安装完成后，如果还是报错【找不到office组件，请确认’office.home’配置是否有误】，检查Libreoffice 安装是否完善，执行下面的命令，注意检查安装位置及安装版本号：

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

安装正确的话，会返回pid

我是缺少了一个组件，查看命令的输出，缺少什么安装什么，直到返回pid为止。LibreOffice安装成功后，在重新启动kkFileView，去日志里查看，如果日志输出：kkFileView 服务启动完成，耗时:5.429080719s，演示页请访问: http://127.0.0.1:8012，说明启动成功了

3、因为我的项目使用了nginx反向代理，还需要修改配置，否则预览的图片会报错，找不到文件，因为图片地址是127.0.0.1

我的nginx配置：
location /filePreview/ {
     # 过滤index路径,index为kkFileView的首页
     if ($request_uri ~* "/index") {
         return 404;
     }
     proxy_pass http://127.0.0.1:8012/;
}

--------------------------------------------------------------
kkFileView配置：进入config文件夹，vim application.properties

#提供预览服务的地址，默认从请求url读，如果使用nginx等反向代理，需要手动设置
#base.url = https://file.keking.cn
base.url = 将这里修改为你的域名