文章目录
文章目录
本文目录
本文目录

文档中台私有部署和 ONLYOFFICE:在线编辑 SDK 怎么选

石墨办公 + AI

ONLYOFFICE 给的是编辑器与转换服务,文档管理与存储归你;文档中台私有部署按并发授权,把预览、协作、权限复用与事件回调一起交付。按能力归属、接入方式、权限与计费四组维度对照 ONLYOFFICE,另附判断表与 PoC 验收清单。

结论先说:要买“一个能嵌进页面的编辑器”,ONLYOFFICE 这类组件够用且边界清楚;要买“文件打开以后的全套能力”,就该按石墨办公文档中台私有部署(Shimo Office SDK,以下简称文档中台)评估。分界线不在功能项多少,而在文档管理器、文件存储、权限判定、升级兜底这四件事由谁实现。

下面按同一组维度与 ONLYOFFICE Docs、永中 WebOffice 比。

三种在线编辑接入形态的责任边界对照:编辑器内核、HTTP 接口型与文档中台私有部署,分别标出业务入口、文件存储、身份与权限、编辑协作、格式转换、升级运维由谁负责。
原创示意图:同样是嵌在线编辑,三种接入形态的责任落在不同一方,选型前先把这张表填满。

一、先分清你买的是编辑器,还是文件打开以后的能力

ONLYOFFICE 官方文档写得很直白:Docs 提供编辑器、编辑服务、命令服务、转换服务与文档构建服务,文档管理器与文档存储服务必须由集成方提供。文档列表、目录、权限判断、文件从哪来、存回哪里,都是你自己的代码。

永中 WebOffice 走 HTTP 接口:openFile.do 传 userId、fileId、filePath,userRight 指定编辑、只读或临时只读,关档时向 callbackUrl 回传。你搭页面、你管文件、你在请求里传权限。

文档中台相反:JSSDK、JSAPI、服务端 API 与事件回调一起给出预览、编辑、转换与协作,官方写明“托管企业既有权限体系”“内置文字水印”“安全事件回调”,且不替代业务入口。

能力归属对照:同一能力项由谁负责
能力项文档中台私有部署ONLYOFFICE Docs永中 WebOffice
文档列表与存储接入方系统集成方自建接入方给路径
权限判定复用既有权限体系写进编辑器配置开档请求传参
格式转换高保真转换与批量处理独立转换服务以官方文档为准
升级与运维按合同分工接入方接入方

WPS 365 也做同一件事:公开页写以 JavaScript SDK 与 RESTful API 接入、文件客户侧存储、接口能力含在商业版本里,细节以官方文档为准。文件存在哪决定要不要多一层网关;权限在哪判定决定撤权是否即时生效。

二、接入方式决定集成工作量,不是反过来

差异落在“谁写哪段代码”,按顺序判断:

  1. 文件已经在哪。在业务库、对象存储还是网盘,决定转换服务能否直接取到文件。
  2. 要不要文档列表页。“我的文档”这类界面,内核型要自己写,按中型前端模块估工。
  3. 权限是传进去还是查出来。传参省事,但撤权要等下次开档;要实时失效,得靠事件回调或令牌有效期。
  4. 回调是否驱动业务状态。正文回写、状态流转要落库,幂等与重试必须先设计。
  5. 前端框架限制。iframe 对路由、弹窗、快捷键的约束要提前试。

答完就能估工:内核型要自写文档管理界面与鉴权中间层;中台把其中一部分收进产品,但身份与异常处理仍归接入方。

三、权限复用:三种“权限在哪里生效”

  • 随请求传入。永中 WebOffice 的 userRight 放在开档请求里,实现直接,代价是权限跟着会话走。
  • 写进配置。ONLYOFFICE 由集成方在初始化配置里下发文档标识、地址与权限;谁能开这份文件,仍是你的后端判定的。
  • 复用既有体系。文档中台写“托管企业既有权限体系”,并开放权限、版本、评论接口。省掉的是再造一套文档权限,不是不用设计权限。

采购时问:撤权后已打开的编辑会话多久失效?能确认的是文档中台有安全事件回调与权限接口,具体字段范围以部署版本为准。

四、计费口径:自托管按服务器与连接,云版本才按用户

ONLYOFFICE 官方定价页把自托管按“服务器数 + 连接数”报价,按用户/月的是云版本或平台型加载项;一个连接指同时打开编辑的标签页,同一文件两人打开算两个,达上限后转只读。文档中台按并发/年,30 并发起售,含 5 个应用接入,新增应用另计,不能用员工总数替代并发。永中价格页写永久授权、授权一台服务器,白皮书另写开档并发取决于授权并发数与服务器内存,具体以询价为准。

计费与授权口径对照:同一行只用一个单位
维度文档中台私有部署ONLYOFFICE Docs永中 WebOffice
计费单位并发/年,含 5 个应用接入服务器数 + 连接数永久授权/服务器,另有授权并发
超限行为以合同为准新开文档转只读以官方文档为准
估算方法按文档操作峰值按同时编辑标签数按授权并发与服务器规格

格式还原要实测:拿 20 份真实文件走“打开—编辑—导出—再导入”,逐份记差异。文档中台写明高保真转换、格式还原与 OFD 支持;ONLYOFFICE 有独立转换服务;永中另有版式与预览产品线。能力存在不等于你的文件不失真。运维按项拆:升级回滚、补丁、字体授权、回调重试各归谁——内核型多在自己,中台按合同分工。

五、判断表与 PoC 验收

按团队能力、既有习惯与接入规模选方案
你的情形更合适的方案依据
有前后端集成人力,只要内核,能自担升级ONLYOFFICE Docs文档管理与存储归集成方
已重度使用 WPS,公文域是刚需WPS 365 WebOffice官方以公文域、内容控件填充为重点
以版式文件、OFD 与预览为主永中 WebOffice 或其版式产品线其官方知识库的产品线在此
多系统要接,按并发控预算,要厂商兜底文档中台私有部署并发授权、权限复用、回调在同一份合同里
  1. 格式。20 份真实文件(红头、复杂表格、图表、批注)逐份比对失真位置。
  2. 权限。不同角色测查看、编辑、下载,再测撤权后已打开会话是否失效。
  3. 并发。按“同时打开编辑标签”造峰,记录达上限时的行为与恢复方式。
  4. 回调。制造重复回调与超时,验证幂等与业务状态是否一致。
  5. 异常与升级。断网、重启、保存失败各测一次,再演练一次升级与回滚。
  6. 交接。日志在哪、告警给谁、工单走哪条通道,写进上线检查表。

常见问题

开源 SDK 能不能商用?

许可与支持分开看。ONLYOFFICE 文档社区版可自托管,但许可条款需法务按其官方许可文本确认,企业版走商业许可。能商用不等于能免费商用,也不等于有人兜底。

自己维护编辑器要多少人?

按职能算:前端管文档列表与嵌入页,后端管文件网关、鉴权与回调幂等,运维管升级监控,测试管回归。四个职能都要有人认领。

商业中台包含哪些服务?

官方口径是 API 与 SDK 形式的文档能力、权限复用、内置文字水印、安全事件回调,以及按并发授权的商业版本。购买后仍需系统集成。

ONLYOFFICE 的连接数怎么数?

官方定义连接为同时打开编辑的标签页:一份文档两人打开算两个,达上限后转只读。估算按峰值同时编辑人数乘人均同时打开的文档数;预览与转换是否占连接以官方文档为准。

下一步:带 20 份真实文件与权限清单做 PoC,用并发计算器估峰值;需要按内网环境与多系统接入评估的,可以预约演示,对照文档中台私有部署产品页与文档中台定价核对授权口径,集成路径见系统集成方案。也可以先看私有化部署方案,了解部署形态与交付范围。