ONLYOFFICE部署与集成

OnlyOffice技术文档

概述

协作型的在线文档编辑软件，高度兼容MS Office格式。可进行权限控制，包括复制、下载、编辑等。

OnlyOffice官网

版本说明

• 社区版（免费，最高20个可同时连接，推荐最高20个用户数）
• 企业版（付费，根据价格可选择用户数）
• 开发者版（付费，根据价格可选择用户数）

点击我查看版本对比，主要区别如下图：

本文档使用社区版

安装说明

Docker安装（推荐）

操作系统要求

1. 硬件要求
   • CPU：双核2GHz或更高
   • 内存：>2G
   • 硬盘：>40G
   • 其他：至少4 GB的交换空间
2. 软件要求
   • 系统内核版本：3.10或更高版本的amd64 Linux 发行版
   • Docker：>1.10

Linux安装

操作系统要求（硬件要求与Docker的差不多）

1. 软件要求（Debian、Ubuntu）

   • 操作系统：64 位Debian、Ubuntu或其他内核版本 3.13 或更高版本的兼容发行版
   • 其他：
   • PostgreSQL: version 12.9 or later
   • NGINX: version 1.3.13 or later
   • libstdc++6: version 4.8.4 or later
   • RabbitMQ

2. 软件要求（RHEL、CentOS）

   • 操作系统：RHEL 7或 CentOS 7
   • 其他：
   • PostgreSQL: version 12.9 or later
   • NGINX: version 1.3.13 or later
   • RabbitMQ

Windows Server安装

操作系统要求（硬件要求与Docker的差不多）

软件要求（Windows Server）

• 操作系统：64-bit Windows Server 2012 or higher
• 其他：
• Erlang: version 24.2
• RabbitMQ: version 3.9.12
• PostgreSQL: version 12.9 or later

工作原理

官方说明

在 ONLYOFFICE 文档服务器中处理文档文件是一个非常简单的过程，但它需要了解当您单击文档链接以在浏览器中打开它、保存文档或将其从计算机上传到文档服务器时发生的情况.

在本节中，您将学习如何：

• 打开一个文件
• 保存文件
• 共同编辑文件
• 查看文档历史记录
• 使用操作链接
• 提及用户
• 重命名文件
• 查看文件
• 使用内联编辑器
• 转换和下载文件
• 保护文档
• 为匿名用户设置名称
• 对文档发表评论
• 比较文件

用户文档交互

用户文档交互在客户端和服务器端都完成。

下面解释了整个当前文档中使用的主要概念。

客户端包括：

• 文档管理器- 显示在用户浏览器中的文档列表，用户可以在其中选择必要的文档并对其执行一些操作（根据提供的权限，用户可以打开文档以查看或编辑，与其他用户）。
• 文档编辑器- 文档查看和编辑界面，具有所有最知名的文档编辑功能，用作用户和文档编辑服务之间的媒介。

服务器端包括：

• 文档存储服务- 服务器服务，它存储具有适当访问权限的用户可用的所有文档。它将文档 ID 和指向这些文档的链接提供给用户在浏览器中看到 的文档管理器。
• 文档编辑服务- 允许执行文档查看和编辑的服务器服务（如果用户具有执行此操作的适当权限）。文档编辑器界面用于访问所有文档编辑服务功能。
• 文档命令服务- 允许使用文档编辑服务执行附加命令的服务器服务。
• 文档转换服务- 允许将文档文件转换为适当的 Office Open XML 格式（文本文档为docx ，电子表格为xlsx ，演示文稿为**pptx）以供编辑或下载的服务器服务。
• 文档构建器服务- 允许轻松构建文档而无需实际运行文档处理编辑器的服务器服务。

请注意，ONLYOFFICE 文档服务器（ONLYOFFICE Document Server）包括文档编辑器、文档编辑服务、文档命令服务、文档转换服务和文档生成器服务。文档管理器和文档存储服务要么包含在社区服务器中，要么必须由在自己的服务器上使用 ONLYOFFICE 文档服务器的软件集成商实施。

部署文档服务器（ONLYOFFICE Document Server）

在RHEL上为64位的ARM架构安装OnlyOffice社区版

从7.1版本开始，ONLYOFFICE Docs 可以安装在 64 位 ARM 架构的 CentOS 或 RHEL 上。

如何在 64 位 ARM 架构的 CentOS 8 或 RHEL 8 上安装ONLYOFFICE Docs Community Edition Linux 版本7.1及更高版本。

教程中推荐安装nginx、epel、PostgreSQL、RabbitMQ、mscorefonts，业务中没有使用，这里不安装

官方部署教程增加了很多不必要的插件部署，这里参考别人的博客进行部署。

参考博客

CentOS Docker安装（菜鸟教程）

Linux安装Docker（官网）

1. 使用yum命令安装Docker

   yum install docker -y
   

2. 查看docker版本

   docker version
   

3. 查看docker信息

   yum list|grep docker
   

4. 启动Docker服务

   systemctl start docker
   
   ## 报错：Failed to start docker.service: Unit docker.service not found.
   ## 原因：安装docker的时输入的指令 **yum install docker** 不准确，导致系统以为我们想装的是podman—docker
   ## 解决：卸载podman-docker，安装docker-ce（社区版）
   ## 查看docker安装插件
   [root@WrightLiu ~]# yum list|grep docker
   ## 卸载podman-docker
   [root@WrightLiu ~]# dnf remove podman-docker
   ## yum-utils 提供了 yum-config-manager ，并且 device mapper 存储驱动程序需要 device-mapper-persistent-data 和 lvm2。
   [root@WrightLiu ~]# yum install -y yum-utils device-mapper-persistent-data lvm2
   ## 设置yum国内镜像源-阿里云
   [root@WrightLiu ~]# sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
   ## 安装docker-ce
   [root@WrightLiu ~]# yum install docker-ce
   

5. 拉取OnlyOffice镜像（可联网）

   sudo docker pull onlyoffice/documentserver
   
   ## 报错如下（请求超时）
   [root@oa-kf1 web]# sudo docker pull onlyoffice/documentserver
   Using default tag: latest
   Trying to pull repository docker.io/onlyoffice/documentserver ... 
   Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)
   
   ## 改为如下命令安装，报错（提示未注册）
   [root@oa-kf1 web]# sudo yum install onlyoffice-documentserver
   Loaded plugins: fastestmirror, product-id, search-disabled-repos, subscription-manager
   
   This system is not registered with an entitlement server. You can use subscription-manager to register.
   
   Loading mirror speeds from cached hostfile
    * base: 192.168.66.40:8600
    * extras: 192.168.66.40:8600
    * updates: 192.168.66.40:8600
   base                                                                                    | 3.6 kB  00:00:00     
   extras                                                                                  | 2.9 kB  00:00:00     
   updates                                                                                 | 2.9 kB  00:00:00     
   No package onlyoffice-documentserver available.
   Error: Nothing to do
   

6. 拉取OnlyOffice镜像（无法联网）

   内网无法联网，因此不能直接运行docker pull命令下载docker镜像，可按下述方法获取docker镜像：
   步骤:
   1. 在可以联网的机子上执行docker pull命令下载镜像，如:
   
      sudo docker pull onlyoffice/documentserver
   
   
   2. 然后运行docker save命令将镜像保存为tar归档文件，如：
   
      docker save -o onlyoffice-documentserver.tar onlyoffice/documentserver
   
   
   3. 将保存的bitco