kkFileView-4.4.0-beta文档在线预览编译包for linux/windows/mac/docker

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

最近在使用kkFileView-4.4.0-beta文档在线预览编译包for linux/windows/mac。

编译后安装包：

一. 下载&部署

在kk开源社区置顶帖下载最新发行包

Linux环境部署

1. 安装java8或以上版本java运行环境

2. 解压下载的发行包 kkFileView-4.4.0.tar.gz

tar -zxvf kkFileView-4.4.0.tar.gz

3. 进入解压后 kkFileView-4.4.0/bin 文件夹

4. 执行 ./startup.sh 启动kkFileView

Windows环境部署

1. 安装java8或以上版本java运行环境

2. 解压下载的发行包 kkFileView-4.4.0.zip

3. 使用管理员身份打开cmd，并作用cd命令进入解压后 kkFileView-4.4.0\bin 文件夹

4. 执行 .\startup.bat 启动kkFileView

Docker环境部署

1. 安装Dokcer最新版本

2. 下载Docker版本离线发行包 kkFileView-4.4.0-docker.tar

3. 加载Docker镜像

docker load -i kkFileView-4.4.0-docker.tar

4. 运行Docker镜像

docker run -it -p 8012:8012 keking/kkfileview:4.4.0

5. Docker版本修改配置项

Docker版本支持使用环境变量修改系统配置项，环境变量的KEY为配置文件中每个配置项后${}中的KEY

例如，使用Docker运行要指定base.url为http://file.kkview.cn，Docker运行命令如下

docker run -it -e KK_BASE_URL='http://file.kkview.cn' -p 8012:8012 keking/kkfileview:4.3.0

二. 使用说明

普通http/https文件下载链接

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

<script src="https://unpkg.com/js-base64@3.6.0/base64.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(previewUrl)));

http/https下载流url预览 

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

<script src="https://unpkg.com/js-base64@3.6.0/base64.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)));

ftp 资源文件预览 

如果要预览的FTP url是可以匿名访问的（不需要用户名密码），则可以直接通过下载url预览，示例如下

<script src="https://unpkg.com/js-base64@3.6.0/base64.js"></script>
var url = 'ftp://127.0.0.1/file/test.txt'; //要预览文件的访问地址
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(url)));

ftp 加密资源文件预览

如果 FTP 需要认证访问服，可以通过在 url 中加入用户名密码等参数预览，示例如下

<script src="https://unpkg.com/js-base64@3.6.0/base64.js"></script>
var originUrl = 'ftp://127.0.0.1/file/test.txt'; //要预览文件的访问地址
var previewUrl = originUrl + '?ftp.username=xx&ftp.password=xx&ftp.control.encoding=xx';
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(previewUrl)));