夜雨聆风
打造企业级在线文档协作系统:OnlyOffice + MinIO 完整实践
🔐👁️🔐一套完整的前后端分离架构，支持多人实时编辑、自动保存、JWT安全认证，轻松搭建属于自己的在线Office。
📝 写在前面
在数字化办公时代，在线文档协作已经成为刚需。无论是团队知识库、项目文档，还是日常办公表格，能够随时随地预览、编辑并与同事协同，能极大提升工作效率。
今天，我将带你深入剖析一个基于 OnlyOffice Document Server + MinIO 对象存储 的在线文档协作系统。项目采用 Vue3 + Spring Boot 前后端分离架构，实现了文档上传、在线预览/编辑、自动保存、文件管理等一系列功能，并且通过 JWT 令牌保证了回调接口的安全性。
无论你是想快速搭建一套私有化的文档协作平台，还是希望学习 OnlyOffice 与 MinIO 的集成方式，这篇文章都能给你一个清晰的指引。
一、项目概述
1.1 项目简介
这是一个基于 OnlyOffice Document Server 和 MinIO 对象存储 的在线文档协作系统。用户可以通过 Web 界面上传、预览、编辑 Office 文档（Word、Excel、PowerPoint 等），所有文档存储在 MinIO 中，通过 OnlyOffice 实现在线协作编辑功能。
1.2 核心功能
📤 文件上传：支持拖拽上传多种格式的 Office 文档
👁️ 在线预览：在浏览器中直接预览文档内容
✏️ 在线编辑：支持多人协作编辑文档
💾 自动保存：编辑完成后自动保存回 MinIO
🗑️ 文件管理：支持文件列表查看、搜索、删除等操作
🔐 JWT 安全认证：使用 JWT 令牌保护 OnlyOffice 回调安全
1.3 技术架构
二、技术栈详解
2.1 后端技术栈（Spring Boot）
2.2 前端技术栈（Vue 3）
2.3 第三方服务
三、项目结构
四、核心业务逻辑
4.1 系统架构图
4.2 核心业务流程
4.2.1 文件上传流程
关键代码位置：
-
前端：FileManager.vue 上传对话框 -
后端：OnlyOfficeService.uploadFile() -
MinIO 操作：MinioService.uploadFile()
4.2.2 文档预览/编辑流程
4.2.3 文档保存流程（回调机制）
4.2.4 文件下载代理流程
五、核心配置说明
5.1 后端配置（application.yml）
5.2 前端配置（vite.config.js）
5.3 OnlyOffice 编辑器配置（前端）
七、JWT 安全机制
7.1 为什么需要 JWT？
7.2 JWT 生成流程
7.3 JWT 验证流程
7.4 注意事项
⚠️ 重要： 后端的 jwt-secret 必须与 OnlyOffice Document Server 中的 jwt.secret 配置完全一致！
八、OnlyOffice 文档状态码
九、部署说明
9.1 环境要求
-
- Node.js: 16.0+
- Java: 17+
- Docker: 用于部署 OnlyOffice 和 MinIO
9.2 Docker 部署服务
9.3 后端部署
9.4 前端部署
十一、扩展建议
11.1 功能扩展
✅ 添加用户认证系统
✅ 实现文档版本管理
✅ 支持更多文件格式
✅ 添加文档分享功能
✅ 实现协作评论功能
11.2 性能优化
使用 CDN 加速 OnlyOffice 静态资源
MinIO 配置分布式集群
后端增加 Redis 缓存
文件分片上传
11.3 安全加固
启用 HTTPS
添加 API 访问鉴权
实现文件类型白名单
增加上传频率限制
十二、总结
本项目通过集成 OnlyOffice Document Server 和 MinIO，实现了一个完整的在线文档协作系统。核心优势包括：
✅ 前后端分离：Vue3 + Spring Boot 架构清晰
✅ 安全可控：JWT 令牌保护通信安全
✅ 高可用性：MinIO 提供可靠的对象存储
✅ 易于扩展：模块化设计便于功能扩展
理解本项目的关键在于掌握三条主线：
文件流：上传 → MinIO 存储 → 代理下载 → 保存回 MinIO
JWT 流：生成 Token → 前端传递给 OnlyOffice → 回调时验证
配置流：后端构建配置 → 前端请求配置 → OnlyOffice 使用配置
希望这篇文章能帮助你快速理解项目架构和业务逻辑，也欢迎你在评论区留言交流，共同探讨在线文档协作的更多可能性！
本文档基于开源项目整理，如果你觉得有帮助，欢迎分享给更多小伙伴。如需获取完整源码，请关注公众号回复“onlyoffice”获取。