OnlyOffice 入门文档

一、OnlyOffice 是什么

OnlyOffice 是一套在线办公软件，可以在浏览器中打开、查看和编辑 Word、Excel、PowerPoint 等常见办公文档。

简单来说，它相当于一个运行在服务器上的“网页版 Office”。用户不需要在每台电脑上都安装 Microsoft Office，只要打开网页，就可以处理文档。

OnlyOffice 通常以服务的形式部署在服务器上。其他系统，例如 ZFile、网盘系统或企业办公平台，可以调用它来实现在线预览和编辑功能。

二、OnlyOffice 能解决什么问题

传统的文件管理系统通常只能完成文件上传、下载和保存。如果用户想查看一个 Word 或 Excel 文件，往往需要先下载文件，再使用本地 Office 软件打开。

OnlyOffice 可以把这个过程放到网页中完成：

文件保存在服务器或云存储中
          ↓
用户在网页中点击文件
          ↓
OnlyOffice 在线打开文件
          ↓
用户直接预览或编辑
          ↓
修改结果保存回原来的存储位置

这样做的好处是，文件不需要反复下载，用户也可以在不同电脑、手机或平板上访问文档。

三、主要功能

1. 在线查看文档

OnlyOffice 可以直接在浏览器中查看常见办公文件，例如：

Word 文档：.doc、.docx
Excel 表格：.xls、.xlsx
PowerPoint 演示文稿：.ppt、.pptx
PDF 文件：.pdf

用户点击文件后，系统会在网页中展示文档内容，不需要先下载到本地。

2. 在线编辑文档

如果用户拥有编辑权限，就可以直接在网页中修改文档，包括：

修改文字和段落
设置字体、颜色和对齐方式
插入表格、图片和超链接
修改 Excel 单元格和公式
编辑幻灯片内容
添加或调整演示文稿页面

编辑完成后，文件可以保存回服务器或云存储。

3. 处理电子表格

OnlyOffice 的表格功能类似 Excel，可以进行：

单元格编辑
公式计算
排序和筛选
设置表格格式
插入图表
多人协作编辑

4. 制作演示文稿

OnlyOffice 还可以打开和编辑 PowerPoint 文件，支持：

修改幻灯片文字
更换主题和布局
插入图片、表格和图形
调整页面顺序
设置演示效果

5. 权限控制

OnlyOffice 可以根据系统传递的权限决定用户能做什么。例如：

只允许查看
允许编辑
禁止下载
禁止修改原文件

在 ZFile 中，OnlyOffice 的编辑权限通常还会受到用户存储权限的影响。用户没有上传或修改权限时，即使打开了文档，也不应该被允许保存修改结果。

6. 协同编辑

在配置正确的情况下，多名用户可以同时打开同一个文档进行协作。不同用户的修改可以在网页中同步显示。

是否允许协同编辑，取决于具体的部署方式、版本和系统配置。

7. 文档格式转换

OnlyOffice 在部分场景下支持文档格式转换，例如将文档转换成 PDF。具体支持的格式，需要根据实际部署版本确认。

四、OnlyOffice 与 ZFile 的关系

OnlyOffice 和 ZFile 是两个不同的系统，各自负责不同的工作：

系统	主要职责
ZFile	管理文件、存储源、用户和权限
OnlyOffice	打开、预览和编辑 Office 文档

可以把它们理解成：

ZFile 负责“文件放在哪里、谁可以访问”，OnlyOffice 负责“文件如何在线打开和编辑”。

例如，一个 Word 文件保存在阿里云 OSS 中：

用户登录 ZFile；
ZFile 检查用户是否有权访问这个文件；
ZFile 获取文件访问地址；
ZFile 把文件信息交给 OnlyOffice；
OnlyOffice 在浏览器中打开文件；
用户修改文件后，OnlyOffice 通知 ZFile；
ZFile 再把修改后的文件保存回阿里云 OSS。

五、OnlyOffice 的基本使用流程

OnlyOffice 本身不是一个普通的桌面软件，通常需要部署一个独立的 Document Server。

使用流程一般如下：

第一步：部署 OnlyOffice 服务

可以使用 Docker 或其他方式部署 OnlyOffice Document Server。

部署完成后，需要确保浏览器、ZFile 和 OnlyOffice 之间能够互相访问。

第二步：在 ZFile 中填写地址

在 ZFile 的预览或页面设置中填写 OnlyOffice 服务地址，例如：

http://office.example.com

如果启用了 JWT 安全验证，还需要在 ZFile 和 OnlyOffice 中配置相同的 Secret。

第三步：配置文件存储

在 ZFile 中配置本地存储、对象存储或其他网盘，并上传一个 Word、Excel 或 PowerPoint 文件。

第四步：打开文件

用户点击文件后，ZFile 会根据文件类型决定是否使用 OnlyOffice。支持的 Office 文件通常会在网页中打开。

第五步：查看或编辑

如果用户只有预览权限，文档会以只读方式打开；如果用户拥有编辑权限，就可以修改并保存文件。

六、常见使用场景

场景一：企业资料管理

公司把合同、制度、报价单和项目资料放在服务器中。员工可以登录文件管理系统，直接在线查看资料，不需要将文件全部下载到电脑上。

场景二：团队协作办公

多个成员共同维护项目计划表、任务清单或会议记录，可以直接在浏览器中编辑同一个文件。

场景三：个人网盘

用户把文档保存在自己的服务器或云存储中。无论使用电脑还是手机，都可以通过网页访问和编辑这些文件。

场景四：文件分享

管理员可以通过 ZFile 分享一个文档。其他人打开分享链接后，可以在线查看文件，而不一定需要下载到本地。

场景五：远程办公

员工出差或在家办公时，只要能够访问系统，就可以处理公司文档，不必依赖固定办公电脑。

七、OnlyOffice 与 Microsoft Office、百度网盘的区别

OnlyOffice 与 Microsoft Office

对比项	OnlyOffice	Microsoft Office
使用方式	浏览器在线使用	主要是本地软件，也有在线版本
部署位置	通常部署在服务器	通常安装在个人电脑或使用微软云服务
文件管理	依赖接入的文件管理系统	主要管理本地或微软云端文件
多人协作	支持在线协作	支持协作，取决于具体版本和服务
适合场景	企业内部系统、网盘、私有化部署	个人办公和企业办公

OnlyOffice 与百度网盘

百度网盘主要负责文件存储、同步和分享，也可能提供在线文档预览能力。

OnlyOffice 更专注于文档本身的打开和编辑。它通常不会单独负责完整的网盘功能，而是被 ZFile 这类文件管理系统调用。

可以这样理解：

百度网盘：更像“网盘 + 部分在线办公能力”；
ZFile：更像“自己搭建的文件管理平台”；
OnlyOffice：更像“可以嵌入其他系统的在线 Office 编辑器”。

八、使用 OnlyOffice 前需要准备什么

使用 OnlyOffice，一般需要准备以下内容：

一台可以运行 OnlyOffice 的服务器；
已部署好的 OnlyOffice Document Server；
一个文件管理系统，例如 ZFile；
可访问的文件地址；
正确配置的 OnlyOffice 服务地址；
ZFile 与 OnlyOffice 之间一致的安全 Secret；
如果要在线编辑，还需要配置用户的修改权限。

另外，服务器之间的网络必须能够连通。OnlyOffice 需要能够访问文件地址，浏览器也需要能够访问 OnlyOffice 页面。

九、常见问题

1. 打开文档后显示空白

常见原因包括：

OnlyOffice 服务没有启动；
ZFile 填写的地址不正确；
浏览器无法访问 OnlyOffice；
OnlyOffice 无法访问 ZFile 提供的文件地址；
服务器防火墙或反向代理阻止了请求。

2. 可以预览，但无法保存

可能是以下原因：

当前用户没有上传或修改权限；
ZFile 没有正确配置 OnlyOffice Secret；
OnlyOffice 与 ZFile 的 Secret 不一致；
保存回调地址无法访问；
原来的存储源不允许写入文件。

3. 为什么不能直接使用 localhost

localhost 表示“当前设备自己”。如果 OnlyOffice 和 ZFile 分别运行在不同服务器上，那么 OnlyOffice 中的 localhost 可能指向 OnlyOffice 自己，而不是 ZFile。

实际部署时，通常应该使用服务器 IP 或域名，例如：

https://file.example.com
https://office.example.com

4. OnlyOffice 会不会自动保存所有文件

不会。OnlyOffice 只处理被打开的文档。是否可以保存，以及保存到哪里，由 ZFile 的权限和存储源配置决定。

5. OnlyOffice 会不会替代 ZFile

不会。OnlyOffice 主要负责在线办公，ZFile 仍然负责文件浏览、上传、下载、分享、用户管理和权限控制。

十、总结

OnlyOffice 是一个在线办公文档处理工具，主要用于在浏览器中查看和编辑 Word、Excel、PowerPoint 等文件。

在 ZFile 项目中，它承担的是“在线文档预览和编辑”这一部分工作：

ZFile：管理文件和权限
OnlyOffice：打开和编辑 Office 文档
存储源：真正保存文件
浏览器：展示操作界面

因此，OnlyOffice 不等于网盘，也不等于完整的文件管理系统。它更像一个可以被 ZFile 集成的在线 Office 引擎，让原本只能下载的文档，能够直接在网页中打开和编辑。