Подключите Collabora Online к ownCloud Infinite Scale

Используйте сервис Collaboration от ownCloud Infinite Scale в качестве моста WOPI между веб-интерфейсом и Collabora Online. Для новой установки наиболее безопасным вариантом является официальный модульный ocis_fullпример Docker Compose от ownCloud, который включает Infinite Scale, Collaboration, Collabora и Traefik. Укажите публичные URL-адреса Infinite Scale, Collabora и WOPI, используйте действительные TLS-сертификаты и обеспечьте согласованность всех секретов сервисов. Не настраивайте это так, как если бы Infinite Scale был классическим сервером ownCloud.

Это различие подтверждается в текущей документации ownCloud: Infinite Scale интегрирует офисные пакеты через WOPI и его службу Collaboration. Эта служба заменяет старый внешний cs3org/wopiсервер в более новых версиях, поэтому администраторы, обновляющие старую версию, должны следовать инструкциям по миграции для установленной у них версии.

1. Проверьте требования к выпуску и сети.

Перед установкой чего-либо обязательно уточните точную версию Infinite Scale. В текущей документации ownCloud служба Collaboration указана в документации для разработчиков версии 9.0 и говорится, что её необходимо запускать отдельно, когда Infinite Scale работает в режиме контролируемого доступа. В примере с полным стеком ownCloud также предупреждается, что настройка зависит от версий, содержащих службу Collaboration, и не работает с производственными версиями 5.x. Используйте документацию и файлы Compose, соответствующие установленной версии; не копируйте пример с постоянно обновляемой версией в более старую производственную систему, не проверив совместимость.

Для публичного развертывания запланируйте отдельные имена хостов, такие как cloud.example.com, office.example.com, и wopi.example.com. Браузер должен иметь доступ к URL-адресам облака и Collabora, в то время как Collabora должна иметь доступ к конечной точке WOPI, предоставляемой Infinite Scale. DNS, брандмауэры и доверие TLS должны работать в обоих направлениях. Хост, доступный с вашего ноутбука, но недоступный из контейнера Collabora, недостаточен.

В примере развертывания ownCloud используется Traefik в качестве обратного прокси-сервера, и для настройки сервера ожидается действительный SSL-сертификат. В локальной тестовой конфигурации можно использовать самоподписанные сертификаты, но в публичных установках не следует автоматически отключать проверку сертификатов. Перед настройкой стека определитесь с именами хостов и используемыми сертификатами.

2. Начните с соответствующего примера Compose от ownCloud.

1. Откройте официальное руководство ownCloud по развертыванию полнофункциональной модульной версии oCIS с WebOffice и соответствующий каталог примеров ocis_full . Для производственной среды используйте релиз или тег, соответствующий вашей версии Infinite Scale, вместо того, чтобы полагаться на постоянно обновляемую ветку репозитория.
2. Просмотрите файл примера .env. Установите значения OCIS_DOMAIN, COLLABORA_DOMAIN, и WOPISERVER_DOMAINна имена хостов, которые разрешаются в ваш сервер. В примере Collabora включается с помощью COLLABORA=:collabora.yml; сохраните эту настройку, если вы хотите использовать Collabora в качестве офисного редактора.
3. Установите надежные, конфиденциальные учетные данные администратора и следуйте рекомендациям по использованию TLS в производственной среде, приведенным в примере. Не оставляйте пароли из примера. Если в версии репозитория изменились имена переменных среды или структура файлов, используйте файлы из того же помеченного релиза, а не смешивайте инструкции из разных версий.
4. Перед запуском проверьте конфигурацию Compose. Убедитесь, что службы Collabora, Collaboration, Infinite Scale и прокси-сервер используют одну и ту же сеть и конфигурацию. В руководстве ownCloud предупреждается, что если Collaboration работает в отдельном контейнере, соответствующая конфигурация Infinite Scale и сгенерированные секреты должны быть доступны другим службам.

Пример развертывания представляет собой интегрированный стек, а не универсальную конфигурацию для каждой существующей установки. Если вы уже используете Infinite Scale с systemd, Kubernetes или собственным обратным прокси-сервером, сохраните эту модель развертывания и настройте службу Collaboration и реестр приложений, используя документацию для соответствующего выпуска, вместо запуска второго полного стека.

3. Подключите Collabora к Collabora с помощью WOPI.

Основные настройки определяют URL-адрес редактора и внешний источник WOPI. В текущей документации по сервису — COLLABORATION_APP_NAMEэто отображаемое имя приложения, — COLLABORATION_APP_PRODUCTидентифицирует продукт, COLLABORATION_APP_ADDRуказывает на Collabora, а COLLABORATION_WOPI_SRC— это URL-адрес, который Collabora использует для чтения и записи файлов через Infinite Scale. Концептуальная конфигурация выглядит следующим образом:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

Используйте фактические общедоступные URL-адреса и формат переменных, требуемый для вашего развертывания. Если сервисы взаимодействуют во внутренней контейнерной сети, внутренний адрес может подходить для одной настройки, а URL-адрес, доступный из браузера, — для другой. Не подставляйте имя хоста, доступное только в контейнере, в значение, которое Collabora должна разрешать извне.

Для работы сервиса Collaboration также требуются значения среды выполнения Infinite Scale OCIS_URL, OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, и MICRO_REGISTRY_ADDRESS. Они должны соответствовать работающему экземпляру; официальный пример полного стека предоставляет связи между сервисами для собственной сети Compose. Не придумывайте новые секреты только для одного сервиса и не отключайте проверку ключей подтверждения WOPI, чтобы обойти несоответствие. Оставляйте проверку сертификатов включенной для доверенных открытых сертификатов; COLLABORATION_APP_INSECUREэто указано только как опция для самоподписанного сертификата приложения WOPI, а не как общее решение для производственной среды.

Реестр приложений управляет тем, какое офисное приложение отображается для каждого типа MIME и какое приложение открывается по умолчанию. Если Collabora запущена, но в документах отсутствует опция «Открыть с помощью», проверьте конфигурацию типа MIME в реестре и ее default_appзначение. Используемое там имя должно совпадать с именем настроенного офисного приложения. ownCloud описывает это как конфигурацию в формате YAML; переменные среды не заменяют сопоставление типов MIME.

4. Запустите, протестируйте и проведите диагностику интеграции.

Используя официальный пример Compose, проверьте сгенерированную конфигурацию, а затем запустите стек из каталога развертывания:

docker compose config
docker compose up -d

Если вы не используете пример Compose, сначала запустите службы шлюза, поставщика приложений и Collabora. В режиме с учителем ownCloud описывает явный запуск Collaboration с помощью команды `compose` ocis collaboration server; он не запускается автоматически. Перед запуском убедитесь, что необходимые переменные среды заполнены в процессе службы Collaboration.

1. Откройте https://office.example.com/hosting/discoveryв браузере. Доступная конечная точка должна возвращать XML-код обнаружения Collabora, а не ошибку DNS, TLS или прокси-сервера.
2. Войдите в Infinite Scale, откройте поддерживаемый документ и выберите Collabora, если пользовательский интерфейс предлагает несколько офисных приложений. Протестируйте как существующий файл, так и, если это включено в реестре приложений, создание нового документа.
3. Внесите небольшие изменения, дождитесь, пока индикатор сохранения стабилизируется, закройте редактор и снова откройте файл, чтобы убедиться, что изменения сохранились.
4. Если редактор не открывается, проверьте журналы Infinite Scale Collaboration и App Provider, журналы Collabora и журналы обратного прокси-сервера за тот же период времени. Сообщение «Unauthorized WOPI host» указывает на конфигурацию доверия WOPI в Collabora; сбой обратного вызова или ошибка TLS указывают на доступность URL-адреса или доверие к сертификату; отсутствие параметра приложения указывает на реестр приложений.

Успешная интеграция означает, что браузер загружает редактор, соединение WOPI устанавливается с Infinite Scale, а внесенные изменения сохраняются после повторного открытия. Точные имена контейнеров, URL-адреса и расположение файлов конфигурации зависят от версии Infinite Scale и метода развертывания. Используйте соответствующую версию документации ownCloud для получения подробной информации, особенно при миграции с устаревшего внешнего сервера WOPI.

Ссылки: конфигурация службы ownCloud Collaboration , конфигурация реестра приложений ownCloud , а также примечания к выпуску и миграции Infinite Scale .