开源文档预览项目 kkfileview (9.9k star) ，快速入门 | java 技术论坛-江南app体育官方入口

kkfileview 是一款文件文档在线预览江南app体育官方入口的解决方案，采用流行的 spring boot 框架构建，易于上手和部署。

该项目基本支持主流办公文档的在线预览，包括但不限于 doc、docx、xls、xlsx、ppt、pptx、pdf、txt、zip、rar，以及图片、视频、音频等格式。

• 拉取镜像：

docker pull keking/kkfileview:4.1.0

​

wget

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 即可看到项目演示用江南app体育官方入口首页。

上传一个文件之后，点击预览，即可查看该文件预览效果。

项目内需要预览文件时，只需要调用浏览器打开本项目的预览接口，并传入须要预览文件的 url ，示例如下：

1. 引入 js 文件

1. js 代码

window.open(‘ encodeuricomponent( base64.encode(url) ) );

本节我们介绍如何使用 mac 电脑本地调试 ，以及根据配置按照 windows/linux 打对应的部署包。

从 github 上下载 kkfileview ：

git clone [email protected]:kekingcn/kkfileview.git

kkfileview 强依赖两点：

1. java 1.8

2. libreoffice 或 openoffice ( windows下已内置，centos 或 ubuntu 下会自动下载安装，macos 下需要自行安装)

所以 mac 本地调试需要先安装 libreoffice ，进入 libreoffice 江南app体育官方入口首页，下载对应 mac 版本即可。

当我们通过 idea 打开 ，进入 server 模块，执行 servermain 类 ：

启动日志如下：

从日志我们看到：kkfileview 会启动两个 libreoffice 进程，每个进程有独立的端口。

当我们执行 maven 的 package 命令， 根据配置 windows/linux 打对应的部署包。

我们将打包好的 kkfileview linux 部署包，上传到部署目录，分别执行：

tar -zxvf kkfileview-4.4.0-snapshot.tar.gz

​

cd bin

​

./startup.sh

备注: linux 环境首次启动会自动安装 libreoffice 默认安装 7.5 版本。

我们也可以手工安装 libreoffice。

#将 libreoffice_7.5.3.2_linux_x86-64_rpm.tar.gz上传到 home 目录下

cd /home

tar -zxvf libreoffice_7.5.3.2_linux_x86-64_rpm.tar.gz

cd libreoffice_7.5.3.2_linux_x86-64_rpm/rpms/

yum -y localinstall *.rpm

手工安装完成后，可以通过如下的命令验证是否正确：

libreoffice7.5 –version

启动 kkfileview 并不意味着配置的结束，因为还需要最后一步：安装字体。

1、下载字体

wget

2、上传到 /usr/share/fonts , 并解压缩

unzip fonts.zip

3、刷新字体索引

mkfontscale

mkfontdir

fc-cache

当我们在本地调试或者 linux 服务器执行预览效果时，我们发现 ppt 文档文件会转换成图片的格式，比如下图：

kkfileview 本质是将文档文件转换为特定的展示文件，是一个小型的转码系统。而且转码后的文件存储都是单机模式，假如需要分布式部署，可能还是会有性能瓶颈。

最后，kkfileview 相关安装包，也可以关注勇哥的公众号，回复“kk” , 即可获取 。

如果我的文章对你有所帮助，还请帮忙点赞、在看、转发一下，你的支持会激励我输出更高质量的文章，非常感谢！

本作品采用《cc 协议》，转载必须注明作者和本文链接