ownCloud ONLYOFFICE集成应用

此应用程序允许用户使用打包为文档服务器的ONLYOFFICE Docs（社区版或企业版）从ownCloud编辑办公文档。

功能

该应用程序允许:

• 创建和编辑文本文档、电子表格和演示文稿。
• 以不同权限类型共享文件 - 查看/编辑、评论、审阅、填写表单。还可以限制下载（在所有编辑器中）和修改筛选器（在电子表格中）。也可通过公共链接共享。
• 实时协同编辑文档：使用两种协同编辑模式（快速和严格）、追踪修改、评论和内置聊天。多个连接到同一文档服务器的联合ownCloud实例也可进行协同编辑。
• 在ownCloud Web中处理文档、电子表格和演示文稿。

支持的格式：

• 可编辑：DOCM、DOCX、DOCXF、DOTM、DOTX、EPUB、FB2、HTML、ODT、OTT、RTF、TXT、CSV、ODS、OTS、XLSM、XLSX、XLTM、XLTX、ODP、OTP、POTM、POTX、PPSM、PPSX、PPTM、PPTX。
• 仅可查看：DJVU、DOC、DOT、FODT、HTM、MHT、MHTML、OFORM、PDF、STW、SXW、WPS、WPT、XML、XPS、ET、ETT、FODS、SXC、XLS、XLSB、XLT、DPS、DPT、FODP、POT、PPS、PPT、SXI。

ODT、ODS和ODP也可进行即时转换。在管理设置中启用相应选项后，ODF格式的文档会在编辑器中立即转换，点击后即可打开。

安装ONLYOFFICE Docs

你需要一个ONLYOFFICE Docs（文档服务器）实例，该实例可从ownCloud和任何终端客户端解析和连接。ONLYOFFICE文档服务器还必须能够直接向ownCloud发送POST请求。

ONLYOFFICE文档服务器和ownCloud可以安装在不同的计算机上，也可以安装在同一台机器上。如果使用同一台机器，请为文档服务器设置自定义端口，因为默认情况下ONLYOFFICE文档服务器和ownCloud都在80端口上工作。

你可以安装免费的ONLYOFFICE Docs社区版或具有专业功能的可扩展企业版。

要安装免费的社区版，请使用Docker（推荐）或按照这些说明在Debian、Ubuntu或其衍生版上安装。

要安装企业版，请按照此处的说明进行操作。

社区版与企业版的比较可以在这里找到。

要在代理后面使用ONLYOFFICE，请参阅本文。

你也可以使用我们的**Docker安装**，通过几个命令安装预配置的文档服务器（免费版）和ownCloud。

安装ownCloud ONLYOFFICE集成应用

ownCloud管理员可以从内置的应用市场安装集成应用。 为此，点击左上角的汉堡菜单并选择市场。然后在可用应用列表中找到ONLYOFFICE并安装它。

如果安装ownCloud的服务器没有互联网访问权限，或者出于其他原因需要，管理员可以手动安装应用程序：

1. 进入ownCloud服务器的_apps/_目录（或其他使用的目录）：

   cd apps/
   

2. 获取ownCloud ONLYOFFICE集成应用。 有几种方法可以做到这一点：

   a. 从ownCloud的官方商店下载最新签名版本。

   b. 或者你可以从GitHub上的应用程序发布页面下载最新签名版本。

   c. 或者你可以克隆应用程序源代码并自行编译：

   git clone https://github.com/ONLYOFFICE/onlyoffice-owncloud.git onlyoffice
   cd onlyoffice
   git submodule update --init --recursive
   

   ownCloud不使用未签名的应用程序并会发出警告，所以你需要使用选项a或b来获取应用程序。

3. 更改所有者以便直接从ownCloud Web界面更新应用程序：

   chown -R www-data:www-data onlyoffice
   

4. 在ownCloud中，由管理员打开~/settings/admin?sectionid=apps&category=disabled页面，查看_未启用_的应用，并为ONLYOFFICE应用点击_启用_。

配置ownCloud ONLYOFFICE集成应用

在ownCloud中打开~/settings/admin?sectionid=additional#onlyoffice页面，进入ONLYOFFICE部分的管理设置。 输入以下地址连接ONLYOFFICE文档服务器：

https://<documentserver>/

其中documentserver是安装了ONLYOFFICE文档服务器的服务器名称。 该地址必须对用户浏览器和ownCloud服务器可访问。 ownCloud服务器地址也必须从ONLYOFFICE文档服务器可访问，以确保正常工作。

有时你的网络配置可能不允许使用公共地址在已安装的ownCloud和ONLYOFFICE文档服务器之间进行请求。 _高级服务器设置_允许设置ONLYOFFICE文档服务器地址，用于从ownCloud服务器发送内部请求，以及用于从ONLYOFFICE文档服务器发送内部请求的返回ownCloud地址。 你需要在相应的字段中输入它们。

从7.2版本开始，默认启用JWT，并自动生成密钥以限制对ONLYOFFICE Docs的访问，以及出于安全原因和数据完整性。 在ownCloud管理配置中指定你自己的密钥。 在ONLYOFFICE Docs的配置文件中，指定相同的密钥并启用验证。

启用或禁用_在同一标签页中打开文件_设置。

文件上下文菜单中将添加在ONLYOFFICE中打开操作。 你可以将此操作指定为默认操作，对于选定的文件类型，点击文件名时将使用此操作。

检查连接

你可以使用以下occ命令检查与ONLYOFFICE文档服务器的连接：

occ onlyoffice:documentserver --check

你将看到一段文本，其中包含成功连接的信息或错误原因。

为ownCloud Web启用编辑

要在ownCloud Web中启用工作，请在ownCloud Web的config.json中注册连接器：

• 如果你从官方市场安装了ownCloud Web，路径是<owncloud-root-catalog>/config/config.json
• 如果你按照此说明自行从源代码编译，路径是<owncloud-web-root-catalog>/config/config.json。

要注册连接器，请使用以下行：

"external_apps": [
    {
        "id": "onlyoffice",
        "path": "http(s)://<owncloud-10-服务器地址>/index.php/apps/onlyoffice/js/onlyoffice.js",
    }
]

根据您的网络服务器配置，您可以从URL路径中删除index.php段。

工作原理

ONLYOFFICE集成遵循此处记录的API：

• 创建新文件时，用户导航到ownCloud中的文档文件夹，并点击新建(+)菜单中的文档、电子表格或演示文稿项。

• 浏览器调用/lib/Controller/EditorController.php控制器中的create方法。该方法将assets文件夹中的文件副本添加到用户当前所在的文件夹中。

• 或者，打开现有文件时，用户在ownCloud中导航到该文件并选择在ONLYOFFICE中打开菜单选项。

• 打开一个新的浏览器标签页，并调用/lib/Controller/EditorController.php控制器的index方法。

• 应用程序准备一个具有以下属性的JSON对象：

  • url - ONLYOFFICE文档服务器用于下载文档的URL；
  • callbackUrl - ONLYOFFICE文档服务器通知文档编辑状态的URL；
  • documentServerUrl - 客户端需要响应ONLYOFFICE文档服务器的URL（可以在管理设置页面设置）；
  • key - 用于指示ONLYOFFICE文档服务器是否需要再次下载文档的etag；

• ownCloud获取此对象并从templates/editor.php模板构建一个页面，填充所有这些值，以便客户端浏览器可以加载编辑器。

• 客户端浏览器从ONLYOFFICE文档服务器请求javascript库，并向ONLYOFFICE文档服务器发送带有上述属性的DocEditor配置。

• 然后ONLYOFFICE文档服务器从ownCloud下载文档，用户开始编辑。

• ONLYOFFICE文档服务器向_callbackUrl_发送POST请求，通知ownCloud用户正在编辑文档。

• 当所有用户和客户端浏览器完成编辑后，他们关闭编辑窗口。

• 10秒无活动后，ONLYOFFICE文档服务器向_callbackUrl_发送POST，让ownCloud知道客户端已完成文档编辑并关闭。

• ownCloud下载新版本的文档，替换旧版本。

已知问题

• 使用外部存储应用添加存储在某些情况下会出现协同编辑问题。如果使用相同的授权密钥（选择_用户名和密码_或_全局凭证_身份验证类型）进行连接，则用户可以使用协同编辑。如果使用不同的授权密钥（_登录凭证，保存在数据库中_或_用户输入，存储在数据库中_身份验证选项），则协同编辑不可用。当使用_登录凭证，保存在会话中_身份验证类型时，无法在编辑器中打开文件。

• ownCloud提供加密文件存储的选项。但如果启用了_每用户加密密钥_加密（ownCloud 默认加密模块应用默认使用），ONLYOFFICE文档服务器无法打开加密文件进行编辑，也无法在编辑后保存。管理设置页面的ONLYOFFICE部分将显示相关通知。但是，如果您设置了_主密钥_加密，ONLYOFFICE应用程序将正常工作。有关启用基于_主密钥_加密的说明可在ownCloud网站的官方文档中找到。

• 如果您为文档服务器使用自签名证书，ownCloud将不会验证此类证书，并且不允许与文档服务器建立连接。此问题可以通过两种方式解决。

  您可以在ownCloud的ONLYOFFICE管理页面的服务器设置部分勾选"禁用证书验证（不安全）"选项。

  另一种选择是手动更改ownCloud配置文件。找到ownCloud配置文件（/owncloud/config/config.php）并打开它。在其中插入以下部分：

  'onlyoffice' => array (
      'verify_peer_off' => true
  )
  

  这将禁用证书验证，并允许ownCloud与文档服务器建立连接。

  请记住，这是一个临时的不安全解决方案，我们强烈建议您将证书替换为由某个CA颁发的证书。完成后，不要忘记取消勾选相应的设置框或从ownCloud配置文件中删除上述部分。

• 如果编辑器在正常运行一段时间后无法打开或保存文档，原因可能是网络设置变更或禁用了任何相关服务，或SSL证书问题。

  为解决此问题，我们添加了一个在服务器上运行的异步后台任务，用于检查编辑器的可用性。它允许测试ownCloud实例和ONLYOFFICE文档服务器之间的连接，即检查服务器地址的可用性和JWT密钥的有效性。

  如果检测到任何问题，ONLYOFFICE集成连接器（因此，创建和打开文件的能力）将被禁用。作为ownCloud管理员，您将收到相应的通知。

  此选项允许您避免服务器设置变得不正确并需要更改时出现的问题。

  默认情况下，此后台任务每天运行一次。如有必要，您可以更改频率。为此，打开ownCloud配置文件（/owncloud/config/config.php）。插入以下部分并以分钟为单位输入所需的值：

  'onlyoffice' => array (
      'editors_check_interval' => 3624
  )
  

  要禁用此检查运行，请输入0值。

• 访问没有下载权限的文档时，文件打印和使用系统剪贴板功能不可用。通过编辑器工具栏和上下文菜单中的按钮可以在编辑器内复制和粘贴。

ONLYOFFICE Docs版本

ONLYOFFICE提供不同版本的在线文档编辑器，可部署在您自己的服务器上。

• 社区版（onlyoffice-documentserver包）
• 企业版（onlyoffice-documentserver-ee包）

下表将帮助您做出正确的选择。

* 如果DMS支持的话。