kkFileView 4.4.0最新版本发行版安装包部署及使用文档

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

一. 下载&部署

下载最新发行包，git上只有源码，没有发行编译安装包，如需可自行编译，本人已编译出来，如需要请在最文章最下面wx我。

发行版包含下载：
kkFileView-4.4.0-beta.zip (Windows版)
kkFileView-4.4.0-beta.tar.gz (Linux或MacOS版)
kkFileView-4.4.0-beta-docker.tar (Docker离线文件版)

发行安装包需要自行编译：


编译后的安装包：

编译出来的这个才能安装。

Linux环境部署

1. 安装java8或以上版本java运行环境
2. 上传编译包到服务器，解压下载的发行包 kkFileView-4.4.0-beta.tar.gz

tar -zxvf kkFileView-4.4.0-beta.tar.gz

3. 进入解压后 kkFileView-4.4.0-beta/bin 文件夹
4. 执行 ./startup.sh 启动kkFileView

Windows环境部署

1. 安装java8或以上版本java运行环境
2. 解压下载的发行包 kkFileView-4.4.0-beta.zip
3. 使用管理员身份打开cmd，并作用cd命令进入解压后 kkFileView-4.4.0-beta\bin 文件夹
4. 执行 .\startup.bat 启动kkFileView

Docker环境部署

1. 安装Dokcer最新版本
2. 下载Docker版本离线发行包 kkFileView-4.4.0-beta-docker.tar
3. 加载Docker镜像

docker load -i kkFileView-4.4.0-beta-docker.tar

4. 运行Docker镜像

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

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预览，示例如下