kkFileView的使用经验分享（内网）

摘要

        kkFileView是一个文件预览解决方案，支持大部分常用的文件格式。该项目是基于 SpringBoot 进行搭建，对于 java 的程序员来说非常的友好，容易上手和部署。该项目不需要二开，需要独立部署。

简介

        本篇文章主要分享的内容是我对这个项目的部分理解、部署过程的总结、遇到的问题分析以及解决方式。

一、部署运行

官网： kkFileView - 在线文件预览

1-1 特殊网络部署（无法访问互联网）

安装openOffice

        安装libreOffice 由于我已经实践过，会缺失依赖，我这边建议直接安装openOffice就好了，想试试安装libreOffice的可以去百度。

 1、 下载

链接：https://pan.baidu.com/s/1cfPoQfBxyjvCeafMNBvSXQ?pwd=zie7 
提取码：zie7

2、上传到服务器

3、解压

tar -zxvf Apache_OpenOffice_4.1.14_Linux_x86-64_install-rpm_zh-CN.tar.gz

4、进入目录RPMS

5、运行命令

sudo yum localinstall  *.rpm  #安装命令

sudo yum remove  openoffice*   #删除命令

环境要求

1、 java：1.8+

2、OpenOffice(已安装)
 

Linux系统上部署

1、下载kkFileView

访问链接: kkFileView: 使用spring boot打造文件文档在线预览项目解决方案，支持doc、docx、ppt、pptx、wps、xls、xlsx、zip、rar、ofd、xmind、bpmn 、eml 、epub、3ds、dwg、psd 、mp4、mp3以及众多类文本类型文件在线预览https://gitee.com/kekingcn/file-online-preview

2、用自己的开发工具打开（idea）

1、设置office文件预览默认用pdf。

2、打包

3、将打完的包上传到服务器，启动。

启动脚本：

#!/in/bash
APP_PATH=/www/wwwroot/
APP_NAME=j=kkFileView-4.2.1.jar
usage() {
    echo "case: sh run.sh [start|stop|restart|status]"
    echo "请类似这样执行 ./*.sh start   or  ./*sh restart"pwd
    exit 1
}

# 判断当前服务是否已经启动的函数
is_exist(){
    echo "执行 is_exist 方法"
    pid=`ps -ef|grep ${APP_PATH}$APP_NAME|grep -v grep|awk '{print $2}' ` #根据ps 命令查询当前服务的进程号 赋值给pid"
    if [ -z "${pid}" ]; then #判断pid是否为空
        echo "pid 等于null,应用不在运行"
        return 1
    else
        echo "pid 不等于null,${APP_NAME}正在${pid}运行"
        return 0
    fi
}
start(){
    is_exist
    if [ $? -eq "0" ]; then    # [$? -eq "0"] 说明pid不等于空 说明服务正在运行中，将进程号打印出来
        echo "${APP_NAME} running. pid=${pid}"
    else
        nohup java -Dfile.encoding=UTF-8 -jar ${APP_PATH}${APP_NAME} > /dev/null 2>&1 &
        # nohup java -jar ../lib/$APP_NAME > log.file 2>log.error &  # 说明pid为空 执行java -jar 命令启动服务
        echo "${APP_PATH}${APP_NAME} started"
    fi
}
stop(){
    echo "执行 stop 方法"
    is_exist
    if [ $? -eq "0" ]; then    # [$? -eq "0"] 说明pid不等于空 说明服务正在运行中，将进程号杀死
        kill -9 $pid
        echo "${APP_PATH}${APP_NAME}:${pid} stopped"
    else
        echo "${APP_PATH}${APP_NAME} not running"
    fi
}
status(){
    echo "执行 status 方法"
    is_exist
    if [ $? -eq "0" ]; then
        echo "${APP_PATH}${APP_NAME} running. Pid is ${pid}"
    else
        echo "${APP_PATH}${APP_NAME} not running"
    fi
}
# 重启命令其实就是先执行关闭命令 再执行重启命令
restart(){
    stop
    start
}

# 这里的$1 取的是当前输入命令 的第二个参数 ./start.sh start
case "$1" in
    "start")
        start
        ;;
    "stop")
        stop
        ;;
    "status")
        status
        ;;
    "restart")
        restart
        ;;
    *)
    usage
    ;;
esac

运行命令：

sh  run.sh  restart  #重启命令
sh  run.sh  stop  #停止命令

最后访问

 http://127.0.0.1:8012 #对应服务器的地址8012 端口，记得放行端口

前端调用

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-2 互联网部署

互联网的部署相对于内网来说容易很多，因为有网络

访问链接 kkFileView: 使用spring boot打造文件文档在线预览项目解决方案，支持doc、docx、ppt、pptx、wps、xls、xlsx、zip、rar、ofd、xmind、bpmn 、eml 、epub、3ds、dwg、psd 、mp4、mp3以及众多类文本类型文件在线预览https://gitee.com/kekingcn/file-online-preview

将下载好的文件上传服务器

1、解压kkFileView-x.x.x文件（Windows用.zip包，Linux/MacOS用.tar.gz包）

2、打开解压后文件夹的bin目录，运行startup脚本（Windows下以管理员身份运行startup.bat，Linux以root用户运行startup.sh）

3、浏览器访问本机8012端口 http://127.0.0.1:8012 即可看到项目演示用首页

二、常用配置说明

office.preview.type 

说明：office文件（doc、docx、ppt、pptx）、pdf 文件预览方式，默认为图片方式，预览时也有按钮相互切换，可选项：'image', 'pdf'

image: 默认预览方式，将office文件每一页后台转成图片，前台懒加载（只加载当前页面内容），推荐预览文件大且前台加载慢的时候使用

pdf: 统一转成pdf加一次加载，推荐内网访问，网速快时使用

watermark.txt 

默认水印内容，如需取消水印，内容设置为空即可，例如：watermark.txt = ${WATERMARK_TXT:}

默认值：''

watermark.x.space 

水印x轴间隔

默认值：10

watermark.y.space 

水印y轴间隔

默认值：10

watermark.font 

水印字体

默认值：微软雅黑

watermark.fontsize 

水印字体大小

默认值：18px

watermark.color 

水印字体颜色

默认值：black

watermark.alpha 

水印透明度，要求设置在大于等于0.005，小于1

默认值：0.2

watermark.width 

水印宽度

默认值：180

watermark.height 

水印高度 默认值：80

watermark.angle 

水印倾斜度数，要求设置在大于等于0，小于90

默认值：10

三、遇到的问题

office.home 配置有误

有三种原因

1、没有安装libreOffice或者openOffice。

1、内网按照我上面的方式安装一下openOffice

前提：如果运行脚本不行的话

2、外网也可以跟内网一样安装openOffice，或者直接 yum install libreoffice，实在不行去 libreoffice.org 官网下载一个到服务器 然后 解压进入RPMS 运行 yum localinstall *.rpm ，可以参考上面安装openOffice。

libreOffice安装包：

链接：https://pan.baidu.com/s/1t3VdfgiZ8tzLrSS-GHokAQ?pwd=mfo0 
提取码：mfo0

自行安装libreOffice步骤

安装方式跟上面安装openOffice一样

2、安装没成功（脚本无法使用，概率小） 

3、你自己安装的所在目录不是程序识别的默认路径

看看你的配置文件中有没有改动，按照软件的真实环境去配置，如果你是按照我写的内容去做的，正常不会有这种情况。

文件乱码

1、 下载字体

链接： http://kkfileview.keking.cn/fonts.zip

压缩包：

链接：https://pan.baidu.com/s/1G3q2R0KnE6_68bgUjFwk2Q?pwd=5870 
提取码：5870

2、将文件上传到 /usr/share/fonts 并解压

unzip fonts.zip

3、解压后进入目录执行命令

chmod -R 755 *.TTF chmod -R 755 *.ttf chmod -R 755 *.ttc source /etc/profile

4、重启kkFileView服务

office文件预览一直加载

修改配置文件：

office.preview.type=pdf

文件预览失败

先排除一下，静态资源能否请求到。

kkFIleView的工作模式是将文件下载到缓存，然后再去给用户预览。

所以先要排除文件能否下载。

正常就没有其他问题。

结束语

以上的内容属于个人见解，欢迎沟通交流。

有遇到新的问题，我会继续分享到这篇文章