1. windows环境部署运行
1.1 环境要求
1. Java: 1.8+
2. OpenOffice或LiberOffice(Windows下已内置)无需考虑此条
3. 下载https://gitee.com/link?target=https%3A%2F%2Fkkfileview.keking.cn%2FkkFileView-4.0.0.zip(windows版)
4. 解压 kkFileView-4.0.0.zip ,然后进入到kkFileView-4.0.0/bin/ 目录下,双击 startup.bat 即可启动该应用。浏览器能正常访问:http://localhost:8012 即可表示启动正常。
5. 项目接入使用
如果你的项目需要接入文件预览项目,达到对docx,excel,ppt,jpg等文件的预览效果,那么通过在你的前端项目中加入下面的代码即可成功实现。
var url = 'http://127.0.0.1:8080/file/test.txt'; //要预览文件的访问地址
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent
(Base64.encode(url)));
黄色背景部分为运行的kkFileView的地址
Base64 一定要用,否则文件打不开
2. linux环境部署运行
2.1 环境要求
1. Java: 1.8+
2. OpenOffice或LiberOffice(CentOS或Ubuntu下, 联网了会自动下载安装,MacOS下需要
自行安装),由于我是CentOS系统且是内网,无法自动下载,于是我选择了手动下载安装包并离线安装LiberOffice。
3. 若启动失败office.home报错 ,下载LibreOffice;
2.2 下载并解压 tar -zxvf LibreOffice_7.2.7_Linux_x86-64_rpm.tar.gz;
将LibreOffice_7.2.7_Linux_x86-64_rpm.tar.gz上传到服务器后解压,进入到LibreOffice_7.2.7_Linux_x86-64_rpm/RPMS/目录下,进行LibreOffice的安装:
> cd /LibreOffice_7.2.7_Linux_x86-64_rpm/RPMS/
> yum localinstall *.rpm
安装完成后会出现/opt/libreOffice7.2目录。
修改 office.home配置
/usr/local/apps/kkFileView-4.0.0/config/application.properties;
office.home = /opt/libreoffice7.2
再次启动
2.启动错误
启动后可以去 /kkFileView-4.0.0/log/kkFileView.log查看日志,如果日志报如下错误,可以先将
kkFileView进程 kill掉,然后 kill 掉报错信息里的 2001端口的pid,然后再次重启即可
报错信息:Caused by:.....Error creating bean with name 'officePluginManager': Invocation of init method failed:....failed to start and connect
Caused by:org.artofsolving.jodconverter.office.OfficeException:failed to start and connect
Caused by:....office.OfficeException:could not establish connection
Caused by:.....a process with acceptString 'socket,host=127.0.0.1,port=2001' is already running;pid 299361

若该pid的进程没有,则在远程连接时取消勾选转发X11

再次重启查看日志
浏览器能正常访问:http://服务器ip:8012 表明kkFileView应用运行正常,接下来参照上面的项目接入使用即可
3 乱码问题
将Windows下的C:\Windows\Fonts 目录下的文件完整拷贝到Linux下的 /usr/share/fonts目录。然后依次执行mkfontscale 、mkfontdir 、fc-cache使字体生效。
编码问题的话是个老生常谈的问题。因为其受运行所在主机环境的影响不确定因素比较高,常规做法是,修改配置文件中如下配置,一般都是utf-8或者gbk。还不行,就在启动脚本里设置-Dfile.encoding=UTF-8试试
server.tomcat.uri-encoding = UTF-8
converted.file.charset = GBK
本文详细介绍了如何在Windows和Linux环境下部署kkFileView文件预览应用。在Windows上,只需解压并启动startup.bat。在Linux中,需要安装Java、OpenOffice/LibreOffice,并设置office.home配置。遇到启动问题时,检查日志并解决相关进程冲突。对于乱码问题,可以将Windows字体复制到Linux并更新字体缓存。项目接入时,通过指定url调用kkFileView预览文件。
1294





