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.beta文档在线预览编译包 linux/windows/mac。

编译后安装包：

一. 下载&部署

下载kk开源社区最新发行包

Linux环境部署

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

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

tar -zxvf kkFileView-4.4.0.tar.gz

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

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

部署Windows环境

1. Java8或以上版本的Java运行环境

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

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

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

环境部署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来指定baser.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)));