ARTICLE · 1379134
【程序源代码】文件在线预览平台
【程序源代码】文件在线预览平台关键字:玄箧,文件预览,文档预览,SpringBoot3,Vue3,MinIO,Redis,office预览,CAD预览 玄箧文件在线预览平台(wwf‑xuanqie‑preview) 玄箧是对标kkFileView的轻量级文档在线预览平台,项目寓意玄铁宝箧,百宝所藏,开合有度,实现各类文档免插件直接浏览器预览。基于SpringBoot3+Vue3开发,集成MinIO对象存储、Redis异步转换队列、水印溯源能力,支持Office、PDF、图片、音视频、压缩包、CAD等上百种文件格式预览。当前处于早期开发阶段,已完成项目骨架,使用内存存储示例接口,尚未接入数据库,适合学习文件预览服务架构,可用于业务系统集成文档预览能力。 wwf‑xuanqie‑preview 项目根目录 ├─ backend/ SpringBoot3后端服务 ├─ frontend/ Vue3前端管理界面 ├─ docs/donate/ 打赏相关文档资源 ├─ .gitignore git忽略配置 ├─ LICENSE MIT开源协议 └─ README.md 项目说明文档 
前后端分离架构,后端SpringBoot3提供文件转换、预览接口,Redis实现异步文件转换任务队列,对接MinIO对象存储实现文件读写;Vue3实现前端操作页面。项目现阶段为内存存储,暂未接入持久化数据库,可扩展水印溯源、文件权限控制等能力。 开发语言:Java 核心框架:SpringBoot 3 中间件:Redis(异步转换队列) 对象存储:MinIO 端口:8103 开发语言:JavaScript、Vue3 端口:5103 前端代理配置,/api代理转发到后端服务 项目当前版本尚未接入数据库,示例数据使用内存存储;后续迭代可扩展MySQL用于存储文件记录、访问日志、权限配置等业务数据。 开发环境:JDK17,Maven,Node.js,Redis,MinIO 开源协议:MIT 仓库地址:https://gitee.com/wang‑wen‑feng/wwf‑xuanqie‑preview 支持Office文档、PDF、图片、音视频、压缩包、CAD上百种格式浏览器免插件预览。 对接MinIO对象存储,读取存储桶内文件进行预览转换。 基于Redis实现文件异步转换任务队列,大文件后台处理转换。 预览文档添加溯源水印,保护文档资料安全。 /api/health 后端服务健康检测接口。 JDK17,Maven,Node.js,Redis服务,MinIO对象存储服务。 克隆项目源码 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 1.Java后端开发者,学习文件在线预览、异步任务队列、对象存储集成方案。 2.需要给业务系统增加文档预览能力的开发人员,可基于本项目骨架二次开发。 3.计算机专业学生,文件处理类课程设计、毕业设计参考。 关注公众号,回复:70005
项目名称
项目介绍(宋体12.75)
项目结构目录

3 项目主要技术框架
3.1核心底层框架
3.2后端技术栈
3.3前端技术栈
3.4数据库
3.5开发及生产环境
4 项目主要功能
4.1文件预览模块
4.1.1多格式预览
4.1.2对象存储对接
4.2任务队列模块
4.2.1异步转换队列
4.3安全扩展模块(规划)
4.3.1水印溯源
4.4通用功能模块
4.4.1健康检查接口
注意:当前为骨架版本,部分能力为规划设计,部分功能待后续迭代开发。
5 项目安装和部署
5.1前置环境准备
5.2源码本地运行
5.3首次运行配置
配置Redis连接参数,配置MinIO对象存储连接信息。 启动前后端,测试健康接口确认服务连通。 上传文件测试预览功能。
重要提示:项目处于早期骨架版本,内存存储,重启服务数据丢失,还未接入数据库。
5.4常见故障排查
前端访问报接口异常:确认后端服务正常运行,检查前端api代理配置。 Redis连接失败:核对Redis地址、端口、密码配置。 MinIO读取文件失败:检查bucket桶权限、账号密钥配置。
系统实际效果图片展示
仓库暂无截图,运行后可查看文件上传页面、文件预览页面。















































































