mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-05 12:28:39 +00:00
55 lines
2.4 KiB
Markdown
55 lines
2.4 KiB
Markdown
---
|
||
id: office.plugin.concept
|
||
title: OnlyOffice 插件元信息
|
||
type: concept
|
||
feature: office
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- OnlyOffice 插件
|
||
- office 插件
|
||
- 安装 OnlyOffice
|
||
- 安装在线文档
|
||
- onlyoffice 版本
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites: []
|
||
negative:
|
||
- 主程序不内置 docx/xlsx/pptx 在线编辑，未装插件时双击 Word/Excel/PPT 只能调 fileview 预览
|
||
- 插件体积约 1.3GB，下载较慢，需要稳定网络与充足磁盘
|
||
- 不能离线安装到不联网的环境（需访问应用市场镜像源）
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# OnlyOffice 插件元信息
|
||
|
||
## 定义
|
||
在线 Word/Excel/PPT 编辑由 `office` 插件提供（应用市场 app id 为 `office`，包名 OnlyOffice，当前主版本 9.4.0）。插件包含 OnlyOffice Document Server 完整容器；主程序通过 iframe 嵌入 Document Server 的编辑器页面，借助 OnlyOffice 内置 WebSocket 实现多人实时协作。
|
||
|
||
## 关键属性
|
||
- **作者**：社区维护（Community），上游 https://www.onlyoffice.com/
|
||
- **分类**：微应用（不在管理员应用区）
|
||
- **包大小**：约 1.3GB（含 Document Server，下载慢，按「安装日志」判断进度）
|
||
- **运行形态**：独立 Docker 容器（OnlyOffice Document Server）
|
||
- **数据存储**：编辑结果由 OnlyOffice 回写到 DooTask 文件表，文件本体存到主程序的文件系统，不在 Document Server 长期持久化
|
||
- **协议**：内部通过 JWT 令牌与 OnlyOffice 通信，主程序签发 documentKey 标识文件版本
|
||
|
||
## 安装与启用
|
||
1. 在应用市场（管理员入口）搜索「OnlyOffice」或「在线文档」
|
||
2. 点击安装，等待镜像下载（约 1.3GB，请通过「安装日志」查看进度）
|
||
3. 安装完成后插件自动启用，文件新建菜单立即出现「Word / Excel / PPT」选项
|
||
4. 上传/打开已有 docx/xlsx/pptx 文件即可在线编辑
|
||
|
||
## 卸载影响
|
||
- 卸载后文件库中的 Word/Excel/PPT 文件保留，但无法在线编辑，回退到 fileview 预览（若未装 fileview 则无法预览）
|
||
- 重装后所有文件自动恢复在线编辑能力
|
||
|
||
## 已知限制
|
||
- 部署在公网时建议为 Document Server 配置 HTTPS，否则浏览器可能拦截 WebSocket
|
||
- 同一文件大量并发协作（数十人）需要更强的 Document Server 资源
|
||
|
||
## 相关
|
||
- 是什么：[[office.concept]]
|
||
- 多人协作机制：[[office.collaboration.concept]]
|
||
- 入口在哪：[[office.entry.menu-map]]
|