kkFileView文档在线预览方案及Nginx代理方式访问

目录

介绍

一、部署

二、配置

1. 修改端口

2. 修改文件存储路径

3. 修改缓存类型

4. 配置预览方式为纯文本的文件类型

5. 配置预览方式为多媒体（视频、音频）的文件类型

6. 配置 office 文件（doc、docx、ppt、pptx）、pdf 文件预览方式

7. 关闭 office 预览页面上的切换开关

8. 禁止下载转换后的pdf

9. 禁用首页的文件上传

10. 水印相关配置

三、使用

1. 在新窗口中打开文件预览

2. iframe内嵌方式预览

3. 预览模式切换

四、通过 nginx 代理方式访问

---

介绍

kkFileView是一款基于Spring Boot的开源免费在线文件文档预览工具，支持多种办公文档和非办公文件格式的在线预览。

一、部署

1. 从官网下载最新版发行包。

2. 解压 kkFileView-x.x.x 文件（Windows用.zip包，Linux/MacOS用.tar.gz包）。

3. 打开解压后文件夹的bin目录，运行startup脚本（Windows下以管理员身份运行startup.bat，Linux以root用户运行startup.sh）。

4. 浏览器访问本机 8012 端口 http://127.0.0.1:8012 即可看到项目演示用首页。

二、配置

打开 config 目录，下面有一个 application.properties 配置文件，有部分配置是可以在程序运行中变更的，其他的变更需要重新启动程序。这里只介绍下其中比较重要的几个配置项，完整的配置项请参考官方的文档说明。

1. 修改端口

# 默认配置
server.port = ${KK_SERVER_PORT:8012}# 修改后配置
server.port = ${KK_SERVER_PORT:8013}

2. 修改文件存储路径

文件资源存储路径，默认为打包根路径下的file目录。

# 默认配置
file.dir = ${KK_FILE_DIR:default}# 修改后配置
file.dir = D:/kkFileview

注意：存储路径中不要有中文，否则会出现乱码问题。

3. 修改缓存类型

# 默认配置
cache.type =  ${KK_CACHE_TYPE:jdk}

可选的缓存类型如下：default：默认实现，使用RocksDB存储引擎，使用磁盘存储，会占用少量磁盘空间；Windows下需要使用管理员身份启动程序jdk：java 对象实现，使用纯内存对象存储，速度极快，外部依赖最少，调试部署方便，会占用内存，推荐调试时和预览文件量不是很大时（<50万）使用，预览文件量极大或有大量压缩包时不推荐使用redis: redis 作为缓存实现，速度快，不占用内存和磁盘空间，但是需要有外部redis服务支撑。当配置为redis实现时，需要同时配置 redis 连接相关配置，如下：spring.redisson.address = 127.0.0.1:6379spring.redisson.password = xxxxxx

4. 配置预览方式为纯文本的文件类型

# 默认配置
simText = ${KK_SIMTEXT:txt,html,htm,asp,jsp,xml,json,properties,md,gitignore,log,java,py,c,cpp,sql,sh,bat,m,bas,prg,cmd}