kkFileView 是一个开源的在线文件预览服务,支持多种格式(如Office、PDF、图片、视频等)的在线预览,适合集成到企业或个人的文档管理系统中。以下是其常见的部署方式及步骤:
一、环境准备
操作系统:Linux(推荐)、Windows、macOS。
依赖环境:
JDK 1.8+(必须)
LibreOffice(用于Office文件转PDF,建议7.0+版本)
FFmpeg(用于视频文件预览)
ImageMagick(用于图片处理)
二、部署方式
-
Docker 部署(推荐)
步骤:
1.1、拉取镜像:
docker pull keking/kkfileview
1.2、运行容器:
docker run -d -p 8012:8012 --name kkfileview keking/kkfileview
8012 为默认端口,可自定义(如 -p 8080:8012)。
1.3验证访问:
浏览器打开 http://服务器IP:8012,上传文件测试预览功能。
配置修改:
若需自定义配置(如缓存路径、水印等),可挂载配置文件:
docker run -d -p 8012:8012 -v /本地路径/application.yml:/opt/kkFileView-4.0.0/config/application.yml keking/kkfileview -
War 包部署(Tomcat)
步骤:
下载War包:
从GitHub Release页面下载最新版本:
https://github.com/kekingcn/kkFileView/releases
部署到Tomcat:
将 kkFileView-x.x.x.war 放入Tomcat的 webapps 目录。
启动Tomcat:
./bin/startup.sh # Linux
bin\startup.bat # Windows
验证访问:
浏览器访问 http://服务器IP:Tomc