onlyoffice社区版DOCKER私有化部署流程

如需在 SharePoint 协作平台中编辑文档，您可通过官方 ONLYOFFICE 连接器，或使用 WOPI 将 ONLYOFFICE 文档与其文档库连接起来。

主要功能

SharePoint是一个基于网络的协作平台，用于共享和管理内容、知识和应用程序，以增强团队合作。

通过ONLYOFFICE Docs （费的社区版和企业版）与您的SharePoint连接之后，您可以：

• 使用文件和功能区上下文菜单中的编辑 ONLYOFFICE 选项（使用官方连接器时），或点击文件（使用 WOPI 时）来编辑文本文档、电子表格和演示文稿。
• 协同编辑文档：使用两种协同编辑模式（官方连接器：“快速”和“严格”；WOPI：仅“快速”），跟踪更改、评论和内置聊天功能。

WOPI 警告：访问权限 Token 将在一段时间后过期。可将“快速”协同编辑模式的 access_token_ttl 属性设置为 10 小时。“严格”协同编辑模式可能会对访问权限 Token 参数产生负面影响。

支持的格式

官方连接器：

• 查看与编辑 - DOCX、XLSX、PPTX、PPSX。
• 仅查看 - PDF、DJVU、TXT、CSV、ODT、ODS、ODP、DOC、XLS、PPT、PPS、EPUB、RTF、HTML、HTM、MHT、XPS。

WOPI：

• 查看与编辑 - DOCX、XLSX、PPTX、DOCM、XLSM、PPTM、ODT、ODS、ODP、TXT、CSV。
• 仅查看 - PDF、DJVU、XPS。

使用官方 ONLYOFFICE 连接器连接 ONLYOFFICE 文档

ONLYOFFICE SharePoint 集成解决方案是一款官方出品的 ONLYOFFICE 连接器，现已遵循 GNU AGPLV.3 许可于 GitHub 中提供。

如需了解其工作原理以及如何对 ONLYOFFICE SharePoint 集成解决方案进行编辑，请查阅我们的 API 文档。

在将 ONLYOFFICE 文档连接至 SharePoint 之前，

1. 请检查您是否已安装以下应用程序：

• ONLYOFFICE 文档 v5.4 或更高版本

ONLYOFFICE 文档 v6.4.1 及更高版本需要按照说明启用 WOPI

• SharePoint：2019

ONLYOFFICE 文档实例必须可从 SharePoint 和任意最终客户端进行解析与连接。ONLYOFFICE 文档还需要能够直接通过 POST 方式与 SharePoint 进行连接。如需安装 ONLYOFFICE 文档，请按照这里列出的说明进行操作。

2. 点击开始，指向所有程序 -> 管理工具，然后点击服务并确保 SharePoint Administration 服务已启动。

3. 点击开始，点击 SharePoint Management Shell，转到包含 .wsp 文件的目录。

4. 运行 Install.ps1 脚本：

PS> .\Install.ps1

5. 输入您的 SharePoint 站点地址：

https://<yoursharepointsite>

除了步骤 3 和步骤 4 外，您还可输入以下命令：

Add-SPSolution -LiteralPath<solutionpath>/onlyoffice.wsp

在 SharePoint Central Administration 主页中，点击系统设置 > Farm 管理 > 管理 Farm 解决方案。在解决方案管理页面中，点击 onlyoffice.wsp，然后点击部署解决方案。

6. 在 SharePoint Central Administration 主页的“应用程序管理”下点击“管理 Web 应用程序”。

7. 选择您的站点并点击“验证提供方”图标。

8. 在“验证提供方”弹出窗口中点击“默认域”。

9. 在“编辑验证”中勾选“启用匿名访问权限”并点击“保存”。

10. 返回“Web 应用程序管理”，点击“匿名策略”图标。

11. 在“匿名访问权限限制”中选择您的“域”并将“权限”设置为“无 - 无策略”，然后点击“保存”。

12. 在 SharePoint 中打开包含管理设置的 /_layouts/15/Onlyoffice/Settings.aspx 页面。输入以下地址：

https://<documentserver>/

其中的 documentserver 是安装了 ONLYOFFICE 文档的服务器名称。该地址必须可从用户的浏览器与 SharePoint 服务器中进行访问。SharePoint 服务器地址也必须要能够从 ONLYOFFICE 文档服务器中进行访问，这样才能确保一切正常工作。

如果您使用 SharePoint 设置了子站点，那么就需要对 ONLYOFFICE 文档连接进行相应的额外配置，确保系统正常工作。前往各个子站点的设定并在正确的字段中输入 ONLYOFFICE 文档服务器地址。

使用 WOPI 连接 ONLYOFFICE 文档

您还可通过 WOPI 来将 ONLYOFFICE 文档连接至 SharePoint。WOPI 是基于 REST 的协议，可在客户端使用您的数据与服务器建立连接时向一组 REST 端点发送 HTTP 请求。

请注意，由于 WOPI 的架构原因，在使用 WOPI 连接 ONLYOFFICE 文档时将缺失部分功能：

• 编辑器不支持版本历史功能。
• 不支持邮件合并功能。
• 编辑器不支持从存储空间中插入图像。
• 不支持对比存储空间中的文档。
• 不支持以下格式：DOC、XLS、PPT。

如需通过 WOPI 将 ONLYOFFICE 连接至 SharePoint，

1. 请检查您是否已安装以下应用程序：

• ONLYOFFICE 文档 v6.4 或更高版本

ONLYOFFICE 文档 v6.4.1 及更高版本需要按照说明启用 WOPI。

• SharePoint：2019

2. 打开您的 SharePoint 服务器。运行 SharePoint Management Shell 控制台并使用以下命令设置所需的 WOPI 域：

Set-SPWOPIZone -Zone "external-http"

此处的 documentserver 会默认使用 external-http 参数。

3. 运行以下命令以检查当前 Farm 中是否有 WOPI 绑定了其他文档类型：

Get-SPWOPIBinding

如果有的话，可使用以下命令删除这些绑定：

Remove-SPWOPIBinding -All:$true

4. 根据文件类型新建默认操作绑定。运行以下命令以同时为所有文件类型创建绑定：

New-SPWOPIBinding -ServerName ip_or_domain.com:port

运行以下命令以仅为特定文件类型创建绑定：

New-SPWOPIBinding -ServerName ip_or_domain.com:port -Extension DOCX

如果未使用 SSL，则需在命令结尾添加 -AllowHTTP。