spring.redisson.address = 127.0.0.1:6379spring.redisson.password = xxxxxxcache.clean

解释:是否须要自动定时清理缓存及预览过的文件,默认开启(如果不清理缓存,同一个url下如果文件发生变更是不会重新拉取新的文件再去预览的),开启的情形下会在每天凌晨3点清理所有缓存及预览文件,推举预览量不大,对预览速率哀求不高,且同一url下文件常常更新的用户开启,预览量大、预览速率哀求高的用户不推举开启

true: 默认值,开启false: 不开启空:注释掉,不开启可在运行时动态改变部分base.url

解释:供应预览做事的地址,默认从吸收要求url读,如果利用nginx等反向代理,须要手动设置为通过nginx访问预览做事的地址默认值:未设置示例:base.url = https://file.keking.cn/preview例如nginx的访问地址为 https://file.keking.cn 想要利用 https://file.keking.cn/preview/来做预览,kkFileView支配在内网192.168.1.233做事器上,须要在nginx中添加反向代理如下

location /preview { proxy_pass 192.168.1.233:8012;}

修正kkFileView的配置文件如下两项

jsp页面加载json在线文档预览kkFileView安排及应用指南 Node.js

server.context-path = /previewbase.url = https://file.keking.cn/preview

利用如下地址来访问预览页面

var url = 'https://file.keking.cn/file/test.txt'; //要预览文件的访问地址window.open('https://file.keking.cn/preview/onlinePreview?url='+encodeURIComponent(url));trust.host

解释:信赖站点,设置了之后,会限定只能预览来自傲任站点列表的文件,默认不限定,多个用','隔开, 默认值:未设置 示例:trust.host = file.keking.cn,kkfileview.keking.cn

simText

解释:用来配置预览办法为纯文本的文件类型默认值:txt,html,htm,asp,jsp,xml,json,properties,md,gitignore,log,java,py,c,cpp,sql,sh,bat,m,bas,prg,cmd

media

解释:用来配置预览办法为多媒体(视频、音频)的文件类型默认值:mp3,wav,mp4,flv

office.preview.type

解释:office文件(doc、docx、ppt、pptx)、pdf 文件预览办法,默认为图片办法,预览时也有按钮相互切换,可选项:'image', 'pdf'

image: 默认预览办法,将office文件每一页后台转成图片,前台pdf.download.disable

解释:是否禁止下载转换天生的pdf文件,默认禁止默认值:true

file.upload.disable

解释:是否禁用演示首页文件上传,默认不禁止默认值:false

ftp.username

解释:预览url为FTP地址时,默认的ftp用户名,可过url参数中的ftp.username=xxx覆盖,即优先利用url参数中的,如果url参数中没有,则取本配置的默认值:null

ftp.password

解释:预览url为FTP地址时,默认的ftp密码,可过url参数中的ftp.password=xxx覆盖,即优先利用url参数中的,如果url参数中没有,则取本配置的默认值:null

ftp.control.encoding

解释:预览源为FTP时, FTP连接默认的ControlEncoding,根据FTP做事器的操作系统选择,Linux一样平常为设置UTF-8,Windows一样平常为设置GBK。
可过url参数中的ftp.control.encoding=xxx覆盖,即优先利用url参数中的,如果url参数中没有,则取本配置的默认值:UTF-8

watermark.txt

默认水印内容,如需取消水印,内容设置为空即可,例如:watermark.txt = ${WATERMARK_TXT:}默认值:''

watermark.x.space

水印x轴间隔默认值:10

watermark.y.space

水印y轴间隔默认值:10

watermark.font

水印字体默认值:微软雅黑

watermark.fontsize

水印字体大小默认值:18px

watermark.color

水印字体颜色默认值:black

watermark.alpha

水印透明度,哀求设置在大于即是0.005,小于1默认值:0.2

watermark.width

水印宽度默认值:180

watermark.height

水印高度 默认值:80

watermark.angle

水印倾斜度数,哀求设置在大于即是0,小于90默认值:10

常见问题Q:怎么把这个项目集成到我的项目里

A:不须要集成,本项目只须要独立支配,向外供应http预览做事(外部系统只须要访问本项目预览接口并传入须要预览文件的url,就可以打开预览页面)

Q:怎么把这个项目放Tomcat里运行

A:不须要放进Tomcat里,编译好的发行包为zip包,直接解压运行一键启动脚本就可以完成支配(须要有java环境)详细支配步骤详见:支配指南

Q:预览并发问题&预览首次打开慢

A:可利用预览转码行列步队,将须要预览的文件url放入行列步队中,提提高行转码,本地访问接口为:http://127.0.0.1:8012/addTask?url=http://xxx/test.txt (url参数为须要须要的文件访问地址)

Q:预览乱码

A:乱码问题可能有如下两个缘故原由

字体问题大部分Linux系统上并没有预装中笔墨体或字体不全,须要把常用字体拷贝到Linux做事器上,详细操作如下: 下载如下字体包 http://kkfileview.keking.cn/fonts.zip 文件解压完全拷贝到Linux下的 /usr/share/fonts目录。
然后依次实行mkfontscale 、mkfontdir 、fc-cache使字体生效编码问题

编码问题分为如下两方面

Excel文件编码格式 Excel软件是可以选择用什么编码去保存文件的目前我们读取Eecel文件是用的做事器操作系统默认编码,可以通过在启动脚本里加入如-Dfile.encoding=UTF-8指定,详见 码云项目首页评论区谈论天生html网页编码格式天生html网页也是用的做事器操作系统默认编码(java系统属性:sun.jnu.encoding),比如用浏览器用手动变动编码格式为utf-8或gbk打开没有问题,但是用浏览器默认编码就有问题,此时可调度系统配置文件中的配置项converted.file.charset可办理此类乱码问题, 详见 编码配置Q:Linux下运行startup.sh脚本报错:/bin/bash^M: bad interpreter: No such file or directory

A:一样平常为在Windows下用IDEA导入项目编译时,默认利用Windows(\r\n)下的文件换行符导致的,导入项目时设置默认换行符为Unix类操作系统换行符再编译即可(File->Settings->Editor->Code Style->Line separator 选择Unix and MacOs(\n))

Q:Linux下启动项目后日志报错:org.artofsolving.jodconverter.office.OfficeException: office process died with exit code 127

A:操作系统短缺libXext.so.6包,请自行下载安装:http://kkfileview.keking.cn/fonts.zip

Q:启动项目后日志报错:java.lang.IllegalStateException: a process with acceptString 'socket,host=127.0.0.1,port=8100' is already running; pid 26468

A:有正在运行的openoffice进程,kill掉干系进程再重新启动

Q:Windows系统下启动报错:Error creating bean with name 'cacheServiceRocksDBImpl'

A:本项目默认利用内嵌RocksDB存储引擎作缓存,须要以管理员身份运行,或配置利用其他缓存实现,详见:缓存配置

Q:如何水印文本内容动态传值

A:在预览url后面加上参数&watermarkTxt即可例如:

var url = 'http://127.0.0.1:8080/file/test.txt'; //要预览文件的访问地址window.open('http://127.0.0.1:8012/onlinePreview?url=' + encodeURIComponent(url) + '&watermarkTxt=' + encodeURIComponent('动态水印'));Q:利用nginx代理时预览涌现非常

A:一样平常是nginx和kkFileView配置有问题例如nginx的访问地址为 https://file.keking.cn 想要利用 https://file.keking.cn/preview/来做预览,kkFileView支配在内网192.168.1.233做事器上,须要在nginx中添加反向代理如下:

location /preview { proxy_pass 192.168.1.233:8012;}

修正kkFileView的配置文件如下两项

server.context-path = /previewbase.url = https://file.keking.cn/preview

利用如下地址来访问预览页面

var url = 'https://file.keking.cn/file/test.txt'; //要预览文件的访问地址window.open('https://file.keking.cn/preview/onlinePreview?url='+encodeURIComponent(url));Q:利用docker支配时如何指定配置文件中的配置项

A:针对docker运行的用户,所有配置项可以利用设置相应的环境变量来配置环境变量的KEY为配置文件中每个配置项后${}中的KEY例如,利用docker运行要指定base.url为http://file.keking.cn,docker运行命令如下

docker run -it -d -p 8012:8012 -e BASE_URL="http://file.keking.cn" keking/kkfileview:v2.2.1Q:利用内网预览时没有问题,但是利用外网预览有问题

A:一样平常是公司网络利用的路由器不支持或没开启域内NAT,kkFileView无法通过外网地址下载要预览的文件例如kkFileView支配在公司192.168.1.233做事器上,本地访问http://192.168.1.233:8012可以正常预览公司运维把192.168.1.233的8012端口暴露到公网ip或域名(http://xxx.xxx.xxx:8012),公网打首页也正常,但是预览就出错这种一样平常是由于公司主路由器不支持或没开启域内NAT

预览展示文本预览

word文档预览

ppt文档预览

excel文档预览

压缩文件预览

多媒体文件预览

CAD文档预览