kkFileView踩坑记录

kkFileView

公司项目内需对word、excel、pdf、ppt等文件有预览需求，故引入该项开源技术。
官网: http://kkfileview.keking.cn/zh-cn/index.html

部署

环境要求

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

Docker部署

请提前预装好docker环境

拉取镜像 #
# 网络环境方便访问docker中央仓库
docker pull keking/kkfileview:4.1.0

# 网络环境不方便访问docker中央仓库
wget http://kkfileview.keking.cn/kkFileView-4.1.0-docker.tar
docker load -i kkFileView-4.1.0-docker.tar

运行 #
docker run -it -p 8012:8012 keking/kkfileview:4.1.0
浏览器访问容器8012端口 http://127.0.0.1:8012 即可看到项目演示用首页

查看日志
docker logs -f --tail 容器ID

jar部署

请提前预装好jdk环境

下载地址
https://kkfileview.keking.cn/kkFileView-4.1.0.tar.gz

解压文件
tar -zxvf 文件名

找到bin目录,并运行启动脚本
sh ./startup.sh

查看启动日志
sh ./showlog.sh

成功标志
kkFileView 服务启动完成，耗时:5s，演示页请访问: http://127.0.0.1:8012 

nginx反向代理

如果您的项目里使用了nginx做反向代理，请做以下配置

nginx增加配置

location /preview {
    proxy_pass 192.168.1.233:8012;
}

修改config下配置文件，域名记得修改为自己的

server.context-path = /preview
base.url = https://file.keking.cn/preview

踩坑记录

找不到office组件，请确认’office.home’配置是否有误

进入LibreOffice安装目录 检查安装情况，注意下方版本号

cd /tmp/LibreOffice_7.1.4.2_Linux_x86-64_rpm/RPMS

yum localinstall *.rpm -y

启动office组件失败，请检查office组件是否可用

执行命令 注意检查安装位置及安装版本号

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

该命令的意义在于检查是否有缺失的动态链接库

上图显示缺少libX11-xcb 则执行安装
yum install libX11-xcb

注意请多次反复检查，缺少什么就安装什么，直至动态链接库完备