1 前言

一个问题，一篇文章，一出故事。
笔者今天尝试将Collabora Online集成到NextCloud的环境中，以方便用户直接在线编辑Office文档。

2 最佳实践

2.1 环境配置

2.1.1 部署Nextcloud服务

如何基于Oracle Linux 9.x部署NextCloud？

请注意，以上设置的Nextcloud服务器的详细信息如下，
Host Name = nextcloud.cmdschool.org
OS = Oracle Linux 9.x x86_64
IP Address = 10.168.0.129

2.1.2 部署Collabora Online服务

如何安装部署Collabora Online？

请注意，以上设置的Nextcloud服务器的详细信息如下，
Host Name = collabora01.cmdschool.org
OS = CentOS 7.x x86_64
IP Address = 10.168.0.128

2.2 安装NextCloud Office

In nextcloud

2.2.1 下载并解压软件包

wget https://github.com/nextcloud-releases/richdocuments/releases/download/v8.7.3/richdocuments-v8.7.3.tar.gz
tar -xf richdocuments-v8.7.3.tar.gz

以上只是下载演示，如果下载异常或者你需要其他版本，请参阅如下连接，
https://apps.nextcloud.com/apps/richdocuments

2.2.2 安装部署软件包安装部署软件包

mv richdocuments /var/www/nextcloud/apps/
chown apache:apache -R /var/www/nextcloud/apps/richdocuments
chmod 770 -R /var/www/nextcloud/apps/richdocuments
occ app:enable richdocuments

另外，如果需要反向操作（适合调试版本），请执行如下命令，

occ app:disable richdocuments
rm -rf /var/www/nextcloud/apps/richdocuments

2.3 设置集成

2.3.1 设置NextCloud的WOPI允许

In nextcloud

occ config:app:set richdocuments wopi_allowlist --value="10.168.0.128"
occ config:list | grep -i wopi_allowlist

如果你需要使用界面设置，请参阅如下向导，

如上图所示，
单击右上角的用户头像，选择【管理设置】->【管理】->【Office】->
在“高级选项”->“Allow list for WOPI requests”中填入“10.168.0.128”
单击【保存】
注意：IP地址“10.168.0.128”为Collabora Online的服务器IP地址

2.3.2 设置Colabora的WOPI允许

In collabora01

vim /etc/coolwsd/coolwsd.xml

添加如下配置，

<config>
    <storage desc="Backend storage">
        <wopi desc="Allow/deny wopi storage." allow="true">
            <alias_groups desc="default mode is 'first' it allows only the first host when groups are not defined. set mode to 'groups' and define group to allow multiple host and its aliases" mode="first">
                    <host desc="hostname to allow or deny." allow="true">https://nextcloud.cmdschool.org</host>
                    <alias desc="regex pattern of aliasname">https://nextcloud.cmdschool.org:443</alias>
            </alias_groups>
        </wopi>
    </storage>
</config>

配置添加后，你需要使用如下命令重启服务使配置生效，

systemctl restart coolwsd

2.3.1 设置Nextcloud Office

In nextcloud

如上图所示，
单击右上角的用户头像，选择【管理设置】->【管理】->【Office】->
在“Nextcloud Office”->“使用你的自有服务器”->“Collabora Online 服务器的地址（和端口）”中填入“https://collabora01.cmdschool.org:9980”
单击【保存】

参阅文档
===================

nextcloud配置文档
———–
https://help.nextcloud.com/t/collabora-integration-guide/151879
https://docs.nextcloud.com/server/latest/admin_manual/office/index.html
https://apps.nextcloud.com/apps/richdocuments

错误的修复
————
https://help.nextcloud.com/t/nextcloud-unauthorized-wopi-host/226654

配置WOPI请求白名单(Nextcloud设置)
———————
https://docs.nextcloud.com/server/latest/admin_manual/office/configuration.html#wopi-settings

配置WOPI请求白名单(Collabora Online设置)
———————
https://sdk.collaboraonline.com/docs/installation/Configuration.html#multihost-configuration