简介

官网地址：kkfileview.keking.cn/zh-cn/index…

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

开源地址：gitee.com/kekingcn/fi…

特性：

支持word excel ppt，pdf等办公文档
支持txt,java,php,py,md,js,css等所有纯文本
支持zip,rar,jar,tar,gzip等压缩包
支持jpg，jpeg，png，gif等图片预览（翻转，缩放，镜像）
支持mp3，mp4，flv等多媒体文件预览
使用spring boot开发，预览服务搭建部署非常简便
rest接口提供服务，跨平台特性(java,php,python,go,php，....)都支持，应用接入简单方便
支持普通http/https文件下载url、http/https文件下载流url、ftp下载url等多种预览源
提供zip，tar.gz发行包，提供一键启动脚本和丰富的配置项，方便部署使用
提供Docker镜像发行包，方便在容器环境部署
抽象预览服务接口，方便二次开发，非常方便添加其他类型文件预览支持
最最重要Apache协议开源，代码pull下来想干嘛就干嘛

部署

Linux部署包下载：kkfileview.keking.cn/kkFileView-…

windows部署包下载：kkfileview.keking.cn/kkFileView-…

环境要求：Java: 1.8+

部署步骤：

1). 物理机或虚拟机上运行

下载最新版发行包
解压kkFileView-x.x.x文件（Windows用.zip包，Linux/MacOS用.tar.gz包）
打开解压后文件夹的bin目录，运行startup脚本（Windows下以管理员身份运行startup.bat，Linux以root用户运行startup.sh）
浏览器访问本机8012端口 http://127.0.0.1:8012 即可看到项目演示用首页

2). Docker容器环境环境运行

拉取镜像：docker pull keking/kkfileview
运行：docker run -it -p 8012:8012 keking/kkfileview
浏览器访问容器8012端口 http://xxx.xxx.xxx.xxx:8012 即可看到项目演示用首页

使用

1). 普通文件下载url预览

<script type=``"text/javascript"` `src=``"https://cdn.jsdelivr.net/npm/js-base64@3.6.0/base64.min.js"``></script>` `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)));

2).http/https下载流url预览

特别说明：* 很多系统内不是直接暴露文件下载地址，而是请求通过id、code等参数到通过统一的接口，后端通过id或code等参数定位文件，再通过OutputStream输出下载，此时下载url是不带文件后缀名的，预览时需要拿到文件名，传一个参数***fullfilename=xxx.xxx来指定文件名，示例如下：**

<script type=``"text/javascript"` `src=``"https://cdn.jsdelivr.net/npm/js-base64@3.6.0/base64.min.js"``></script>` `var originUrl = ``'http://127.0.0.1:8080/filedownload?fileId=1'``; //要预览文件的访问地址，后端文件下载地址``var previewUrl = originUrl + ``'&fullfilename=test.txt'``window.open(``'http://127.0.0.1:8012/onlinePreview?url='``+encodeURIComponent(Base64.encode(previewUrl)));

配置说明

参考kkfileview官方说明：kkfileview.keking.cn/zh-cn/docs/…

常见问题

常见问题可参考kkfileview官网 kkfileview.keking.cn/zh-cn/docs/…

kkfilekview部署文档

简介

部署