kkFileView文件预览组件部署说明

kkFileView组件部署流程指南

在数字化办公与文件管理场景中，在线文件预览功能极为关键。kkFileView作为一款优秀的开源在线文件预览组件，支持多种格式文件的预览，为企业和开发者提供了便捷的解决方案。下面将详细介绍其部署步骤。

一、前期准备

系统要求：推荐在Linux系统（如CentOS 7+、Ubuntu 18.04+）上部署，也可在Windows系统进行测试部署，但生产环境建议使用Linux以获得更好的稳定性和性能。
软件依赖

Java环境：kkFileView基于Java开发，需提前安装Java 1.8及以上版本。在Linux系统中，使用包管理工具安装OpenJDK，
例如在CentOS中执行

yum install java-1.8.0-openjdk-devel

在Ubuntu中执行

apt-get install openjdk-8-jdk

安装完成后，通过 java -version 命令验证安装是否成功。

Maven：用于项目构建和依赖管理。从Maven官方网站下载对应操作系统的安装包，解压后配置环境变量。在Linux系统中，编辑 /etc/profile 文件，添加Maven的 bin 目录到 PATH 变量，例如

 export PATH=$PATH:/opt/apache-maven-3.8.6/bin

（假设Maven解压到 /opt/apache-maven-3.8.6 目录），保存后执行 source /etc/profile 使配置生效，通过 mvn -version 验证安装。
Git：用于获取kkFileView的源代码。在Linux系统中，使用包管理工具安装，如CentOS中执行 yum install git ，Ubuntu中执行 apt-get install git 。

二、获取kkFileView源代码

打开终端，使用Git命令克隆kkFileView项目到本地指定目录，例如 /home/kkfileview ：

git clone https://github.com/kekingcn/kkFileView.git /home/kkfileview

克隆完成后，进入项目目录：

cd /home/kkfileview

三、项目构建

在kkFileView项目目录下，执行Maven构建命令，将项目打包成可执行的JAR文件：

mvn clean install -DskipTests

clean 命令用于清理项目之前的构建结果， install 命令将项目打包并安装到本地Maven仓库， -DskipTests 选项用于跳过测试阶段，加快构建速度。构建过程中，Maven会自动下载项目所需的各种依赖包，可能需要一些时间，请耐心等待。若构建过程出现错误，根据错误提示检查网络连接、依赖配置等问题。

四、配置文件调整

构建完成后，进入 src/main/resources 目录，找到 application.properties 文件，此文件包含了kkFileView的核心配置参数：

端口配置：默认情况下，kkFileView使用8012端口，若该端口已被占用，可修改 server.port 参数指定其他端口，如：

server.port=8081

文件存储路径配置：配置 file.upload.path 参数指定文件上传和缓存的存储路径，建议设置为空间充足且有读写权限的目录，如：

file.upload.path=/data/kkfileview/upload

提前创建好该目录，并赋予运行kkFileView服务的用户读写权限，如在Linux中执行 mkdir -p /data/kkfileview/upload && chmod -R 777 /data/kkfileview/upload 。

数据库配置：kkFileView默认使用H2内存数据库，适合测试和小型应用场景。若用于生产环境或对数据持久化有需求，可切换为MySQL等关系型数据库。以MySQL为例，先在MySQL中创建一个新的数据库，然后修改 application.properties 中的数据库连接配置：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/kkfileview?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=yourpassword

同时，确保MySQL的JDBC驱动已添加到项目依赖中，若使用Maven管理依赖，在 pom.xml 文件中添加MySQL驱动依赖：

mysql mysql-connector-java

修改完配置后，重新执行Maven构建，使配置生效。

五、启动服务

构建和配置完成后，在项目的 target 目录下找到生成的 kkFileView-xxx.jar 文件，使用以下命令启动服务：

java -jar kkFileView-xxx.jar

启动过程中，终端会输出启动日志信息。若启动成功，会看到类似 Started KkFileViewApplication in xxx seconds 的提示。此时，在浏览器中输入 http://服务器IP:端口号（如 http://192.168.1.100:8081 ），即可访问kkFileView的登录页面，默认用户名和密码均为 admin 。

六、常见问题及解决

启动失败，提示端口占用：使用 netstat -tlnp | grep 端口号命令查看占用指定端口的进程，然后通过 kill -9 进程ID 命令杀死该进程，再重新启动kkFileView。
文件预览异常：确保文件存储路径配置正确且有读写权限；检查文件格式是否在kkFileView支持的预览范围内，若不支持，可考虑安装对应的文件转换工具或插件来扩展支持格式。
依赖下载失败：检查网络连接是否正常；若因网络问题导致依赖下载中断，可尝试多次执行构建命令，或手动在Maven仓库中下载缺失的依赖包，放入本地Maven仓库对应的目录中。
在内网环境使用的时候要记得下载相关office组件，才能正常使用

wget https://kkfileview.keking.cn/LibreOffice_7.1.4_Linux_x86-64_rpm.tar.gz
tar -zxvf LibreOffice_7.1.4_Linux_x86-64_rpm.tar.gz
cd LibreOffice_7.1.4.2_Linux_x86-64_rpm/RPMS
yum install -y *.rpm