通用文件在线预览软件kkFileView

news2025/10/28 15:05:05

在这里插入图片描述

什么是 kkFileView ？

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

如果你不想搭建，可以去官方的演示站点进行体验，地址：https://file.kkview.cn

在这里插入图片描述

安装

在群晖上以 Docker 方式安装。

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

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

在这里插入图片描述

卷

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

文件夹	装载路径	说明
`docker/kkfileview/data`	`/opt/kkFileView-4.1.0/file/demo`	存放上传文件

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

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 端口号

本地端口	容器端口
`8012`	`8012`

默认没有对外暴露端口

在这里插入图片描述

需要点 + 号自行添加

在这里插入图片描述

命令行安装

如果你熟悉命令行，可能用 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/kkfileview
    container_name: kkfileview
    restart: unless-stopped
    ports:
      - 8012:8012
    volumes:
      - ./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