Nextcloud

关于 ONLYOFFICE 和 Nextcloud 集成

ONLYOFFICE 提供官方连接器，用于将 ONLYOFFICE 文档与 Nextcloud 集成，并在云存储中编辑办公文档。您可以从 Nextcloud 应用商店或 ONLYOFFICE GitHub 页面下载 ONLYOFFICE 连接器。该连接器根据 AGPL-3.0 许可证分发。

备注

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

主要功能

创建、编辑和查看文档、电子表格和演示文稿。
创建和填写在线表单。
与其他用户共享文件。
通过拖放在 Talk 聊天中共享文件。
使用水印保护文档。
实时协同编辑文档：两种协同编辑模式（快速和严格）、修订、批注和内置聊天。
在连接到同一个文档服务器的多个联合 Nextcloud 实例之间进行协同编辑。
JWT 支持，用于保护您的流量，使除具有适当权限的用户之外的任何人都无法访问您的文档。
通过 Nextcloud Mail 提供程序直接执行邮件合并并发送个性化电子邮件。

支持的格式

查看：
- 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
编辑：
- WORD：DOCM、DOCX、DOTM、DOTX
- CELL：XLSB、XLSM、XLSX、XLTM、XLTX
- SLIDE：POTM、POTX、PPSM、PPSX、PPTM、PPTX
- PDF：PDF

10.1.0 版本的新增功能

新增

通过 Nextcloud Mail 提供程序发送邮件合并电子邮件
管理员可以限制外部存储中的文件使用 ONLYOFFICE 的设置
通过 Nextcloud Teams（原 Circles）共享的文件支持高级文档权限：审阅、批注、自定义筛选和表单填写

变更

兼容 Nextcloud 34
改进了通过共享链接打开文档的支持
修复了禁用管理员重新共享时的权限相关问题
改进了文档和模板 URL 的处理

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

将 ONLYOFFICE 文档连接到 Nextcloud

要求

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

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

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

备注
请参阅官方文档页面，了解有关安装 ONLYOFFICE 文档的更多信息。
Nextcloud v32（该连接器兼容 Nextcloud 直至 v34）
适用于 Nextcloud 的 ONLYOFFICE 连接器 v10.1.0 及更高版本

安装适用于 Nextcloud 的 ONLYOFFICE 连接器

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

点击用户名并选择应用。
转到工具类别。
在可用应用列表中找到 ONLYOFFICE。
点击下载并启用按钮。

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

获取 Nextcloud ONLYOFFICE 集成应用。有几种方法可以做到这一点：
1. 从官方 Nextcloud 商店下载最新的签名版本。
2. 从 GitHub 上的应用发布页面下载最新的签名版本。例如：
```
wget https://github.com/ONLYOFFICE/onlyoffice-nextcloud/archive/refs/tags/vX.X.X.tar.gz
```
  其中 vX.X.X 是所需的连接器版本。
  
  解压缩存档，例如：
```
tar -xvzf vX.X.X.tar.gz
```
  将文件夹重命名为 onlyoffice，例如：
```
mv onlyoffice-nextcloud-X.X.X onlyoffice
```
3. 克隆应用源代码并自行编译：
```
git clone https://github.com/ONLYOFFICE/onlyoffice-nextcloud.git onlyoffice
cd onlyoffice
git submodule update --init --recursive
```
将 onlyoffice 文件夹移动到 Nextcloud 服务器的 apps/ 目录（或用于连接应用的其他目录）：
```
cp -r /root/onlyoffice/ /var/www/html/apps/
```
转到 apps/ 目录：
```
cd /var/www/html/apps
```
更改所有者，以便直接从 Nextcloud 网页界面更新应用：
```
chown -R www-data:www-data onlyoffice
```
在 Nextcloud 中，转到设置 > 应用 > 已禁用的应用，然后点击 ONLYOFFICE 应用的启用。

ONLYOFFICE 文档和 Nextcloud 可以安装在不同的计算机上，也可以安装在同一台机器上。如果选择后一种方式，则需要为文档服务器设置自定义端口，因为默认情况下 ONLYOFFICE 文档和 Nextcloud 都使用 80 端口。您也可以在代理后面使用文档服务器，请参阅本文了解如何配置。

配置适用于 Nextcloud 的 ONLYOFFICE 连接器

要配置 ONLYOFFICE 应用设置，请转到设置 > 管理 > ONLYOFFICE。

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

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

备注
ONLYOFFICE 文档的地址必须可从 Nextcloud 访问，同样 Nextcloud 的地址也必须可从 ONLYOFFICE 文档访问。
禁用证书验证（不安全） - 如果您的 ONLYOFFICE 文档使用自签名证书，请选中此框以禁用证书验证，并允许 Nextcloud 与 ONLYOFFICE 文档建立连接（否则，Nextcloud 将不会验证自签名证书，也不允许与 ONLYOFFICE 文档之间建立连接）。这是一种不安全的解决方案，我们强烈建议您将证书替换为由某个 CA 颁发的证书。
密钥 - 指定用于签署数据的密钥。

备注
从 ONLYOFFICE 文档 v7.2 开始，默认启用 JWT，并自动生成密钥。您还需要在 Nextcloud 端启用它：在 ONLYOFFICE 文档配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。有关详细信息，请参阅本文的为 ONLYOFFICE 和 Nextcloud 集成启用 JWT部分。
如果您的网络配置不允许已安装的 Nextcloud 和 ONLYOFFICE 文档之间使用公共地址发送请求，可以使用高级服务器设置部分。在这种情况下，请在相应字段中指定内部请求的地址：
- 在来自服务器的内部请求的 ONLYOFFICE 文档地址字段中，指定用于从 Nextcloud 访问文档编辑服务的地址。
- 在来自 ONLYOFFICE 文档的内部请求的服务器地址字段中，指定用于从文档编辑服务访问 Nextcloud 的地址。

Settings

点击保存按钮。保存服务器设置后，将显示通用设置、编辑器自定义设置、通用模板和安全视图设置部分。

在通用设置部分，您可以指定以下选项：

允许以下组访问编辑器 - 选中此框并选择允许在 Nextcloud 中使用 ONLYOFFICE 编辑器的用户组。
限制外部存储中的文件使用 ONLYOFFICE - 选中此框可防止用户通过 ONLYOFFICE 打开或编辑存储在外部存储位置的文件。这使管理员可以更好地控制可以打开和编辑文档的位置，对于具有严格安全或合规要求的环境非常有用。
使用 ONLYOFFICE 生成文档预览 - 选中此框可通过 ONLYOFFICE 生成缩略图。这将占用一些磁盘空间。
在同一选项卡中打开文件 - 选中此框可在当前浏览器选项卡中打开文件。如果取消选中此选项，文件将在新的浏览器选项卡中打开。
使用 ONLYOFFICE 文档提供高级文档权限 - 选中此框，即可在文档面板的高级选项卡中以及对通过 Nextcloud Teams（原 Circles）共享的文件指定额外权限：文本文档的审阅和批注，电子表格的批注和自定义筛选，以及 PDF 表单的表单填写。有关详细信息，请参阅本文的在 Nextcloud 中开始使用 ONLYOFFICE 文档部分。
编辑文档后保留每个版本的元数据 此功能可以保留元数据，并在版本历史记录中显示每个文档版本的更改。这将占用一些磁盘空间。您可以使用清除按钮删除元数据并释放磁盘空间。
打开格式的默认应用程序 - 允许您指定要与 ONLYOFFICE 编辑器关联的格式。默认选中 docx、xlsx 和 pptx 格式。

备注
仅对本部分中选中的格式使用 ONLYOFFICE 编辑器打开。
打开文件进行编辑 - 允许管理员选择通过转换为 OOXML 格式进行编辑的文档格式。默认选中 csv 和 txt 格式。

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

启用相应选项后，指定格式的文档在点击后将立即转换，并在 ONLYOFFICE 编辑器中打开进行编辑。如果某个格式未选中，则文件将以查看模式打开。

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

如果要防止数据丢失， 编辑时保留中间版本（强制保存） 功能允许您在 ONLYOFFICE 编辑器界面中点击保存按钮时将所有更改直接发送到存储。禁用此选项后，您的更改将自动保存到编辑器缓存中。
选择要隐藏/显示的编辑器界面元素（聊天、更紧凑的标题、反馈和支持、帮助、单色工具栏标题）。
查看时的审阅模式功能允许您设置默认的文档审阅显示模式：
- 标记 - 突出显示建议的更改，
- 最终 - 显示应用更改后的文档，
- 原始 - 显示没有任何更改的原始文档。
默认编辑器主题功能允许您设置默认主题：浅色、经典浅色或深色。

Settings

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

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

Settings

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

在安全部分，您可以通过嵌入水印来保护文档，还可以禁用或启用宏的运行。

更改应用设置后，点击每个部分下方的保存按钮以保存更改。

检查连接

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

occ onlyoffice:documentserver --check

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

工作原理

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

创建新文件时，用户在 Nextcloud 中导航到文档文件夹，然后点击新建 (+) 菜单中的文档、电子表格或演示文稿项。
浏览器调用 /lib/Controller/EditorController.php 控制器中的 create 方法。此方法将 assets 文件夹中的文件副本添加到用户当前所在的文件夹中。
打开现有文件时，用户在 Nextcloud 中导航到该文件，并选择在 ONLYOFFICE 中打开菜单选项。
将打开一个新的浏览器选项卡，并调用 /lib/Controller/EditorController.php 控制器的 index 方法。
应用准备一个具有以下属性的 JSON 对象：
- url - ONLYOFFICE 文档用于下载文档的 URL；
- callbackUrl - ONLYOFFICE 文档用于通知文档编辑状态的 URL；
- documentServerUrl - 客户端与 ONLYOFFICE 文档服务器通信所需使用的 URL。（可在管理设置页面中设置）；
- key - UUID+修改时间戳，用于指示 ONLYOFFICE 文档是否需要再次下载文档。
Nextcloud 获取此对象，并根据 templates/editor.php 模板构建页面，填入所有这些值，以便客户端浏览器可以加载编辑器。
客户端浏览器向 ONLYOFFICE 文档的 JavaScript 库发出请求，并向 ONLYOFFICE 文档发送包含上述属性的 DocEditor 配置。
然后 ONLYOFFICE 文档从 Nextcloud 下载文档，用户开始编辑。
ONLYOFFICE 文档向 callbackUrl 发送 POST 请求，通知 Nextcloud 有用户正在编辑文档。
当所有用户和客户端浏览器完成编辑后，它们将关闭编辑窗口。
在 10 秒无操作后，ONLYOFFICE 文档向 callbackUrl 发送 POST 请求，让 Nextcloud 知道客户端已完成文档编辑并已将其关闭。
Nextcloud 下载文档的新版本，替换旧版本。

为 ONLYOFFICE 和 Nextcloud 集成启用 JWT

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

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

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

使用任何可用的文本编辑器打开 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"
        }
      }
    }
  }
}

在三个部分中指定了 true 值。这意味着已启用令牌验证。
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
自动生成的密钥在三个部分中指定。您可以将默认密钥值替换为您自己的密钥。三个部分中的密钥必须相同。
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
如果您进行了更改，请保存并重新启动服务，以使配置更改生效。
- Linux：
```
sudo supervisorctl restart all
```
- Docker：
```
docker exec <containerID> supervisorctl restart all
```
  或重新启动整个容器：
```
docker restart <containerID>
```

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

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

连接到演示版 ONLYOFFICE 文档

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

要开启连接，请点击连接到演示版 ONLYOFFICE 文档服务器复选框，然后点击保存按钮。

重要

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

使用 Docker Compose 安装 ONLYOFFICE 文档与 Nextcloud

通过 Docker Compose，您可以快速轻松地部署与 Nextcloud 连接的预配置版本的 ONLYOFFICE 文档，并在 Docker 容器中包含所有必需的依赖项。

安装 Docker 和 Docker Compose

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

安装 ONLYOFFICE 文档和 Nextcloud 服务器

下载最新版本的 docker-onlyoffice-nextcloud 仓库。为此，请在命令行界面中插入以下行：
```
git clone https://github.com/ONLYOFFICE/docker-onlyoffice-nextcloud
```
仓库下载完成后，进入 docker-onlyoffice-nextcloud 文件夹：
```
cd docker-onlyoffice-nextcloud
```
启动 Docker Compose：
```
sudo docker-compose up -d
```
备注
在上面的命令执行后，您可能需要等待几分钟，直到所有容器启动并运行。

在浏览器地址栏中输入 http://localhost 以打开 Nextcloud 设置页面并创建您的管理员帐户。指定您的登录名和密码。

完成向导后，进入 docker-onlyoffice-nextcloud 文件夹并运行配置脚本：

sudo bash set_configuration.sh

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

服务器设置在部署期间指定，但您可以调整通用设置、编辑器自定义设置、通用模板和安全视图设置。请参阅配置适用于 Nextcloud 的 ONLYOFFICE 连接器部分以了解更多可用的连接器设置。

使用 UCS 在虚拟机上安装 ONLYOFFICE 文档与 Nextcloud

Univention 引入的应用程序设备是一种分发格式，允许安装已经打包了组件的系统，例如 ONLYOFFICE 文档和 Nextcloud。

Univention 是一个开源企业基础设施开发者，推出了一种方便的方法来安装已经配备第三方组件的系统——虚拟应用设备。这些是包含应用程序、UCS 管理系统和 UCS 运行环境的 VirtualBox 或 VMware 映像。

以下虚拟映像包含 Univention 企业服务器、Nextcloud 和 ONLYOFFICE。这些应用程序开箱即用，并附带自动配置，确保 Nextcloud 中所需的 ONLYOFFICE 插件配置正确。安装过程比传统的手动方法更简单：管理员无需手动步骤。

下载必要的组件

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

然后下载适用于您选择的虚拟机管理程序的 ONLYOFFICE-Nextcloud VM。

UCS step 1

导入虚拟设备

现在打开虚拟机管理程序并导入 ONLYOFFICE-Nextcloud 虚拟设备。本指南描述了如何在两个平台上进行此操作。

安装应用程序

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

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

向导将获取默认的系统语言环境、时区和键盘布局。
设置您的域和网络设置。默认情况下，您会自动获取 IP 地址。或者，您可以手动指定您的 IP 地址、网络掩码和网关。输入首选 DNS 服务器的地址。
选择您的域设置。默认情况下选择直接在此系统上管理用户和权限选项。它允许在此系统中创建新域。或者，您可以连接到现有的 UCS 或 Microsoft Active Directory 域。
输入您的公司名称、用于激活 ONLYOFFICE 的管理员电子邮件地址（许可证文件将发送到此电子邮件地址），创建并确认您的管理员帐户的新密码。
指定此系统的完全限定域名和 LDAP 基础：
检查您的设置并确保所有内容填写正确。然后点击配置系统按钮。
一旦一切配置完毕，ONLYOFFICE 就可以在新创建的 UCS 平台上启动。
在浏览器地址栏中输入您的 IP 地址并上传通过电子邮件收到的 ucs.license 文件。
要登录您的 ONLYOFFICE 文档和 Nextcloud 设备，请在应用程序部分中点击 Nextcloud。

要登录您的 Univention 管理控制台，请点击顶部的登录或管理部分中的系统和域设置。

在登录字段中输入管理员，并输入注册时指定的密码（参见步骤 4）。

在 Nextcloud 中开始使用 ONLYOFFICE 文档

要创建文档：

打开 Nextcloud 中所需的文件夹。
点击添加按钮。
选择所需的文件类型：文档、电子表格或演示文稿。
输入文档名称并按 Enter 键。
可选。如果管理员添加了一些模板，选择必要的模板并点击创建。

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

打开包含所需文档的文件夹。
点击文档标题。

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

打开包含所需文档的文件夹。
点击更多按钮。
点击使用 ONLYOFFICE 转换选项。

备注
查看可以转换为 OOXML 的格式的完整列表。

要创建表单模板：

打开 Nextcloud 中所需的文件夹。
点击添加按钮。
选择新建表单模板选项。
输入文档名称并按 Enter 键。
选择是要从文本文档创建表单还是从空白开始。
您将被重定向到相应的 ONLYOFFICE 编辑器。
将表单模板保存为 .pdf 以便将来进行编辑、修订或协作。

要创建可填写表单并限制其他用户编辑文件：

点击文件右侧的操作图标并选择创建表单选项。

要填写表单：

点击文件右侧的操作图标并选择在 ONLYOFFICE 中填写表单选项。

备注

要了解更多关于表单的信息，请阅读相关的创建和填写表单的文章。

要通过 Nextcloud Mail 发送邮件合并电子邮件：

打开要用作邮件合并模板的文档，并切换到协作选项卡。
点击邮件合并并选择包含收件人的数据源。
在邮件合并面板中，选择合并到 > 电邮。
选择 Nextcloud mail，以直接通过您的 Nextcloud Mail 帐户发送个性化电子邮件。

备注

要了解有关邮件合并功能的更多信息，请阅读相应指南。

要与 Nextcloud 用户共享文档：

打开 Nextcloud 中所需的文件夹并找到所需文件。点击文件名右侧的共享图标。

或者，您可以打开文件进行编辑，切换到编辑器界面的协作选项卡，并点击顶部工具栏上的共享按钮。

右侧将打开共享选项卡。
在 名称、电子邮件或联合云 ID … 字段中输入必要的数据并选择所需的用户。
点击用户名右侧的图标以打开弹出菜单。
要提供完全访问权限，请保持允许编辑选项勾选。用户将拥有完全访问权限，并可以编辑文件。
要提供只读权限，请取消勾选允许编辑选项。用户将拥有只读权限，无法编辑文件。
要提供重新共享文件的能力，请保持允许重新共享选项勾选。用户将能够与其他用户共享文件。
要仅为不能重新共享文件的用户提供额外权限，请取消勾选允许重新共享选项（您可能还需要取消勾选允许编辑选项）。

备注
必须在 ONLYOFFICE 应用程序的常规设置部分启用使用 ONLYOFFICE 文档提供高级文档权限。

切换到高级选项卡并点击用户名右侧的图标。根据文件类型和共享选项卡中勾选/未勾选的允许编辑选项选择必要的选项。

备注
请务必取消勾选共享选项，否则高级共享设置将不可用。
- 对于 .docx 文件和具有完全访问权限的用户，您可以选择以下权限：审阅或评论。
- 对于 .xlsx 文件和具有完全访问权限的用户，您可以选择以下权限：评论或自定义筛选器。
- 对于 .pptx 文件和具有完全访问权限的用户，您可以选择以下权限：评论。
- 对于 .pdf 表单和具有编辑权限的用户，您可以选择表单填写权限，让他们在不更改原始文件结构的情况下填写表单。
  
  备注
  也可以用同样的方式为通过 Nextcloud Teams（原 Circles）共享的文件设置高级文档权限。

连接 ONLYOFFICE 桌面编辑器到 Nextcloud

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

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

备注

假设您已经安装并配置了 Nextcloud 服务器、ONLYOFFICE 文档和集成应用程序。

启动 ONLYOFFICE 桌面编辑器

要将桌面编辑器连接到您的 Nextcloud 服务器，请执行以下操作：

切换到左侧面板的连接到云部分。
点击 Nextcloud 云服务按钮。或者，您可以使用底部的立即连接链接。
如果您按下了 Nextcloud 服务按钮，将打开连接到云 Office 窗口，并选择 Nextcloud。如果您使用了立即连接链接，请从下拉列表中选择 Nextcloud 云存储。
- 在云 office 网址字段中，输入您的 Nextcloud 服务器域名或 IP 地址。准备好后，点击立即连接按钮。
- Nextcloud 登录页面将在桌面编辑器界面的新选项卡中打开。
  - 指定您用于访问 Nextcloud 帐户的用户名或电子邮件和密码，
  - 点击登录按钮。

您的 Nextcloud 帐户的文件部分将打开。现在您可以编辑现有文件并创建新文件，与 Nextcloud 用户共享文档并协作使用 ONLYOFFICE 编辑器。

在 iOS 或 Android 上连接 ONLYOFFICE 文档到 Nextcloud

您可以将 Nextcloud 连接到 ONLYOFFICE 文档移动应用程序，以便在移动中协作编辑 Nextcloud 文档、电子表格和演示文稿。

备注

假设您已经安装并配置了 Nextcloud 服务器、ONLYOFFICE 文档和集成应用程序。

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

进入云部分。
选择 Nextcloud。
在连接 URL 字段中插入您的 Nextcloud 服务器的 URL 地址。
输入您的 Nextcloud 帐户的登录名和密码。
按下一步。

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

已知问题

连接外部存储。在某些情况下，使用外部存储应用程序添加存储在协同编辑中存在问题。如果连接使用相同的授权密钥（选择用户名和密码或全局凭据身份验证类型），则用户可以进行协同编辑。如果使用不同的授权密钥（登录凭据、保存到数据库或用户输入、存储到数据库身份验证选项），则无法进行协同编辑。当使用登录凭据、保存到会话身份验证类型时，文件无法在编辑器中打开。
验证证书。如果您为您的文档服务器使用自签名证书，Nextcloud 将不会验证此类证书，并且不允许与文档服务器建立连接。此问题可以通过两种方式解决：
1. 在 Nextcloud 的 ONLYOFFICE 管理 页面的服务器设置部分，勾选 禁用证书验证（不安全） 框。
2. 手动更改 Nextcloud 配置文件。找到 Nextcloud 配置文件（/nextcloud/config/config.php）并打开它。插入以下部分：
```
'onlyoffice' => array (     'verify_peer_off' => true )
```
  这将禁用证书验证，并允许 Nextcloud 与文档服务器建立连接。
  
  备注
  请记住，这只是一个临时的不安全解决方案，我们强烈建议您用一些 CA 颁发的证书替换该证书。一旦您这样做，请不要忘记取消勾选相应的设置框或从 Nextcloud 配置文件中删除上述部分。
联合云共享。如果使用联合云共享应用程序共享文档，则连接到不同 ONLYOFFICE 服务器的 Nextcloud 实例之间将无法进行协同编辑。来自同一个文档服务器的用户可以在协同编辑模式下编辑文档，但来自两个（或更多）不同文档服务器的用户将无法实时协作编辑同一文档。
转换文件。ONLYOFFICE 文档在打开和编辑文件时使用 Office Open XML 格式作为基础。如果文件格式与 OOXML 不同，它仍将被转换为相应的 OOXML 以提高文档服务器的高效操作和更快的性能。之后，您可以编辑文件，进行任何可用于基础 OOXML 格式的更改，并将文件保存为此基础 OOXML 格式。
如果源 Nextcloud 文件格式与基础格式不同，并且您仍希望将其保存为原始格式，文件将从 OOXML 转换为此格式。由于格式本质上不同，一些数据（如图表、表格、自动形状或图像）和格式可能会丢失，因为某些格式（如 csv、txt 等）不支持它们或与 OOXML 标准的处理方式不同。这就是为什么所有非 OOXML 文件默认仅打开以供查看，尽管在上下文菜单中有一个选项可以转换文件。如果您在转换后意识到数据/格式丢失的风险，但仍希望打开非 OOXML 文件进行编辑，您可以在设置中将其勾选。csv 和 txt 文件的编辑默认可用。
在没有下载权限的情况下访问文档时，文件打印和使用系统剪贴板不可用。可以通过编辑器工具栏和上下文菜单中的按钮在编辑器内复制和粘贴。

备注

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

关于 ONLYOFFICE 和 Nextcloud 集成​

主要功能​

支持的格式​

10.1.0 版本的新增功能​

将 ONLYOFFICE 文档连接到 Nextcloud​

要求​

安装适用于 Nextcloud 的 ONLYOFFICE 连接器​

配置适用于 Nextcloud 的 ONLYOFFICE 连接器​

检查连接​

工作原理​

为 ONLYOFFICE 和 Nextcloud 集成启用 JWT​

连接到演示版 ONLYOFFICE 文档​

使用 Docker Compose 安装 ONLYOFFICE 文档与 Nextcloud​

安装 Docker 和 Docker Compose​

安装 ONLYOFFICE 文档和 Nextcloud 服务器​

使用 UCS 在虚拟机上安装 ONLYOFFICE 文档与 Nextcloud​

下载必要的组件​

导入虚拟设备​

安装应用程序​

在 Nextcloud 中开始使用 ONLYOFFICE 文档​

连接 ONLYOFFICE 桌面编辑器到 Nextcloud​

启动 ONLYOFFICE 桌面编辑器​

在 iOS 或 Android 上连接 ONLYOFFICE 文档到 Nextcloud​

已知问题​

关于 ONLYOFFICE 和 Nextcloud 集成

主要功能

支持的格式

10.1.0 版本的新增功能

将 ONLYOFFICE 文档连接到 Nextcloud

要求

安装适用于 Nextcloud 的 ONLYOFFICE 连接器

配置适用于 Nextcloud 的 ONLYOFFICE 连接器

检查连接

工作原理

为 ONLYOFFICE 和 Nextcloud 集成启用 JWT

连接到演示版 ONLYOFFICE 文档

使用 Docker Compose 安装 ONLYOFFICE 文档与 Nextcloud

安装 Docker 和 Docker Compose

安装 ONLYOFFICE 文档和 Nextcloud 服务器

使用 UCS 在虚拟机上安装 ONLYOFFICE 文档与 Nextcloud

下载必要的组件

导入虚拟设备

安装应用程序

在 Nextcloud 中开始使用 ONLYOFFICE 文档

连接 ONLYOFFICE 桌面编辑器到 Nextcloud

启动 ONLYOFFICE 桌面编辑器

在 iOS 或 Android 上连接 ONLYOFFICE 文档到 Nextcloud

已知问题