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以及众多类文本类型文件在线预览icon-default.png?t=N7T8https://gitee.com/kekingcn/file-online-preview

kkFileView的使用经验分享(内网)_第1张图片

kkFileView的使用经验分享(内网)_第2张图片

2、用自己的开发工具打开(idea)

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

kkFileView的使用经验分享(内网)_第3张图片

2、打包

kkFileView的使用经验分享(内网)_第4张图片

kkFileView的使用经验分享(内网)_第5张图片

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

kkFileView的使用经验分享(内网)_第6张图片

运行命令:

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以及众多类文本类型文件在线预览icon-default.png?t=N7T8https://gitee.com/kekingcn/file-online-preview

kkFileView的使用经验分享(内网)_第7张图片

kkFileView的使用经验分享(内网)_第8张图片

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

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步骤

kkFileView的使用经验分享(内网)_第9张图片

kkFileView的使用经验分享(内网)_第10张图片

kkFileView的使用经验分享(内网)_第11张图片

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

2、安装没成功(脚本无法使用,概率小) 

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

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

kkFileView的使用经验分享(内网)_第12张图片

文件乱码

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的工作模式是将文件下载到缓存,然后再去给用户预览。

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

正常就没有其他问题。

结束语

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

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

你可能感兴趣的:(java,开源软件,gitee,经验分享)