夜雨聆风学习资料网

ARTICLE · 1379134

【程序源代码】文件在线预览平台

【程序源代码】文件在线预览平台
关键字:玄箧,文件预览,文档预览,SpringBoot3,Vue3,MinIO,Redis,office预览,CAD预览

项目名称

玄箧文件在线预览平台(wwf‑xuanqie‑preview)

项目介绍(宋体12.75)

玄箧是对标kkFileView的轻量级文档在线预览平台,项目寓意玄铁宝箧,百宝所藏,开合有度,实现各类文档免插件直接浏览器预览。基于SpringBoot3+Vue3开发,集成MinIO对象存储、Redis异步转换队列、水印溯源能力,支持Office、PDF、图片、音视频、压缩包、CAD等上百种文件格式预览。当前处于早期开发阶段,已完成项目骨架,使用内存存储示例接口,尚未接入数据库,适合学习文件预览服务架构,可用于业务系统集成文档预览能力。

项目结构目录

wwf‑xuanqie‑preview 项目根目录
├─ backend/                 SpringBoot3后端服务
├─ frontend/                 Vue3前端管理界面
├─ docs/donate/             打赏相关文档资源
├─ .gitignore               git忽略配置
├─ LICENSE                  MIT开源协议
└─ README.md                项目说明文档

3 项目主要技术框架

3.1核心底层框架

前后端分离架构,后端SpringBoot3提供文件转换、预览接口,Redis实现异步文件转换任务队列,对接MinIO对象存储实现文件读写;Vue3实现前端操作页面。项目现阶段为内存存储,暂未接入持久化数据库,可扩展水印溯源、文件权限控制等能力。

3.2后端技术栈

开发语言:Java 核心框架:SpringBoot 3 中间件:Redis(异步转换队列) 对象存储:MinIO 端口:8103

3.3前端技术栈

开发语言:JavaScript、Vue3 端口:5103 前端代理配置,/api代理转发到后端服务

3.4数据库

项目当前版本尚未接入数据库,示例数据使用内存存储;后续迭代可扩展MySQL用于存储文件记录、访问日志、权限配置等业务数据。

3.5开发及生产环境

开发环境:JDK17,Maven,Node.js,Redis,MinIO 开源协议:MIT 仓库地址:https://gitee.com/wang‑wen‑feng/wwf‑xuanqie‑preview

4 项目主要功能

4.1文件预览模块

4.1.1多格式预览

支持Office文档、PDF、图片、音视频、压缩包、CAD上百种格式浏览器免插件预览。

4.1.2对象存储对接

对接MinIO对象存储,读取存储桶内文件进行预览转换。

4.2任务队列模块

4.2.1异步转换队列

基于Redis实现文件异步转换任务队列,大文件后台处理转换。

4.3安全扩展模块(规划)

4.3.1水印溯源

预览文档添加溯源水印,保护文档资料安全。

4.4通用功能模块

4.4.1健康检查接口

/api/health 后端服务健康检测接口。

注意:当前为骨架版本,部分能力为规划设计,部分功能待后续迭代开发。

5 项目安装和部署

5.1前置环境准备

JDK17,Maven,Node.js,Redis服务,MinIO对象存储服务。

5.2源码本地运行

克隆项目源码
git clone 
cd wwf-xuanqie-preview
启动后端服务
cd backend
mvn spring-boot:run
后端端口8103。
启动前端服务
cd frontend
npm install
npm run dev
前端端口5103。
浏览器访问http://localhost:5103健康检查接口访问http://localhost:5103/api/health

5.3首次运行配置

  1. 配置Redis连接参数,配置MinIO对象存储连接信息。
  2. 启动前后端,测试健康接口确认服务连通。
  3. 上传文件测试预览功能。

重要提示:项目处于早期骨架版本,内存存储,重启服务数据丢失,还未接入数据库。

5.4常见故障排查

  1. 前端访问报接口异常:确认后端服务正常运行,检查前端api代理配置。
  2. Redis连接失败:核对Redis地址、端口、密码配置。
  3. MinIO读取文件失败:检查bucket桶权限、账号密钥配置。

系统实际效果图片展示

仓库暂无截图,运行后可查看文件上传页面、文件预览页面。

源码适合的学习人群

1.Java后端开发者,学习文件在线预览、异步任务队列、对象存储集成方案。 
2.需要给业务系统增加文档预览能力的开发人员,可基于本项目骨架二次开发。 
3.计算机专业学生,文件处理类课程设计、毕业设计参考。

项目源码获取方式

关注公众号,回复:70005

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料