Boot+Cloud项目学习:macrozheng.com
文件存储是项目中常见的功能,我们可以用MinIO来实现文件存储。但是有时候不仅要实现存储,还要实现文件的在线预览,此时就可以用万能文件预览工具kkFileView来实现。今天给大家分享下SpringBoot + MinIO + kkFileView如何实现任意文件的在线预览功能。
kkFileView简介
kkFileView是一个万能的在线预览开源项目,基于SpringBoot实现,目前在Gitee上已有21k+Star
。它易于上手和部署,支持几乎所有常见类型文件的在线预览。
下面是它目前支持的文件类型,文件类型目前还在进一步丰富中:
安装
使用Docker来安装MinIO和kkFileView是非常方便的,这里我们将采用此种方式。
MinIO
- 首先使用如下命令下载MinIO的Docker镜像;
docker pull minio/minio
- 然后通过如下命令运行MinIO的容器,此时MinIO的可视化控制台运行在
9001
端口上,MinIO服务将运行在9090
端口上;
docker run -p 9090:9000 -p 9001:9001 --name minio \
-v /mydata/minio/data:/data \
-e MINIO_ROOT_USER=minioadmin \
-e MINIO_ROOT_PASSWORD=minioadmin \
-d minio/minio server /data --console-address ":9001"
- 然后我们输入默认账号密码
minioadmin:minioadmin
就可以访问MinIO的控制台了,控制台访问地址:http://192.168.3.101:9001
kkFileView
- 使用如下命令下载kkFileView的Docker镜像;
docker pull keking/kkfileview
- 然后通过如下命令运行MinIO的容器,此时容器运行在
8012
端口上;
docker run -p 8012:8012 --name kkfileview \
-d keking/kkfileview
- 接下来我们就可以访问kkFileView的测试页,访问地址:http://192.168.3.101:8012
使用
接下来我们来讲解下MinIO和kkFileView的使用。
准备
- 首先我们需要在MinIO中创建一个存储桶
preview
;
- 然后修改存储桶的访问策略为
Pulbic
以便外部访问;
- 之后我们就可以往存储桶中上传文件了,上传好测试的文件;
- 至于这些文件如何访问呢,由于我们的MinIO服务运行在
9090
端口上,可以通过如下格式获取到文件地址;
http://192.168.3.101:9090/{bucketName}/{fileName}
- 例如我们在存储桶
preview
中存储了一个叫avatar.png
的文件,访问地址就是这样的:http://192.168.3.101:9090/preview/avatar.png
文件预览
接下来我们来讲解下如何通过kkFileView来预览MinIO中的文件。
图片
- 我们需要先打开kkFileView的预览测试页,输入文件名称后就可以获取到预览链接了:http://192.168.3.101:8012
- 我们可以发现kkFileView的文件预览格式是这样的,通过base64编码后拼接了一个url参数;
http://192.168.3.101:8012/onlinePreview?url=base64Encode($url)
word
接下来我们再来看下打开word文档的效果:
pdf
再来看下打开pdf文档的效果:
ppt
再来看下打开ppt文档的效果:
markdown
再来看下打开markdown文档的效果:
excel
再来看下打开excel文档的效果:
压缩文件
再来看下打开压缩文件的效果,对于压缩文件支持直接打开预览内部文件。
总结
今天带大家通过SpringBoot + MinIO + kkFileView实现了任意文件的在线预览功能,不用写一行代码就能实现,大家如果在项目中遇到这类需求的话可以尝试下。
项目地址
https://gitee.com/kekingcn/file-online-preview
Github上标星11K
的微服务实战项目mall-swarm,全套 视频教程(2024最新版) 来了!全套教程约26小时,共59期
,如果你想学习目前最新的微服务技术栈
,同时提高自己微服务项目的开发能力
的话,不妨了解下,下面是项目的整体架构图,感兴趣的小伙伴可以点击链接 mall-swarm视频教程 加入学习。
整套 视频教程 的内容还是非常完善的,涵盖Spring Cloud核心组件、微服务项目实战、Kubernetes容器化部署等内容,你也可以点击链接 mall-swarm视频教程 了解更多内容。
推荐阅读