通用文件在线预览软件kkFileView

在线预览软件kkFileView"/>

通用文件在线预览软件kkFileView

什么是 kkFileView ？

kkFileView 为文件文档在线预览解决方案，基本支持主流办公文档的在线预览，如 doc，docx，xls，xlsx，ppt，pptx，pdf，txt，zip，rar，图片，视频，音频等等，官方一直在扩展支持的文件类型，不断优化预览的效果。项目基于流行的 spring boot 搭建，提供restful 接口，适用于微服务场景。

如果你不想搭建，可以去官方的演示站点进行体验，地址：

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 kkfileview ，选择第一个 keking/kkfileview，版本选择 latest。

本文写作时， latest 版本对应为 4.1.0；其实官方的版本已经到了 4.3.0，但不知道为何，镜像一直没有更新，官方提供了 Dockerfile，你可以选择自己打包；

卷

在 docker 文件夹中，创建一个新文件夹 kkfileview，并在其中建一个子文件夹 data

关于 装载路径，因为路径中涉及版本信息，当你不确定的时候，比较靠谱的方式是： 先不映射卷，然后上传一个文件，在日志中查看上传的路径，去掉文件名，就是我们要找的 装载路径

2023-10-20 13:49:42.138  INFO 1 --- [tp1224347463-20] cn.keking.web.controller.FileController  : 上传文件：/opt/kkFileView-4.1.0/file/demo/图片 1（压缩）.png

端口

本地端口不冲突就行，不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号

默认没有对外暴露端口

需要点 + 号自行添加

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 kkfileview 
mkdir -p /volume1/docker/kkfileview/data# 进入 kkfileview 目录
cd /volume1/docker/kkfileview# 运行容器
docker run -d \--restart unless-stopped \--name kkfileview \-p 8012:8012 \-v $(pwd)/data:/opt/kkFileView-4.1.0/file/demo \keking/kkfileview

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'services:kkfileview:image: keking/kkfileviewcontainer_name: kkfileviewrestart: unless-stoppedports:- 8012:8012volumes:- ./data:/opt/kkFileView-4.1.0/file/demo

然后执行下面的命令

# 新建文件夹 kkfileview 
mkdir -p /volume1/docker/kkfileview/data# 进入 kkfileview 目录
cd /volume1/docker/kkfileview# 将 docker-compose.yml 放入当前目录# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:8012 就能看到主界面，支持预览在线文件，也支持上传后预览

先上传一个文件

然后就可以预览了

当然，因为我们挂载了目录，也可以把文档直接拷入 kkfileview/data 目录

回到页面刷新一下就能看到文件了

如果刷不出来，应该是版本有了变化，获取 装载路径 的方法请看前面的章节

详细的使用指南，可以去看官方的文档：.html

参考文档

kekingcn/kkFileView: Universal File Online Preview Project based on Spring-Boot
地址：

kkFileView - 在线文件预览
地址：

kkFileView演示首页
地址：/

kkFileView - 在线文件预览
地址：.html