ONLYOFFICE Docs如何与NEXTCLOUD 24连接集成

ONLYOFFICE官方提供一个连接器，将onLYOFFICE Docs连接集成到Nextcloud上，在Nextcloud云存储空间上编辑办公文档。该连接器可以从Nextcloud的应用市场app store中下载也可以从ONLYOFFICE官方网页GitHub page中下载。

注意：关于ONLYOFFICE和Nextcloud的这个连接器自身的工作原理实现细节，可以参考API文档页面。

另外，onLYOFFICE Docs不仅仅可以与Nextcloud集成，也支持与其它各个主流的云服务器产品集成，不完整列表如下：
Alfresco
Chamilo
Confluence
HumHub
Jira
Liferay
Moodle
Nextcloud
Nuxeo
ownCloud
Plone
Redmine
SharePoint
Strapi

主要功能特征

• 创建、编辑、阅览文档、表格、ppt
• 创建在线表格、填写在线表格
• 与他人分享文件
• 拖放到聊天窗口中分享文件
• 使用水印保护文件
• 实时协作，两种模式：快速和严格模式，可以跟踪改变、注释，以及内建聊天功能
• 在连接到一台documentServer服务器的多个Nextcloud联邦成员实例上实时协作
• JWT支持，为协作者配置适当权限，外部人员不可访问

支持的文件格式

• 可编辑：DOCX、XLSX、PPTX、CSV、TXT、DOCXF
• 只读：PDF
• 可填写表单：OFORM
• 通过OOXML转换而可以编辑的格式：ODT、ODS、ODP、RTF
• 使用ONLYOFFICE可转换为Office Open XML的格式：DOC、DOCM、DOT、DOTX、EPUB、HTM、HTML、ODP、ODT、POT、POTM、POTX、PPS、PPSM、PPSX、PPT、PPTM、RTF、XLS、XLSM、XLT、XLTM、XLTX

7.2.1新版本新特性

新增功能：

• 查看文档服务器端版本号

改变功能：

• 修正改善了阅览生成功能
• 匹配兼容了Nextcloud 23版本

完整的版本更新日志在这里。

系统需求

• onLYOFFICE Docs v6.1或更高版本
  需要一个onLYOFFICE Docs服务器部署实例，可以被Nextcloud访问也可以被任何客户端访问，onLYOFFICE Docs必须能够直接发布到Nextcloud。
  从4.3.0版本开始onLYOFFICE Docs和Nextcloud可以部署在不同的计算机上也可以部署在同一台计算机上，如果选择部署于同一台服务器上，鉴于两者都默认使用80号端口，你需要修改onLYOFFICE Docs为其他端口号。

请参考阅读onLYOFFICE Docs官方安装文档。

• Nextcloud v20.0.0 - 23.0.0或更高版本。
• onLYOFFICE connector v7.2.0或更高版本for Nextcloud

安装Nextcloud的ONLYOFFICE连接器

Nextcloud云管理员可以使用其内建的应用市场来执行安装：

1. 点击用户名选择 应用市场
2. 进入 工具分类
3. 在应用列表中找到
4. 点击 下载启用按钮

也可以采用手动安装的方式：

1. 下载获取 应用

   1. 从Nextcloud官方市场下载最新签名版onlyoffice连接器

   2. 从Github上下载最新签名版连接器：

      其中 是连接器的版本号。解压缩：

      重命名文件夹为onlyoffice：

   3. 克隆应用程序源代码并自己编译：

2. 将文件夹 移动到Nextcloud服务器的 路径下，或者其它路径用来连接两者：

3. 进入 路径

4. 改变所有者，使得从Nextcloud的web界面访问升级应用程序

5. 在Nextcloud里，进入菜单 点击 启用ONLYOFFICE。

配置Nextcloud的ONLYOFFICE连接器

在Nextcloud中配置ONLYOFFICE应用的配置，打开菜单 。

在常用设置Common settings中：

• Restrict access to the editors to following groups限制编辑器的访问权限到以下分组：选中复选框开启该功能，在Nextcloud中选择分组可以禁止访问ONLYOFFICE服务。
• Use onLYOFFICE to generate a document preview使用ONLYOFFICE生成文档预览：选中复选框开启该功能，使得ONLYOFFICE自动生成文档内容预览图，该功能会轻微使用硬盘空间。
• Open file in the same tab在同一个标签页里打开文件：选中复选框开启该功能，打开文件在当前标签页里，否则打开文件会出现在新建标签页里。
• Keep metadata for each version once the document is edited编辑文档保留每个版本的元数据：开启后将保存文档的每一版本的元数据、每一版本的改动变化，展示在文档的版本历史中，该功能会占用一定的硬盘空间，可以用clear清空按钮删除元数据和版本历史来释放空间。
• The default application for opening the format格式关联默认打开方式：设置使用ONLYOFFICE打开哪些格式文件，默认选中为docx、xlsx、pptx。
• Open the file for editing打开文件进行编辑：允许管理员选择可以通过转换为OOXML格式来编辑的文档格式，默认选择csv和txt格式。

注意：鉴于格式的不同，在格式转换中会有某些数据信息损失（csv、odp、ods、odt、rtf、txt）

开启该选项后，点击文件后会自动被格式转换并打开以供编辑修改，而如果不开启该选项，点击文件后只会以只读模式打开阅览。

为Nextcloud和ONLYOFFICE连接启用JWT

为了保护文档免受未经授权的访问，ONLYOFFICE编辑器使用JSON网络令牌JWT。当文档编辑器初始化时，以及在内部ONLYOFFICE文档服务之间交换命令期间，令牌添加保存在配置中，密钥用于签署JSON Web令牌，并根据对onLYOFFICE Docs的请求验证令牌。

为保护文档，应开启令牌验证功能，在onLYOFFICE Docs配置文件中设定自己的密钥，并在连接器设置中指定同一个密钥。

第一步：配置onLYOFFICE Docs

1. 使用任意编辑器打开配置文件

   1. Linux系统：
   2. Windows系统：
   3. Docker方式：打开进入onLYOFFICE Docs的容器 ，打开文件

2. 开启令牌验证功能，需要在三个位置将 修改为

3. 设定自己的密钥，在如下的三个位置设定自己的密钥，且必须保持相同。

4. 保存修改
5. 重启服务使修改生效

第二步：在连接器设置中设定同一个密钥

在连接器设置中，在密钥字段中指定相同的密钥并保存设置。

连接到示例onLYOFFICE Docs

从onLYOFFICE connector version 3.0.0开始，可以在安装自己的onLYOFFICE Docs之前先试用ONLYOFFICE的在线编辑器功能来测试。

开启这个测试链接仅需要点击Connect to demo onLYOFFICE Docs server连接到在线服务器按钮再点击保存即可。

注意：这只是一个在线测试站，仅限使用30天，且不要上传个人敏感信息。

使用Docker Compose为Nextcloud安装onLYOFFICE Docs

使用Docker Compose可以快速便捷的在Docker容器上安装部署onLYOFFICE Docs，并且是已经预先配置好与Nextcloud进行连接。

安装Docker和Docker Compose

1. 参考这一篇指南来下载安装Docker，Docker是一个用于在支持容器的环境中自动化应用程序开发和管理的程序。
2. 参考这一篇指南来下载安装Docker Compose包管理器，这将允许描述和运行多容器应用程序。

安装onLYOFFICE Docs和Nextcloud Servers

1. 下载最新版本的docker-onlyoffice-nextcloud，执行下列命令：

2. 进入文件夹

3. 启动

注意：上述命令执行后可能需要等几分钟才能完全启动各个容器正常运行

打开网页浏览器打开地址 ，Nextcloud设置界面出现，创建你自己的管理员账号，设定管理员登陆密码。

完成欢迎向导之后进入文件夹 执行下面命令：

现在就可以在Nextcloud里面调用出onLYOFFICE Docs来创建编辑文档了。

服务器的设置在部署过程中设定好了，但是可以随时改变 常用设置、编辑器自定义设置、常用模板、安全视图等设置，详情可以参考Nextcloud中配置ONLYOFFICE连接器。

在虚拟机中用UCS来为Nextcloud安装onLYOFFICE Docs

Univention引入了一种方便的包安装管理配置方式，Univention企业服务器 ，缩写为UCS，可以将onLYOFFICE Docs、Nextcloud这样的应用服务打包集成配置好在操作系统虚拟机镜像中，方便分发下载部署配置。

Univention是开源企业架构开发平台，安装已经预先装配企业服务应用的操作系统，采用VMware和VirtualBox虚拟机格式的Linux虚拟机镜像，其中装配好有应用服务、UCS管理系统、以及UCS运行时环境。

下面的虚拟机镜像文件包含有Univention企业服务器UCS、Nextcloud和ONLYOFFICE，开箱即用预装了这些软件，并且提供了自动化配置向导界面，方便进行初始化配置在Nextcloud中使用ONLYOFFICE，免除了手动安装配置的复杂性。

下载虚拟机

首先要安装虚拟机软件，可以选择VMware Workstation Player安装指南或VirtualBox安装指南。

导入虚拟机

在你的虚拟机软件里面导入下载的虚拟机镜像文件，详情请见虚拟服务器导入指南。

初始化配置

导入虚拟机后开机，系统引导进入初始化配置向导环节：

8. 安装license，按照打开浏览器，输入ip地址打开页面，上传通过注册的管理员邮箱接收到的激活license。

9. ONLYOFFICE允许以两种方式连接协同编辑Nextcloud上的文档：在线浏览器、使用电脑端软件连接，如此就可以使用电脑端编辑器特有的强大功能：

   • 使用密码或数字签名保护文档；
   • 在编辑器里使用Send发送按钮发送正在编辑的文档；
   • 在幻灯片编辑器中可以插入音频和视频。

   注：假定你已经安装部署有了Nextcloud server、onLYOFFICE Docs和integration app

   管理账号更多细节请参考这里。

   手机端的ONLYOFFICE应用软件也可以配置连接到你的Nextcloud云服务器上使用协同办公功能。

   注：假定你已经安装部署有了Nextcloud server、onLYOFFICE Docs和integration app

   首先在手机上安装onLYOFFICE documents苹果版本或onLYOFFICE documents安卓版本，然后配置服务器连接：

   1. 打开Clouds云配置页面
   2. 选择Nextcloud云
   3. 在Connection URL地址栏输入你自己的Nextcloud云服务器网络地址
   4. 输入你的Nextcloud云的账号用户名和密码
   5. 触摸Next下一步按钮登陆

   你的Nextcloud云上的文件部分将自动展现在手机端编辑器中，可以新建文件也可以打开已有文件，可以与Nextcloud的其他ONLYOFFICE手机编辑器的使用者分享文件协同编辑。
   /en/office-for-ios.aspx)")或onLYOFFICE documents安卓版本，然后配置服务器连接：

   1. 打开Clouds云配置页面
   2. 选择Nextcloud云
   3. 在Connection URL地址栏输入你自己的Nextcloud云服务器网络地址
   4. 输入你的Nextcloud云的账号用户名和密码
   5. 触摸Next下一步按钮登陆