CentOS使用kkFileView实现在线预览word excel pdf等

一、环境安装

1、安装LibreOffice

wget https://downloadarchive.documentfoundation.org/libreoffice/old/7.5.3.2/rpm/x86_64/LibreOffice_7.5.3.2_Linux_x86-64_rpm.tar.gz
# 解压缩
tar -zxf LibreOffice_7.5.3.2_Linux_x86-64_rpm.tar
cd LibreOffice_7.5.3.2_Linux_x86-64_rpm/RPMS

## 执行安装
yum install -y libSM.x86_64 libXrender.x86_64  libXext.x86_64
yum groupinstall -y  "X Window System"
yum localinstall -y *.rpm

安装目录是 /opt/libreoffice7.5，需要修改启动脚本 bin/startup.sh，将安装目录/opt/libreoffice7.5包含在office检查目录中

DIR_HOME=("/opt/openoffice.org3" "/opt/libreoffice" "/opt/libreoffice6.1" "/opt/libreoffice7.5" "/opt/libreoffice7.1" "/opt/libreoffice7.2" "/opt/libreoffice7.3" "/opt/libreoffice7.4" "/opt/openoffice4" "/us
r/lib/openoffice" "/usr/lib/libreoffice")

2、安装中文字体

下载中文字体文件fonts.zip

链接：https://pan.baidu.com/s/1Mn1NH78-s2rrEZdgTDi5hg
提取码：kkfv

将下载的字体fonts.zip上传到 /usr/share/fonts 目录解压后执行命令 mkfontscale

若 mkfontscale 提示没有命令则先 yum install mkfontscale 安装命令

再分别依次执行 mkfontscale、mkfontdir、fc-cache 命令。

二、下载源码打包

1、解压运行

下载源码 https://gitee.com/kekingcn/file-online-preview

用IDEA打开编译打包后，得到部署压缩包 file-online-preview/server/target/kkFileView-4.3.0-SNAPSHOT.tar

将kkFileView-4.3.0-SNAPSHOT.tar 上传到服务器解压

# 解压缩
tar -zxf kkFileView-4.3.0-SNAPSHOT.tar

进入目录，执行启动脚本

cd kkFileView-4.3.0-SNAPSHOT
./startup.sh

2、打开测试页面

项目成功启动后，可以打开测试页面 http://127.0.0.1:8012/

三、项目接入使用

1、简单使用，传入url参数和fullfilename参数

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

2、建议增加安全参数

为了文件安全和实效性，你可以在你的接口中加入token或者其他校验参数，满足了才能下载文件

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/js-base64@3.6.0/base64.min.js"></script>

var originUrl = 'http://127.0.0.1:8080/filedownload?token=sgdfhkkmlk&time=1659006176&fileID=4564sfd&filename=test.xls'; //要预览文件的访问地址，该接口返回文件流
var previewUrl = originUrl + '&fullfilename=test.xls'//fullfilename是必须的，该参数是kkFileView保存的文件名
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(Base64.encode(previewUrl)));

注意：当使用 base64 对 previewUrl 进行编码时，如果采用MIME友好型 base64 加密会导致长度每大于 76 就会加入\r 或者 \n 这样的换行控制符，这样再使用encodeURIComponent进行编码就会产生 %0A 这样的字符，就会导致预览不了。解决办法就是base64编码后去除 \r 和 \n 然后再使用 encodeURIComponent 编码，encodeURIComponent 编码后再去除 %0A

3、配置固定水印

打开文件src/main/config/application.properties，修改配置参数：

#水印内容
#如需取消水印，内容设置为空即可，例：watermark.txt = ${WATERMARK_TXT:}
watermark.txt = ${WATERMARK_TXT:内部文件，严禁外泄}
#水印x轴间隔
watermark.x.space = ${WATERMARK_X_SPACE:100}
#水印y轴间隔
watermark.y.space = ${WATERMARK_Y_SPACE:100}
#水印字体
watermark.font = ${WATERMARK_FONT:微软雅黑}
#水印字体大小
watermark.fontsize = ${WATERMARK_FONTSIZE:18px}
#水印字体颜色
watermark.color = ${WATERMARK_COLOR:black}
#水印透明度，要求设置在大于等于0.005，小于1
watermark.alpha = ${WATERMARK_ALPHA:0.1}
#水印宽度
watermark.width = ${WATERMARK_WIDTH:180}
#水印高度
watermark.height = ${WATERMARK_HEIGHT:80}
#水印倾斜度数，要求设置在大于等于0，小于90
watermark.angle = ${WATERMARK_ANGLE:10}

4、动态水印

在预览url后面加上参数&watermarkTxt即可

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

四、其他扩展功能

以下功能需修改源码，可以到这里下载源码：https://gitee.com/kekingcn/file-online-preview

1、禁用鼠标右键功能

打开文件src/main/resources/static/pdfjs/web/viewer.html

增加如下内容

// ..忽略其他内容.. //
<script>
    // ..忽略其他内容.. //
    //禁用右键（防止右键查看源代码）
    window.oncontextmenu = function () { return false; }
    //禁止任何键盘敲击事件（防止F12和shift+ctrl+i调起开发者工具）
    window.onkeydown = window.onkeyup = window.onkeypress = function () {
        window.event.returnValue = false;
        return false;
    }
    //如果用户在工具栏调起开发者工具，那么判断浏览器的可视高度和可视宽度是否有改变，如有改变则关闭本页面
    var h = window.innerHeight, w = window.innerWidth;
    window.onresize = function () {
        if (h != window.innerHeight || w != window.innerWidth) {
            window.close();
            window.location = "about:blank";
        }
    }
    /**
     * 禁止右键和复制
     */
    document.oncontextmenu=new Function("event.returnValue=false");
    document.onselectstart=new Function("event.returnValue=false");
</script>

<style>
    // ..忽略其他内容.. //
    <#-- 设置浏览器打印为空白内容，防止打印 -->
    @media print{body{display:none}}
</style>

2、禁止复制功能

打开文件src/main/java/cn/keking/service/FileHandlerService.java，修改方法doActionConvertedFile()

/**
 * 对转换后的文件进行操作(改变编码方式)
 *
 * @param outFilePath 文件绝对路径
 */
public void doActionConvertedFile(String outFilePath) {
    String charset = EncodingDetects.getJavaEncode(outFilePath);
    StringBuilder sb = new StringBuilder();
    try (InputStream inputStream = new FileInputStream(outFilePath);
         BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream, charset))) {
        String line;
        while (null != (line = reader.readLine())) {
            if (line.contains("charset=gb2312")) {
                line = line.replace("charset=gb2312", "charset=utf-8");
            }
            sb.append(line);
        }
        // 添加sheet控制头
        sb.append("<script src=\"js/jquery-3.6.1.min.js\" type=\"text/javascript\"></script>");
        sb.append("<script src=\"js/excel.header.js\" type=\"text/javascript\"></script>");
        sb.append("<link rel=\"stylesheet\" href=\"bootstrap/css/xlsx.css\">");
        // 添加禁止复制功能
        sb.append("<<script language=\"Javascript\">\n" +
                "\n" +
                "    //禁用右键（防止右键查看源代码）\n" +
                "    window.oncontextmenu = function () { return false; }\n" +
                "    //禁止任何键盘敲击事件（防止F12和shift+ctrl+i调起开发者工具）\n" +
                "    window.onkeydown = window.onkeyup = window.onkeypress = function () {\n" +
                "        window.event.returnValue = false;\n" +
                "        return false;\n" +
                "    }\n" +
                "    //如果用户在工具栏调起开发者工具，那么判断浏览器的可视高度和可视宽度是否有改变，如有改变则关闭本页面\n" +
                "    var h = window.innerHeight, w = window.innerWidth;\n" +
                "    window.onresize = function () {\n" +
                "        if (h != window.innerHeight || w != window.innerWidth) {\n" +
                "            window.close();\n" +
                "            window.location = \"about:blank\";\n" +
                "        }\n" +
                "    }\n" +
                "    /**\n" +
                "     * 禁止右键和复制\n" +
                "     */\n" +
                "    document.οncοntextmenu=new Function(\"event.returnValue=false\");\n" +
                "    document.onselectstart=new Function(\"event.returnValue=false\");\n" +
                "</script>");
    } catch (IOException e) {
        e.printStackTrace();
    }
    // 重新写入文件
    try (FileOutputStream fos = new FileOutputStream(outFilePath);
         BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(fos, StandardCharsets.UTF_8))) {
        writer.write(sb.toString());
    } catch (IOException e) {
        e.printStackTrace();
    }
}

参考

• https://blog.csdn.net/qq_33697094/article/details/126076565

• kkFileView - 在线文件预览 (kkview.cn)

• 源码地址：https://gitee.com/kekingcn/file-online-preview