kkFileView文件预览使用

官网

gitee：https://gitee.com/kekingcn/file-online-preview/tags

官网：https://kkfileview.keking.cn/zh-cn/index.html

github：https://github.com/kekingcn/kkFileView/

一、运行项目

下载运行

https://github.com/kekingcn/kkFileView

第二步：用 IDEA打开

运行项目，访问 http://127.0.0.1:8012

二、linux部署项目

1. 环境要求

1. Java: 1.8+
2. LibreOffice或OpenOffice(Windows下已内置，CentOS或Ubuntu下会自动下载安装，MacOS下需要自行安装

2. 部署运行

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

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

linux部署时候，注意解决字体的问题

解决中文乱码问题

下载如下字体包 http://kkfileview.keking.cn/fonts.zip

解压上传至 /usr/share/fonts 目录下。

给字体文件赋予访问权限，使得 kkFileView 能够使用该字体。

chmod -R 755 *.TTF
chmod -R 755 *.ttf
chmod -R 755 *.ttc

重载环境source /etc/profile

重启 kkFileView。

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

拉取镜像

# 网络环境方便访问docker中央仓库
docker pull keking/kkfileview:4.1.0

# 网络环境不方便访问docker中央仓库
wget https://kkfileview.keking.cn/kkFileView-4.1.0-docker.tar
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 即可看到项目演示用首页

3. 项目接入使用

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

3.x.x 及以上版本

<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(previewUrl)));

2.x.x 及以下版本

var url = 'http://127.0.0.1:8080/file/test.txt'; //要预览文件的访问地址
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(previewUrl));

详细使用说明见 使用指南

三、nginx代理

各个版本代理不一样，请根据官网要求进行代理