OnlyOffice 基础使用引导

2,493 阅读2分钟

基础介绍

OnlyOffice 一款具有 协作能力 的办公套件,支持 Word、PowerPoint、PDF、Markdown 等文件类型,近似于 Microsoft Office

不仅提供了 桌面、移动端应用,还支持 集成/内嵌 到 第三方系统 内部(内嵌示例

版本区别

OnlyOffice 含有 社区版企业版开发者版;又因功能侧重不同,可再细分为 文档版协作空间版(下文基于 文档版 展开)

借助 版本对比信息,三大版本的主要区别在于:

  • 社区版 免费,但存在如下限制:
    • 同时连接:≤20
    • 文件体积:≤100MB
    • 不支持 移动端Web编辑器
    • 第三方系统,需以相同的GPL许可 开源 发布
  • 开发者版 支持 白标服务、自动化API(需额外付费)


👆 上方提及的 同时连接、白标服务 具体指的是什么?

  • 同时连接:

    同一服务下,文档打开的数量;达到限定值后,所有文档将以 只读模式 打开。

    注意:由两个用户打开的同一个文档是两个同时连接

  • 白标服务:

    允许用于隐藏菜单面板、加载文档时删除 logo 和名称等

⭐ 其余问题,可见 常见问题解答

相关操作

后端服务

自托管的 OnlyOffice,类似于一个 中间商,主要负责 文件渲染文件编辑 工作;而 文件管理,是其所不具备的(切勿被 https://documentserver/exapmles 示例内容误导)

借助 Docker镜像,便能快速安装 OnlyOffice

而 文档管理 功能,OnlyOffice官方提供了相关 示例,基于此进行二次开发即可

推荐查看B站教学视频 - Web中实现OfficeOnlyOffice搭建过程,加深理解

前端操作

相较于后端,前端的工作则较为简单

总结起来就4步:设置OnlyOffice容器 -> 引入API -> 请求获取配置项 -> 创建编辑器

// 创建容器
<div id="only-office"></div>

// 引入API(【https://documentserver】调整为 Dockers部署地址)
<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js"></script>

// 获取配置项
const config = xxx

// 创建编辑器
const docEditor = new DocsAPI.DocEditor("only-office", config)

详见官方文档 安装 - 自托管

优缺点

优点

相较于国内的 文档编辑器集成服务(WPS WebOffice、腾讯文档、石墨文档),不仅提供了 免费使用 的社区版,还拥有 支持买断 的企业版、开发者版

缺点

因主要服务均依托于 服务器,若服务配置性能不足,可能出现 加载缓慢 的问题

直达链接