【Java】在线文件预览服务 KkFileView

原来有第三方在线预览服务接口：

需要收费使用：

https://view.xdocin.com/

但是经费不足，突然撤掉服务接口，只能把KkFileView架出来使用了

KkFileView官网地址：

http://kkfileview.keking.cn/zh-cn/index.html

Java编写的服务，有源码提供：

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

打包好的软件包需要花99元才能获取下载地址

可以直接下载源码打包，我是大冤种

Windows
http://kkfileview.keking.cn/kkFileView-4.1.0.zip

Linux & MacOS
http://kkfileview.keking.cn/kkFileView-4.1.0.tar.gz

Windows部署　　

Windows平台部署只需要安装JDK8，自带Office插件包，双击Startup.bat运行

Linux部署

需要JDK8环境和LibreOffice插件，在bin目录中提供了安装脚本

先执行install脚本之后，再执行startup脚本运行

已发现使用 XShell 或者 MobaXterm执行启动脚本时会无端阻塞Office插件的进程

这里我后面找到一个平替的终端工具【WindTerm】功能也很强大

2023年02月13日更新

PDF预览在Chorme一些版本展示会出问题，无法显示PDF预览效果

解决办法是直接修改KkFileView的源码信息：

首先需要先禁用图片的切换：

#office类型文档(word ppt)样式，默认为图片(image)，可配置为pdf（预览时也有按钮切换）
office.preview.type = ${KK_OFFICE_PREVIEW_TYPE:image}
#是否关闭office预览切换开关，默认为false，可配置为true关闭
office.preview.switch.disabled = ${KK_OFFICE_PREVIEW_SWITCH_DISABLED:true}

要修改的模版文件：OfficePicture.ft

让PDF默认以IMAGE方式展示，并且可以点击预览控件来放大缩小

修正图片的预览样式

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8" />
    <title>PDF图片预览</title>
    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
    <meta name="renderer" content="webkit">
    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
    <script src="js/lazyload.js"></script>
    <link rel="stylesheet" href="css/viewer.min.css">
    <script src="js/viewer.min.js"></script>
    <#include "*/commonHeader.ftl">
    <style>
        body {
            background-color: #404040;
            width: 100%;
        }
        .container {
            width: 100%;
            height: 100%;
        }
        #container { width: 90%; margin: 0 auto; font-size: 0;}
        #container li {  display: inline-block;width: 50px;height: 50px; margin-left: 1%; padding-top: 1%;}
        .img-area {
            text-align: center;
        }
        img {
            /*max-width: 98%;*/
            width: 100%;
            margin:0 auto;
            border-radius:3px;
            box-shadow:rgba(0,0,0,0.15) 0 0 8px;
            background:#FBFBFB;
            border:1px solid #ddd;
            margin:1px auto;
            /* margin-left: 15px; */
            padding:5px;
        }

    </style>
</head>
<body>
<div class="container" id="container">
    <#list imgurls as img>
        <div class="img-area">
            <img class="my-photo" alt="loading"  data-src="${img}" src="images/loading.gif">
        </div>
    </#list>
</div>
<#if "false" == switchDisabled>
    <img src="images/pdf.svg" width="63" height="63" style="position: fixed; cursor: pointer; top: 40%; right: 48px; z-index: 999;" alt="使用PDF预览" title="使用PDF预览" onclick="changePreviewType('pdf')"/>
</#if>
<script>
    var viewer = new Viewer(document.getElementById('container'), {
        url: 'src',
        navbar: true, /* 底部缩略图轮播条 */
        button: true, /* 关闭 */
        backdrop: true, /* 背景遮罩 */
        loop : true
    });

    window.onload = function () {
        /*初始化水印*/
        initWaterMark();
        checkImgs();
    };
    window.onscroll = throttle(checkImgs);
    function changePreviewType(previewType) {
        var url = window.location.href;
        if (url.indexOf("officePreviewType=image") !== -1) {
            url = url.replace("officePreviewType=image", "officePreviewType="+previewType);
        } else {
            url = url + "&officePreviewType="+previewType;
        }
        if ('allImages' === previewType) {
            window.open(url)
        } else {
            window.location.href = url;
        }
    }
</script>
</body>
</html>

效果实现：

可以看到设置了预览控件，内容居中

项目打包：

会直接打包成TarGz和Zip包，对应系统平台

Linux启动失败的问题：

发现使用XShell启动服务时，会外连Xmanager，导致启动失败

在MobaXterm终端启动时也会这样，原因未知

https://blog.csdn.net/weixin_43128854/article/details/128236271

这里我建议是直接换一个终端工具操作，例如改用FinalShell

配置Nginx代理：

这个不要乱改，直接看官方文档说明

https://kkfileview.keking.cn/zh-cn/docs/config.html

项目测试环境的配置：

预览服务地址：

上下文路径：

KkFileView 更改BaseUrl配置

Application.properties配置项补充：

这里只列举几个重要的参数项

一、Office插件配置

Linux默认脚本安装，如果手动安装LibreOffice，要自己替换Home路径

# office-plugin
## office转换服务的进程数，默认开启两个进程
office.plugin.server.ports = 2001,2002
## office 转换服务 task 超时时间，默认五分钟
office.plugin.task.timeout = 5m

#openoffice home路径
#office.home = C:\\Program Files (x86)\\OpenOffice 4
office.home = ${KK_OFFICE_HOME:default}

二、服务缓存配置

可以配置Redis作为缓存实现，可选项

#缓存实现类型，不配默认为内嵌RocksDB(type = default)实现，可配置为redis(type = redis)实现（需要配置spring.redisson.address等参数）和 JDK 内置对象实现（type = jdk）,
cache.type =  ${KK_CACHE_TYPE:jdk}
#redis连接，只有当cache.type = redis时才有用
spring.redisson.address = ${KK_SPRING_REDISSON_ADDRESS:127.0.0.1:6379}
spring.redisson.password = ${KK_SPRING_REDISSON_PASSWORD:}
#缓存是否自动清理 true 为开启，注释掉或其他值都为关闭
cache.clean.enabled = ${KK_CACHE_CLEAN_ENABLED:true}
#缓存自动清理时间，cache.clean.enabled = true时才有用，cron表达式，基于Quartz cron
cache.clean.cron = ${KK_CACHE_CLEAN_CRON:0 0 3 * * ?}

#是否启用缓存
cache.enabled = ${KK_CACHE_ENABLED:true}

三、Nginx代理配置

#提供预览服务的地址，默认从请求url读，如果使用nginx等反向代理，需要手动设置
#base.url = https://file.keking.cn
base.url = ${KK_BASE_URL:default}

#信任站点，多个用','隔开，设置了之后，会限制只能预览来自信任站点列表的文件，默认不限制
#trust.host = file.keking.cn,kkfileview.keking.cn
trust.host = ${KK_TRUST_HOST:default}

posted @ 2023-02-13 17:31 emdzz 阅读(3211) 评论(0) 收藏举报

刷新页面返回顶部

Silent1376

Emancipate the mind,Seek truth from the facts.