将 ONLYOFFICE 文档连接到 ONLYOFFICE 群组

如果您想将 ONLYOFFICE 文档连接到安装在本地或远程服务器上的 ONLYOFFICE 群组门户，您可能需要修改安装有 ONLYOFFICE 群组和 ONLYOFFICE 文档的计算机上的配置文件。因此，请首先确保您对两台机器都具有管理员访问权限。

ONLYOFFICE 文档和 ONLYOFFICE 群组必须安装在不同的机器上。

需要更改的内容及方法

将 ONLYOFFICE 文档连接到 ONLYOFFICE 群组需要在 ONLYOFFICE 群组门户界面中的设置页面或配置文件中更改一些连接字符串。 ONLYOFFICE 文档使用以下地址，这些地址必须引入 ONLYOFFICE 群组配置中以便它们连接起来：

  • http://documentserver/ - 用于用户访问
  • http://documentserver/ - 用于 ONLYOFFICE 群组访问
  • http://communityserver/ - 用于 ONLYOFFICE 文档访问

如果您计划在本地网络上同时使用 ONLYOFFICE 文档和 ONLYOFFICE 群组，并且用户将仅通过本地网络访问它们，可以按以下方式更改这些地址：

  • http://documentserver-localaddress/ - 用于用户访问
  • http://documentserver-localaddress/ - 用于 ONLYOFFICE 群组访问
  • http://communityserver-localaddress/ - 用于 ONLYOFFICE 文档访问

但是，如果您计划从外部（使用互联网连接）访问服务器，则必须遵循以下规则：

  • 第一个地址由 ONLYOFFICE 文档 API 服务使用，如果编辑器需要通过互联网访问，则必须使用公共 DNS 地址，因为它不仅与 ONLYOFFICE 群组机器通信，还与用户计算机通信。
  • 第二个和第三个地址仅用于在两个服务器（文档和群组）之间路由通信，不需要任何互联网连接，因此，如果两台计算机位于同一本地网络中，即使计划通过互联网从其他计算机访问 ONLYOFFICE 文档和/或 ONLYOFFICE 群组，在这里使用本地网络地址也是安全的。
  • 如果 ONLYOFFICE 群组和 ONLYOFFICE 文档位于不同的网络中，并且需要通过互联网访问编辑器，您可以仅指定第一个地址。第二个地址的值将与第一个字段相同，第三个地址将从浏览器地址栏中获取。

以下步骤将说明在不同 ONLYOFFICE 群组版本中何处可以找到这些地址。

将 ONLYOFFICE 文档连接到 ONLYOFFICE 群组

通常，要将 ONLYOFFICE 文档连接到 ONLYOFFICE 群组版本 8.1 及更高版本，您只需在门户设置中设置连接参数。为此：

  1. 转到门户设置并选择集成 -> 文档服务部分。
  2. 使用适当的 ONLYOFFICE 文档/ ONLYOFFICE 群组地址填写所有字段。
    • 如果您的 ONLYOFFICE 文档/ ONLYOFFICE 群组安装未切换到 https，请确保在地址中指定http。
  3. 点击保存按钮保存设置。
Connecting ONLYOFFICE 文档 to ONLYOFFICE 群组Connecting ONLYOFFICE 文档 to ONLYOFFICE 群组
从 ONLYOFFICE 文档 7.2 版本开始，默认启用 JWT 并且密钥自动生成。您需要在 ONLYOFFICE 群组配置文件中也指定 JWT 参数。有关详细信息，请参阅本文的配置 JWT部分。

ONLYOFFICE 文档 和 ONLYOFFICE 群组版本兼容性表

请注意，并非所有 ONLYOFFICE 群组和 ONLYOFFICE 文档版本都可以相互连接。如果您拥有的 ONLYOFFICE 群组版本与当前 ONLYOFFICE 文档版本不兼容，反之亦然，请考虑升级到最新版本或至少升级到最近的兼容版本。

下表显示了哪些服务器版本可以相互连接而不会出现任何问题：

7.47.37.27.17.06.46.36.26.16.05.55.45.35.25.15.0
12.5
12.1
12.0
11.6
11.5
10.0.1 – 11.0
10
9.6
9.5
9.0 – 9.1
查看旧版 ONLYOFFICE 群组和 ONLYOFFICE 文档的兼容性表格隐藏旧版 ONLYOFFICE 群组和 ONLYOFFICE 文档的兼容性表格
4.44.2 – 4.33.8 – 4.13.53.02.5
9.1
9.0
8.9.2
8.8 – 8.9.1
8.7
8.1 – 8.6
7.7
不兼容版本无法保证稳定运行，我们强烈建议您将安装的程序更新到最新版本以确保正常运行。

配置 JWT

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

从 ONLYOFFICE 文档v7.2开始，默认启用 JWT 并且密钥自动生成。您需要在 ONLYOFFICE 文档配置文件中找到您的密钥和 JWT 请求头，然后在 ONLYOFFICE 群组配置文件中指定相同的值。

步骤 1：在 ONLYOFFICE 文档配置文件中找到您的密钥和 JWT 请求头

打开位于以下路径的local.json文件：

  • 对于 Linux - /etc/onlyoffice/documentserver/local.json
  • 对于 Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

在以下字符串中找到密钥值：

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

在以下字符串中找到JWT 请求头值：

  • services.CoAuthoring.token.inbox.header
  • services.CoAuthoring.token.outbox.header

步骤 2：在ONLYOFFICE 群组配置文件中指定您的密钥和 JWT 请求头

使用任何可用的文本编辑器打开WebStudio/web.appsettings.config文件。

通过指定密钥和JWT 请求头值来编辑以下键：

<add key="files.docservice.secret" value="your_key" />
<add key="files.docservice.secret.header" value="your_header" />

重新启动站点。

编辑 ONLYOFFICE 文档的配置文件

接下来需要修改web.config文件。它位于 ONLYOFFICE 文档计算机的c:\Program Files\Ascensio System SIA\ONLYOFFICE Online Editors\DocService\文件夹中。使用文本编辑器打开它，并添加以下行（或者如果这些行已存在，则相应地修改它们）：

<add key="editor.settings.coauthoring.url" value="http://documentserver:8000" />
<add key="editor.settings.spellchecker.url" value="http://documentserver:8080" />

其中documentserver是安装有 ONLYOFFICE 文档的计算机的地址。

将 ONLYOFFICE 文档 2.5 连接到 ONLYOFFICE 社区服务器 7.7 及更早版本

要将 ONLYOFFICE 文档2.5连接到安装有ONLYOFFICE 社区服务器7.7及更早版本的计算机，您只需要编辑ONLYOFFICE 社区服务器计算机WebStudio文件夹中的web.appsettings.config文件。使用文本编辑器打开它，并添加以下行（或者如果这些行已存在，则相应地修改它们）：

<add key="files.docservice.url.converter" value="http://documentserver/ConvertService.ashx"/>
<add key="files.docservice.url.api" value="http://documentserver/OfficeWeb/apps/api/documents/api.js"/>
<add key="files.docservice.url.storage" value="http://documentserver/FileUploader.ashx"/>

这些是分别用于转换服务、编辑服务和存储服务的地址，与 ONLYOFFICE 文档 2.5 一起使用。

您不需要更改其他任何内容，包括修改 ONLYOFFICE 文档的web.config文件。

在您自己的服务器上托管 ONLYOFFICE 文档，或在云端使用

在本地部署注册文档云
文章： 标签:
浏览所有标签