ownCloud

关于 ONLYOFFICE 和 ownCloud 集成

ONLYOFFICE 提供了一个官方连接器，可以将 ONLYOFFICE 文档 与 ownCloud 集成，并在云存储中编辑办公文档。您可以从 ownCloud 应用市场或 ONLYOFFICE GitHub 页面下载 ONLYOFFICE 连接器。该连接器基于 Apache-2.0 许可证分发。

备注

要详细了解 ONLYOFFICE 和 ownCloud 集成连接器及其工作原理，请访问我们的 API 文档页面。

主要功能

• 创建、编辑和查看文本文档、电子表格和演示文稿。
• 以不同权限共享文件：查看/编辑、审阅、填写表单以及带用户提及的批注。还可以限制下载（在所有编辑器中）和修改筛选器（在电子表格中）。同时支持通过公共链接共享。
• 实时共同编辑文档：两种共同编辑模式（快速和严格）、跟踪更改、批注和内置聊天。
• 连接到同一个 文档服务器 的多个联合 ownCloud 实例之间可以进行共同编辑。
• JWT 支持，保护您的流量，除具有适当权限的用户外，任何人都无法访问您的文档。

支持的格式

• 编辑：DOCM、DOCX、DOTM、DOTX、XLSB、XLSM、XLSX、XLTM、XLTX、POTM、POTX、PPSM、PPSX、PPTM、PPTX、PDF

• 查看：

  • WORD：DOC、DOCM、DOCX、DOT、DOTM、DOTX、EPUB、FB2、FODT、HTM、HTML、HWP、HWPX、MD、MHT、MHTML、ODT、OTT、PAGES、RTF、STW、SXW、TXT、WPS、WPT、XML
  • CELL：CSV、ET、ETT、FODS、NUMBERS、ODS、OTS、SXC、XLS、XLSM、XLSX、XLT、XLTM、XLTX
  • SLIDE：DPS、DPT、FODP、KEY、ODG、ODP、OTP、POT、POTM、POTX、PPS、PPSM、PPSX、PPT、PPTM、PPTX、SXI
  • PDF：DJVU、DOCXF、OFORM、OXPS、PDF、XPS
  • DIAGRAM：VSDM、VSDX、VSSM、VSSX、VSTM、VSTX

• 使用 Convert with ONLYOFFICE（使用 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。

  备注

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

9.12.1 版本的新增内容

已添加

• 管理员设置中添加了插件说明和实用链接

已更改

• 修复了在限制应用的群组访问权限时打开共享链接的问题
• 将通用的 Save success（保存成功）消息替换为每个设置部分专用的消息
• 将设置保存按钮的颜色更改为主色
• 在执行清除版本元数据之前显示确认对话框
• 使用 Download As（下载为）方法转换为图像类型时，下载文档的所有页面

完整的更改日志请见此处。

将 ONLYOFFICE 文档连接到 ownCloud

要求

• ONLYOFFICE 文档服务器 v7.0 或更高版本（服务器版或云版）

  您需要一个 ONLYOFFICE 文档 实例，该实例必须可以从 ownCloud 和所有终端客户端解析并连接。ONLYOFFICE 文档 必须能够直接向 ownCloud 发送 POST 请求。

  从 4.3.0 版本开始，ONLYOFFICE 文档 和 ownCloud 既可以安装在不同的计算机上，也可以安装在同一台机器上。如果您选择后一种方式，则需要为 ONLYOFFICE 文档 设置自定义端口，因为默认情况下 ONLYOFFICE 文档 和 ownCloud 都使用 80 端口。

  备注

  要了解有关安装 ONLYOFFICE 文档 的更多信息，请参阅官方文档页面。

• ownCloud v10.0.0 及更高版本

• 适用于 ownCloud 的 ONLYOFFICE 连接器 v8.2.3 及更高版本

安装适用于 ownCloud 的 ONLYOFFICE 连接器

ownCloud 管理员可以从内置应用市场安装集成应用。为此，请按照以下步骤操作：

1. 点击左上角的汉堡菜单。
2. 选择 Market（市场）。
3. 转到 Tools（工具）类别。
4. 在可用应用程序列表中找到 ONLYOFFICE。
5. 点击 Install（安装）按钮。

或者，管理员也可以手动安装该应用：

1. 获取适用于 ownCloud 的 ONLYOFFICE 应用。有几种方式可以做到这一点：

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

   • 或者，您也可以从 GitHub 上的应用发布页面下载最新的已签名版本。例如：

     tar -xvzf vX.X.X.tar.gz

     其中 vX.X.X 是所需的连接器版本。

     解压缩归档文件：

     tar -xvzf vX.X.X.tar.gz

     将文件夹重命名为 onlyoffice：

     mv onlyoffice-owncloud-X.X.X onlyoffice

   • 或者，您也可以克隆应用程序源代码并自行编译：

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

   备注

   ownCloud 不能使用未签名的应用程序，并会显示警告消息，因此您需要使用选项 a 或 b 来获取用于生产环境的应用程序。

2. 将 onlyoffice 文件夹移动到 ownCloud 服务器的 apps/ 目录（或其他用于连接应用程序的目录）：

   cp -r /root/onlyoffice/ /var/www/owncloud/apps/

3. 转到 apps/ 目录：

   cd /var/www/owncloud/apps

4. 更改所有者，以便直接从 ownCloud 网页界面更新应用程序：

   chown -R www-data:www-data onlyoffice

5. 在 ownCloud 中，转到 Settings（设置）> Admin（管理员）> Apps（应用），点击 Show disabled apps（显示已禁用的应用），然后为 ONLYOFFICE 应用点击 Enable（启用）。

配置适用于 ownCloud 的 ONLYOFFICE 连接器

要配置 ONLYOFFICE 应用设置，请转到 Settings（设置）> Admin（管理员）> Additional（其他）。

在 Server settings（服务器设置）部分，指定以下选项：

• ONLYOFFICE Docs address（ONLYOFFICE 文档地址）- 指定安装 文档编辑服务 的 URL 地址。此字段为必填项。如果您在自定义端口上安装 ONLYOFFICE 文档，则必须指定端口，例如：http://127.0.0.1:8081/

  备注

  ONLYOFFICE 文档 的地址必须可以从 ownCloud 访问，同时 ownCloud 的地址也必须可以从 ONLYOFFICE 文档 访问。

• Disable certificate verification (insecure)（禁用证书验证（不安全））- 如果您的 ONLYOFFICE 文档 使用自签名证书，请选中此框以禁用证书验证，并允许 ownCloud 与 ONLYOFFICE 文档 建立连接（否则，ownCloud 将不会验证自签名证书，也不允许与 ONLYOFFICE 文档 之间建立连接）。这是一种不安全的解决方案，我们强烈建议您将证书替换为由某个 CA 颁发的证书。

• Secret key（密钥）- 指定用于对数据进行签名的密钥。

  备注

  从 ONLYOFFICE 文档 v7.2 开始，JWT 默认启用，并且密钥会自动生成。您还需要在 ownCloud 端启用它：在 ONLYOFFICE 文档配置文件 中找到您的密钥，然后在连接器设置中指定相同的密钥。有关更多详细信息，请参阅本文的为 ONLYOFFICE 和 ownCloud 集成启用 JWT 部分。

• 如果您的网络配置不允许已安装的 ownCloud 和 ONLYOFFICE 文档 之间使用公共地址相互请求，可以使用 Advanced server settings（高级服务器设置）部分。在这种情况下，请在相应字段中指定用于内部请求的地址：

  • 在 ONLYOFFICE Docs address for internal requests from the server（服务器内部请求的 ONLYOFFICE 文档地址）字段中，指定从 ownCloud 访问 文档编辑服务 所用的地址。
  • 在 Server address for internal requests from ONLYOFFICE Docs（ONLYOFFICE 文档内部请求的服务器地址）字段中，指定从 文档编辑服务 访问 ownCloud 所用的地址。

点击 Save（保存）按钮。保存 Server settings（服务器设置）后，将出现 Common settings（常规设置）、Editor customization settings（编辑器自定义设置）和 Common templates（通用模板）部分。

在 Common settings（常规设置）部分，您可以指定以下选项：

• Restrict access to the editors to following groups（限制以下群组访问编辑器）- 选中此框并选择不允许在 ownCloud 中使用 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 格式。

  备注

  只有在此部分中选中的格式才会使用 ONLYOFFICE 编辑器打开。

• Open the file for editing（打开文件进行编辑）- 允许管理员选择通过转换为 OOXML 格式来编辑的文档格式。默认选中 csv 和 txt 格式。

  重要

  由于格式限制，保存为列表中的格式（csv、odp、ods、odt、rtf、txt）时，可能会丢失部分数据。

  启用相应选项后，指定格式的文档在点击并选择 Open in ONLYOFFICE（在 ONLYOFFICE 中打开）菜单项后，将立即转换并在 ONLYOFFICE 编辑器中打开以供编辑。如果取消选中某个格式，则文件将以查看模式打开。

在 Editor customization settings（编辑器自定义设置）部分，您可以指定以下选项：

• Keep intermediate versions when editing (forcesave)（编辑时保留中间版本（强制保存））功能允许您在点击 ONLYOFFICE 编辑器界面中的 Save（保存）按钮时，将所有更改直接发送到存储，以防止数据丢失。禁用此选项后，您的更改会自动保存到编辑器缓存中。
• 选择要隐藏/显示的编辑器界面元素（Chat（聊天）、More compact header（更紧凑的标题）、Feedback & Support（反馈和支持）、Help（帮助）、Monochrome toolbar header（单色工具栏标题））。
• Review mode for viewing（查看时的审阅模式）功能允许您设置默认的文档审阅显示模式：
  • Markup（标记）- 突出显示建议的更改，
  • Final（最终状态）- 显示应用更改后的结果，
  • Original（原始状态）- 显示没有任何更改的原始文档。

对 Common settings（常规设置）和/或 Editor customization settings（编辑器自定义设置）进行更改后，请点击下方的 Save（保存）按钮以保存更改。

在 Common templates（通用模板）部分，您可以点击 图标，上传 docx、xlsx 或 pptx 模板用于创建新文档。

您可以使用相应图标从此列表中下载或删除模板。

在管理员设置中添加模板后，用户可以在使用 ownCloud 界面中的 add（添加）按钮，或通过 ONLYOFFICE 编辑器界面中的 File（文件）> Create new（新建）菜单创建新文档时选择模板。

检查连接

您可以使用以下 occ 命令检查与 ONLYOFFICE 文档 的连接：

occ onlyoffice:documentserver --check

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

工作原理

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

1. 创建新文件时，用户在 ownCloud 中导航到文档文件夹，然后点击 new (+)（新建 (+)）菜单中的 Document（文档）、Spreadsheet（电子表格）或 Presentation（演示文稿）项。

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

3. 打开现有文件时，用户在 ownCloud 中导航到该文件，然后选择 Open in ONLYOFFICE（在 ONLYOFFICE 中打开）菜单选项。

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

5. 应用会准备一个具有以下属性的 JSON 对象：

   • url - ONLYOFFICE 文档 用于下载文档的 URL；
   • callbackUrl - ONLYOFFICE 文档 用于通知文档编辑状态的 URL；
   • documentServerUrl - 客户端需要用来响应 ONLYOFFICE 文档服务器的 URL（可以在管理设置页面中设置）；
   • key - UUID+修改时间戳，用于指示 ONLYOFFICE 文档 是否需要再次下载该文档。

6. ownCloud 获取此对象，并基于 templates/editor.php 模板构建页面，填充所有必要的值，以确保客户端浏览器成功加载编辑器。

7. 客户端浏览器向 ONLYOFFICE 文档 的 JavaScript 库发出请求，并将带有上述属性的 DocEditor 配置发送给 ONLYOFFICE 文档。

8. 随后 ONLYOFFICE 文档 从 ownCloud 下载文档，用户开始编辑。

9. ONLYOFFICE 文档 向 callbackUrl 发送 POST 请求，以通知 ownCloud 有用户正在编辑该文档。

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

11. 在无活动 10 秒后，ONLYOFFICE 文档 向 callbackUrl 发送 POST 请求，通知 ownCloud 客户端已完成文档编辑并将其关闭。

12. ownCloud 下载文档的新版本，并替换旧版本。

为 ONLYOFFICE 和 ownCloud 集成启用 JWT

为了保护文档免遭未经授权的访问，ONLYOFFICE 编辑器使用 JSON Web 令牌（JWT）。令牌 会在文档编辑器初始化时以及 ONLYOFFICE 文档内部服务之间交换命令时添加到配置中。密钥 用于对 JSON Web 令牌进行签名，并在向 ONLYOFFICE 文档 发出请求时验证令牌。

从 ONLYOFFICE 文档 v7.2 开始，JWT 默认启用，并且密钥会自动生成。您需要在 ONLYOFFICE 文档配置文件 中找到您的密钥，然后在连接器设置中指定相同的密钥。

步骤 1：在 ONLYOFFICE 文档配置文件 中找到您的密钥

1. 使用任意可用的文本编辑器打开 local.json 文件。

   • 对于 Linux - /etc/onlyoffice/documentserver/local.json

   • 对于 Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

   • 对于 Docker - 使用 docker exec -it <containerID> bash 命令进入 ONLYOFFICE 文档容器，然后打开 /etc/onlyoffice/documentserver/local.json

     或者，您也可以使用以下命令查找默认密钥，而无需打开 local.json：

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   local.json 文件应如下所示：

   {
     "services": {
       "CoAuthoring": {
         "token": {
           "enable": {
             "request": {
               "inbox": true,
               "outbox": true
             },
             "browser": true
           }
         },
         "secret": {
           "inbox": {
             "string": "yoursecret"
           },
           "outbox": {
             "string": "yoursecret"
           },
           "session": {
             "string": "yoursecret"
           }
         }
       }
     }
   }

2. 三个部分中均指定了 true 值，这表示已启用令牌验证。

   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox

3. 自动生成的密钥在三个部分中指定。您可以将默认密钥值替换为您自己的密钥。三个部分中的密钥必须相同。

   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string

4. 如果您进行了更改，请保存并重启服务，以使配置更改生效。

   supervisorctl restart all

步骤 2：在连接器设置中指定相同的密钥

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

连接到演示版 ONLYOFFICE 文档

从 ONLYOFFICE 连接器 3.0.1 版本开始，您无需安装 ONLYOFFICE 文档，即可在 ownCloud 中试用 ONLYOFFICE 在线编辑器。

要启用连接，请选中 Connect to demo ONLYOFFICE Docs server（连接到演示版 ONLYOFFICE 文档服务器）复选框，然后点击 Save（保存）按钮。

重要

这是一个公共测试服务器，可使用 30 天。请勿在其中共享您的敏感数据。

使用 Docker Compose 安装 ONLYOFFICE 文档和 ownCloud

使用 Docker Compose，您可以快速轻松地部署预配置的、已连接到 ownCloud 的 ONLYOFFICE 文档，并将所有必需的依赖项放在 Docker 容器中。

安装 Docker 和 Docker Compose

1. 请按照此说明将 Docker 下载并安装到您的计算机上。Docker 是一个在支持容器的环境中实现应用程序开发和管理自动化的程序。
2. 然后按照此说明下载并安装 Docker Compose 包管理器，它可以让您描述并运行多容器应用程序。

安装 ONLYOFFICE 文档和 ownCloud 服务器

1. 下载最新版本的 docker-onlyoffice-owncloud 仓库。为此，请在命令行界面中输入以下命令：

   git clone --recursive https://github.com/ONLYOFFICE/docker-onlyoffice-owncloud

2. 仓库下载完成后，转到 docker-onlyoffice-owncloud 文件夹：

   cd docker-onlyoffice-owncloud

3. 更新仓库中的子模块：

   git submodule update --remote

4. 启动 Docker Compose：

   sudo docker-compose up -d

   备注

   执行上述命令后，您可能需要等待几分钟，直到所有容器启动并运行。

在浏览器地址栏中输入 http://localhost 以打开 ownCloud 设置页面并创建您的管理员账户。输入您的 Login（登录名）和 Password（密码）（默认情况下，两个字段均使用 admin）。

现在，您无需配置任何设置，即可使用 ONLYOFFICE 文档 在 ownCloud 中创建和编辑文档。

服务器设置在部署期间已指定，但您可以调整 Common settings（常规设置）、Editor customization settings（编辑器自定义设置）和 Common templates（通用模板）。要了解有关可用连接器设置的更多信息，请参阅配置适用于 ownCloud 的 ONLYOFFICE 连接器部分。

使用 UCS 在虚拟机上安装 ONLYOFFICE 文档和 ownCloud

由 Univention 推出的应用设备是一种分发格式，可以安装已预装 ONLYOFFICE 文档 和 ownCloud 等组件的系统。

Univention 是一家开源企业基础设施开发商，它推出了一种便捷的方法来安装已配备第三方组件的系统，即虚拟应用设备。这些是 VirtualBox 或 VMware 镜像，其中包含应用、UCS 管理系统和 UCS 运行时环境。

以下虚拟镜像包含 Univention Corporate Server、ownCloud 和 ONLYOFFICE。这些应用开箱即用，并带有额外创建的自动配置，可确保 ownCloud 中所需的 ONLYOFFICE 附加组件配置正确。安装过程比传统的手动方法简单得多：管理员无需执行任何手动步骤。

下载必要的组件

首先，您需要为虚拟机安装虚拟机管理程序。请在 VMware Workstation Pro 或 VirtualBox 之间选择，并按照文档中的详细安装说明进行操作。

然后为您选择的虚拟机管理程序下载 ONLYOFFICE-ownCloud VM。

导入虚拟设备

现在打开虚拟机管理程序并导入 ONLYOFFICE-ownCloud 虚拟设备。本指南介绍了如何在这两个平台上执行此操作。

安装应用程序

镜像成功导入后，启动 虚拟机。按照以下步骤，通过安装向导完成启动过程。

1. 选择您的语言并输入最近的城市。

   

   向导将获取默认的系统区域设置、时区和键盘布局。

   

2. 设置您的域和网络设置。默认情况下，您会自动获取 IP 地址。或者，您也可以手动指定您的 IP 地址、子网掩码和网关。输入首选 DNS 服务器的地址。

   

3. 选择您的域设置。默认选中 Manage users and permissions directly on this system（直接在此系统上管理用户和权限）选项。它允许在此系统中创建新域。或者，您也可以连接到现有的 UCS 或 Microsoft Active Directory 域。

   

4. 输入您的公司名称、用于激活 ONLYOFFICE 的管理员电子邮件地址（许可证文件将发送到该电子邮件地址），并为您的管理员账户创建并确认新密码。

   

5. 指定此系统的完全限定域名和 LDAP 基础：

   

6. 检查您的设置，确保所有内容均已正确填写。然后点击 Configure System（配置系统）按钮。

   

7. 一切配置完成后，ONLYOFFICE 即可在新创建的 UCS 平台中启动。

   

   

8. 在浏览器地址栏中输入您的 IP 地址，并上传通过电子邮件收到的 ucs.license 文件。

9. 要登录您的 ONLYOFFICE 文档 和 ownCloud 设备，请点击 Applications（应用程序）部分中的 ownCloud，并输入默认的用户名和密码（owncloud、owncloud）。

   要登录您的 Univention Management Console，请点击顶部的 LOGIN，或点击 Administration（管理）部分中的 System and domain settings（系统和域设置），然后输入您的管理员电子邮件地址和注册时指定的密码（请参阅步骤 4）。

   

为 ownCloud Web 启用编辑

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

• 如果您从官方应用市场安装了 ownCloud Web，则路径为

  owncloud-root-catalog

• 如果您使用此说明自行从源代码编译，则路径为

  owncloud-web-root-catalog/config/config.json

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

"external_apps": [
    {
    "id": "onlyoffice",
    "path": "http(s):///custom/onlyoffice/js/web/onlyoffice.js"
    }
    ]

根据您的 Web 服务器配置，您可以从 URL 路径中去掉 index.php 部分。

在 ownCloud 中开始使用 ONLYOFFICE 文档

要 创建 文档：

1. 在 ownCloud 中打开所需的文件夹。

2. 点击 add（添加）按钮。

3. 选择所需的文件类型：文档、电子表格或演示文稿。

   

4. 输入文档名称并按 Enter 键。

5. 可选。如果管理员添加了一些模板，请选择所需的模板并点击 Create（创建）。

   

要打开文档进行 编辑或查看：

1. 打开包含所需文档的文件夹。

2. 点击 more（更多）按钮或文档标题。

3. 点击 Open in ONLYOFFICE（在 ONLYOFFICE 中打开）选项。

   

要将文档 转换 为 Office Open XML 格式：

1. 打开包含所需文档的文件夹。

2. 点击 more（更多）按钮或文档标题。

3. 点击 Convert with ONLYOFFICE（使用 ONLYOFFICE 转换）选项。

   

   备注

   请参阅可转换为 OOXML 的格式的完整列表。

   ODT、ODS、ODP 和 RTF 格式也可以即时转换。如果在管理员设置中启用了相应选项，则指定格式的文档在点击并选择 Open in ONLYOFFICE（在 ONLYOFFICE 中打开）菜单项后，将立即转换并在 ONLYOFFICE 编辑器中打开以供编辑。

将 ONLYOFFICE 桌面编辑器连接到 ownCloud

ONLYOFFICE 允许您使用 在线 和 桌面编辑器 编辑存储在 ownCloud 账户中的文件并进行协作。因此，您不仅可以使用在线协作工具，还可以使用仅在桌面应用程序中提供的功能：

• 使用密码或数字签名保护文档，
• 使用 Send（发送）插件直接从编辑器发送当前正在编辑的文件，
• 通过 演示文稿编辑器 插入音频和视频。

备注

假定您已经安装并配置了 ownCloud 服务器、ONLYOFFICE 文档 和 集成应用。

启动 ONLYOFFICE 桌面编辑器。要将 桌面编辑器 连接到您的 ownCloud 服务器，请执行以下操作：

1. 切换到左侧面板中的 Connect to cloud（连接到云）部分。

2. 点击 ownCloud 云服务按钮。或者，您也可以使用底部的 Connect now（立即连接）链接。

   

3. 如果您点击了 ownCloud 服务按钮，将打开 Connect to cloud office（连接到云办公室）窗口，并已选中 ownCloud。如果您使用了 Connect now（立即连接）链接，请从下拉列表中选择 ownCloud 云存储。

   • 在 Cloud office URL（云办公室 URL）字段中，输入您的 ownCloud 服务器域名或 IP 地址。准备就绪后，点击 Connect now（立即连接）按钮。

     

   • ownCloud 登录页面将在 桌面编辑器 界面的新标签页中打开。

     • 指定您用于访问 ownCloud 账户的 Username or email（用户名或电子邮件）和 Password（密码）。
     • 点击 Log in（登录）按钮。

     

您的 ownCloud 账户的 Files（文件）部分将会打开。现在，您可以使用 ONLYOFFICE 编辑器编辑现有文件并创建新文件、共享文档，并与 ownCloud 用户协作。

要了解有关管理已连接账户的更多信息，请参阅此说明。

在 iOS 或 Android 上将 ONLYOFFICE 文档连接到 ownCloud

您可以将 ownCloud 连接到 ONLYOFFICE 文档 移动应用，随时随地处理 ownCloud 中的文档、电子表格和演示文稿并协作编辑。

备注

假定您已经安装并配置了 ownCloud 服务器、ONLYOFFICE 文档 和 集成应用。

要在移动设备上将 ONLYOFFICE 连接到 ownCloud，请下载并安装最新版本的 适用于 iOS 的 ONLYOFFICE 文档应用或适用于 Android 的 ONLYOFFICE 文档应用程序，然后执行以下操作：

1. 转到 Clouds（云）部分。
2. 选择 ownCloud。
3. 在 Connection URL（连接 URL）字段中输入您的 ownCloud 服务器 的 URL 地址。
4. 输入您的 ownCloud 账户的登录名和密码。
5. 点击 Next（下一步）。

要在移动设备上使用 ONLYOFFICE 文档 编辑 ownCloud 中的文档，请在文件列表中点击所需的文件名。

已知问题

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

• 加密文件存储。ownCloud 提供了加密文件存储的选项。但是，如果启用了使用 per-user encryption keys（每用户加密密钥）的加密（ownCloud Default encryption module（默认加密模块）应用默认使用此方式），ONLYOFFICE 文档 将无法打开加密文件进行编辑，也无法在编辑后保存这些文件。管理设置页面的 ONLYOFFICE 部分会显示相关通知。但是，如果您设置使用 master key（主密钥）的加密，ONLYOFFICE 应用将正常工作。有关启用基于 master key 的加密的说明，请参阅 ownCloud 网站上的官方文档。

  重要

  ownCloud 建议仅在没有现有数据的全新安装上，或尚未启用加密的系统上使用 master encryption key（主加密密钥），因为在对这些文件启用基于 master key 的加密后，您之前使用 per-user encryption keys 加密的文件 可能会永久丢失。

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

  1. 在您的 ownCloud 中，勾选 ONLYOFFICE 管理页面“服务器设置”部分中的 Disable certificate verification (insecure)（禁用证书验证（不安全））复选框。

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

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

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

     备注

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

• 联合云共享。如果使用 Federated Cloud Sharing（联合云共享）应用共享文档，则连接到不同 ONLYOFFICE 服务器的 ownCloud 实例之间将无法进行共同编辑。来自同一个 文档服务器 的用户可以在共同编辑模式下编辑文档，但来自两个（或更多）不同文档服务器的用户将无法实时协作处理同一文档。

• 转换文件。ONLYOFFICE 文档在打开和编辑文件时以 Office Open XML 格式为基础。如果文件格式不是 OOXML，仍会将其转换为相应的 OOXML，以确保文档服务器正常工作并提高性能。之后您可以编辑该文件，进行基础 OOXML 格式可用的任何更改，并将文件保存为该基础 OOXML 格式。

  如果 ownCloud 源文件格式与基础格式不同，而您仍希望将其保存为原始格式，则文件将从 OOXML 转换为该格式。由于这些格式本质上不同，某些数据（如图表、表格、自选图形或图像）和格式可能会丢失，原因很简单：某些格式（csv、txt 等）不支持这些内容，或对它们的处理方式与 OOXML 标准不同。因此，默认情况下所有非 OOXML 文件均仅以查看模式打开，但上下文菜单中提供了转换文件的选项。如果您了解转换后数据/格式丢失的风险，但仍希望打开非 OOXML 文件进行编辑，可以在设置的列表中勾选它们。默认情况下，csv 和 txt 文件可以进行编辑。

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

备注

要了解有关最常见问题及其解决方法的更多信息，请访问我们的故障排除指南。