在 Nextcloud 上集成并安装 OnlyOffice 文档服务器

规划两个地址

Nextcloud 和文档服务器是两个独立的服务，每个服务都需要自己的地址。在此设置中，Nextcloud 位于 cloud.example.com，文档服务器位于 office.example.com — 使用您自己的真实地址代替它们。三个路径必须全部有效：您的浏览器到达两个服务，Nextcloud 服务器到达文档服务器，文档服务器返回 Nextcloud 以获取和保存文件。此设置中稍后出现的几乎所有故障都只是这三个路径之一被阻止，因此在安装任何内容之前先确定地址。

使用 Docker 安装文档服务器

文档服务器作为来自官方 ONLYOFFICE 镜像的 Docker 容器运行 - 这是设置的“无编码”部分：无需手动安装包，容器包含编辑服务所需的一切。如视频中所示启动容器，并打开 JWT，以便步骤 4 中的秘密可以保护它。

onlyoffice/documentserver

检查容器是否正在运行

在接触 Nextcloud 之前，请证明文档服务器可以独立运行。列出正在运行的容器 - 文档服务器容器应显示为已启动：

sudo docker ps

然后在浏览器中打开文档服务器地址。它通过状态页面进行应答，确认服务已启动且可访问 - 首先解决此处的任何问题，因为 Nextcloud 无法连接到不应答的服务器。

http://office.example.com

设置强 JWT 秘密

JWT 密钥 (JWT_SECRET) 是 Nextcloud 和文档服务器之间的共享密码。两者之间的每个请求都用它进行签名，因此文档服务器仅接受真正来自 Nextcloud 的工作 - 并且它与您在步骤 6 中粘贴到连接器中的值完全相同。

在 Nextcloud 中安装 ONLYOFFICE 连接器

以管理员身份登录 Nextcloud，打开应用，找到 ONLYOFFICE 连接器应用并下载并启用它。连接器是桥梁：它将 ONLYOFFICE 添加为文件中 Office 文档的编辑器，并承载您的文档服务器设置。文件本身永远不会移动——它们始终保留在 Nextcloud 存储中。

将 Nextcloud 连接到文档服务器

在 Nextcloud 中，转到设置 → ONLYOFFICE。输入文档服务器地址（与您在步骤 3 中测试的地址相同）和密钥，该密钥是步骤 4 中的 JWT 密钥，逐字符输入。保存，Nextcloud 检查与文档服务器的连接。

测试文档 - 然后正确保护它

从 Nextcloud Files 打开文档。它应该在浏览器中的 ONLYOFFICE 编辑器中打开：输入一些内容，关闭文档，然后再次打开它并确认您的更改已保存回 Nextcloud。然后从 Nextcloud 移动应用程序打开同一文件 - 编辑通过同一连接运行，这就是此设置承诺的移动编辑。