ARTICLE · 1158996
开源网页版Office最佳方案OnlyOffice
开源网页版Office最佳方案OnlyOffice日常办公中,微软 Office、金山 WPS 桌面文档早已深入人心。但当文档能力需要集成到 Web 业务平台时,我们期待拥有和桌面端一致的可视化、所见即所得编辑体验,修改后的文档可完整原样保存;同时支持编辑器与业务系统打通,比如直接在 Word、PPT 编辑页面,从学科题库挑选填空、选择、计算类习题,一键插入文档。 若希望免去商用 Office 服务采购成本,在综合评估多款开源在线 Office 组件后,OnlyOffice 是值得优先选用的方案。本文尽量通俗易读的给大家整体介绍如何引进OnlyOffice到你的业务系统中。若有疑问,可以直接联系本作者。 正式介绍前,让大家提前感受下网页版Office集成其它系统的魅力: 


ONLYOFFICE 由拉脱维亚 Ascensio System SIA 开发,ONLYOFFICE Docs 是核心在线文档服务组件(不是桌面端),AGPL v3 开源协议(社区版),支持 Docker 一键容器化部署,可嵌入自有业务系统(OA、教育平台、网盘),提供 Word/Excel/PPT/PDF/ 表单网页在线预览 + 编辑 + 多人实时协同ONLYOFFICE。 社区版 Community:AGPLv3 开源免费,功能无阉割;商用场景必须开源衍生代码(AGPL 协议强传染性,是项目最大坑);无原厂商业支持,适合测试、小内网项目。 企业版 Enterprise:商业闭源许可证,解除 AGPL 约束;按并发连接数授权,提供原厂 SLA、安全补丁、技术支持;适合政务、教育商用项目。 国内二次增强版(摩奇 MoqiSoft):基于原版 ONLYOFFICE 深度定制商用版本,原生增强 PPT 内嵌视频播放,修复原版 PPT 动画 / 课件兼容性问题,国内教育项目大量使用,规避原生插件开发踩坑。 ✅ 原生支持 docx/xlsx/pptx OOXML 格式,排版保真度在开源自托管方案里第一梯队; ✅ 原生实时协同(段落级锁定协同)、版本历史、修订追踪、评论批注; ✅ 完整插件扩展 API:自定义按钮、面板、JS 插件,你之前开发课件视频插件就是基于这套机制; ✅ 部署方式:Docker 容器、Linux 二进制,支持 JWT 鉴权、回调接口,方便和 Java/Python 后端集成; ✅ PDF 编辑、表单、图表、宏;可对接 Ollama 等本地大模型插件; ❌原版社区 / 企业版 PPT 原生不支持内嵌本地视频播放:仅支持在线 URL 视频插件,PPT 内嵌入本地 mp4 课件无法播放;这也是摩奇定制版的核心卖点; ❌ AGPL 协议风险:社区版一旦二次开发插件、嵌入业务系统对外提供服务,整套代码强制开源,商用项目必须避开; ❌ 容器部署坑:Docker 挂载卷、插件目录权限、实例水平扩容时插件加载一致性问题(就是你遇到的:旧实例插件正常,新起容器插件不加载); ❌ 复杂 PPT 动画、母版、复杂形状,偶尔渲染偏移; ❌ 资源消耗偏高,并发量大时 CPU 内存压力高于 Collabora。

【1】首先docker安装最新版OnlyOffice服务,并记录域名服务URL; 【2】业务端集成OnlyOffice时需要嵌入到iframe层,独立页面开发; 【3】网页端可视化编辑后,保存时需要调用业务系统提供的文件保存推流的回调接口; 【4】如上面实例所示,如果想在Office内集成其它业务系统服务,需要单独做扩展插件服务,在插件内调用业务系统服务展示。记住一点,插件开发好测试没问题时,需要再部署到OnlyOffice的服务容器内,再重启下容器。
1.背景



2. 基本介绍
2.1 版本划分
2.2 核心能力
2.3 原生短板(重点,教育课件场景)
3. 和其它组件的全访问对比
4. OnlyOffice插件开发基本流程
4.1 使用整体流程
