Иллюстративный пример: Представьте небольшую команду, файлы Nextcloud которой размещены по адресу https://cloud.example.com. Администратор хочет использовать отдельный сервер Collabora Online Development Edition (CODE) по адресу https://office.example.com. Это гипотетическая конфигурация для объяснения шагов, а не отчет о реальной установке. Замените оба примера имен хостов доменами, которые вы контролируете.
CODE работает как отдельная служба параллельно с Nextcloud. Docker запускает службу Collabora; обратный TLS-прокси обеспечивает её публикацию; а интеграция Nextcloud Office соединяет эти две службы. Ваш браузер должен иметь доступ к общедоступному URL-адресу офиса, а серверы должны иметь доступ к соответствующим конечным точкам Nextcloud и Collabora. В текущем руководстве по установке Nextcloud Office Docker описывается как один из вариантов развертывания, и отмечается, что выделенному серверу обычно требуется обратный прокси.
В качестве примера предположим, что на хосте Linux можно запустить Docker, Nextcloud уже работает по HTTPS, а DNS-записи для обоих имен хостов указывают на правильные серверы. Получите действительный TLS-сертификат для office.example.com. Запланируйте предоставление доступа к сервису Collabora через это имя хоста, а не открывать его порт Docker напрямую в общедоступный интернет.
cloud.example.com.https://office.example.comпо протоколу HTTPS.Приведенные ниже команды используют официальное collabora/codeимя образа и единственный источник Nextcloud. В примерах не указывается тег релиза, поэтому администратор должен самостоятельно определить политику версионирования и обновления, а не рассматривать это latestкак стратегию управления изменениями в производственной среде.
Создайте DNS-запись типа A или AAAA, office.example.comуказывающую на хост или балансировщик нагрузки, обслуживающий Collabora. Настройте обратный прокси-сервер для завершения HTTPS-запросов с использованием сертификата, действительного для этого имени, и перенаправьте пути приложения Collabora и трафик WebSocket в контейнер CODE. В официальной документации Collabora по обратному прокси-серверу приведены примеры, специфичные для конкретного прокси; используйте раздел, соответствующий вашему программному обеспечению прокси и текущей версии CODE.
Не копируйте шаблонный фрагмент кода прокси-сервера вслепую. Прокси-сервер должен поддерживать обновления WebSocket, сохранять необходимую информацию о хосте и перенаправляемом протоколе, а также передавать маршруты Collabora, такие как /browser, /hosting/discovery, и /cool. Точные директивы различаются для Apache, NGINX, Traefik и других шлюзов. Если прокси-сервер работает на хосте Docker, переадресация на 127.0.0.1:9980является распространенной частной целью. Если это отдельный контейнер, то этот адрес обратной связи относится к самому контейнеру прокси, а не к хосту CODE.
На хосте Docker выполните команду `pull` и запустите контейнер. В этом примере порт привязан к локальной области (loopback), поэтому он не будет напрямую доступен на каждом сетевом интерфейсе хоста:
docker pull collabora/code
docker run -d --name collabora -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart always --cap-add MKNOD collabora/codeЭто aliasgroup1значение разрешает доступ к источнику Nextcloud, который, как ожидается, будет использовать эту службу CODE. Схема и имя хоста должны соответствовать URL-адресу, используемому пользователями для доступа к Nextcloud; укажите нестандартный порт, если общедоступная служба Nextcloud его использует. Если несколько экземпляров Nextcloud будут использовать эту службу, настройте дополнительные разрешенные группы хостов в соответствии с текущей документацией по образу CODE, а не разрешайте использование произвольных хостов.
Эта команда предполагает, что обратный прокси находится на той же машине и перенаправляет запрос на порт обратной связи. Если вы используете Docker Compose, контейнеризированный прокси или удаленный прокси, тщательно настройте сеть и доступ к портам. Избегайте публичного открытия порта 9980 только для того, чтобы обеспечить работу прокси-соединения; используйте частную сеть Docker, правило брандмауэра или другой ограниченный путь. Текущие параметры образа CODE Docker см. в руководстве Collabora по CODE Docker .
После настройки прокси-сервера перезагрузите его, используя метод, подходящий для вашего программного обеспечения, и проверьте его конфигурацию, прежде чем вносить изменения. Затем запросите публичную конечную точку обнаружения с машины, которая может получить доступ к домену:
curl -fsS https://office.example.com/hosting/discovery | headУспешный ответ должен содержать информацию об обнаружении XML, а не страницу с ошибкой прокси-сервера. Эта проверка подтверждает, что публичный URL-адрес ведет к конечной точке Collabora; она не доказывает, что авторизация Nextcloud, WebSockets или редактирование документов пока работают. Также проверьте контейнер, если конечная точка не работает:
docker ps --filter name=collabora
docker logs --tail=100 collaboraВ гипотетической ситуации отказ в соединении с общедоступным URL-адресом указывает в первую очередь на DNS, TLS, брандмауэр или маршрутизацию через прокси-сервер. Ответ 502 обычно означает, что прокси-сервер не может связаться с настроенным вышестоящим сервером контейнера. Если обнаружение работает, но редактор позже дает сбой во время загрузки, проверьте переадресацию WebSocket и убедитесь, что прокси-сервер не сообщает об ошибке обновления или вышестоящего сервера.
В Nextcloud откройте раздел «Приложения» и установите или включите интеграцию с Office, предлагаемую для вашей версии. Название приложения может быть «Nextcloud Office» или «Collabora Online» в зависимости от версии и установленного каталога приложений. Затем откройте административные настройки Office и введите:
https://office.example.comСохраните настройки и проверьте состояние подключения. В документации Nextcloud по настройке Office это поле указано как URL-адрес и порт сервера Collabora, и рекомендуется использовать HTTPS. Используйте общедоступный URL-адрес Collabora, доступный через браузеры. В системах с разделенным DNS, NAT или сегментированной сетью Nextcloud может также потребоваться внутренний маршрут к этой службе; обратитесь к расширенным параметрам подключения для установленной версии приложения, а не предполагайте, что общедоступный DNS работает с сервера.
В приведенном примере Nextcloud видит cloud.example.comв качестве разрешенного хоста WOPI, и браузеры пользователей открывают редактор с этого адреса office.example.com. Если на вашей странице администрирования Nextcloud есть список разрешенных запросов WOPI, ограничьте его ожидаемыми адресами серверов Collabora после подтверждения правильности адресов в вашей сети. Nextcloud рекомендует ограничивать запросы WOPI ожидаемыми хостами Collabora; не добавляйте широкие диапазоны без конкретной причины, связанной с сетью.
Войдите в систему как обычный пользователь Nextcloud, создайте небольшой текстовый документ или откройте временный тестовый файл и выберите редактор в браузере. Убедитесь, что панель инструментов редактора загрузилась, внесите безобидные изменения, дождитесь появления индикатора сохранения, закройте файл и откройте его снова, чтобы убедиться, что изменения сохранились. Если установка поддерживает одновременное редактирование, откройте тот же тестовый файл во второй пользовательской сессии и убедитесь, что данные о присутствии или внесенные изменения обновляются должным образом.
Эти проверки разделяют основные уровни: запрос на обнаружение проверяет общедоступную маршрутизацию; статус Nextcloud проверяет настроенное подключение к серверу; открытие редактора проверяет доступ к браузеру и обмен данными WOPI; а повторное открытие файла проверяет путь сохранения. Не используйте важный документ для первого теста. CODE — это версия для разработчиков, поэтому успешное тестирование не заменяет оценку доступности, ресурсной емкости, резервного копирования и потребностей вашей организации в поддержке.
Проверьте URL-адрес офиса на наличие опечаток, наличие действительной цепочки сертификатов и соответствие схемы HTTPS. Проверьте URL-адрес обнаружения как в браузере, так и на хосте Nextcloud. Если публичные DNS-серверы разрешаются по-разному внутри сети сервера, настройте подходящий внутренний маршрут или используйте расширенные параметры URL-адреса сервера, поддерживаемые вашим коннектором.
Проверьте журналы доступа и ошибок обратного прокси-сервера на наличие сбоев обновления WebSocket. Убедитесь, что прокси-сервер перенаправляет текущие маршруты Collabora и поддерживает открытыми долговременные соединения WebSocket. Инструменты разработчика браузера могут показать, был ли запрос WebSocket отклонен, перенаправлен на HTTP или заблокирован ошибкой сертификата.
Сравните фактический источник Nextcloud, включая схему, имя хоста и порт, с настроенной группой псевдонимов. Несоответствие между публичным URL-адресом, внутренним именем хоста и перезаписью прокси-сервера может привести к ошибкам авторизации хоста или WOPI. Добавьте в разрешенную конфигурацию только нужное имя хоста Nextcloud.
Проверьте docker logs collaboraдоступное дисковое пространство и память, права доступа к контейнеру и требования к среде выполнения для развернутого вами тега образа. Избегайте копирования флагов, таких как привилегированный режим, из несвязанных примеров, если это не предусмотрено действующими официальными инструкциями для вашей среды.
Поддерживайте образ контейнера в актуальном состоянии для обеспечения безопасности и совместимости, но планируйте и тестируйте обновления, а не загружайте непроверенный новый образ в рабочее время. Записывайте используемую версию, читайте соответствующие примечания к выпуску и сохраняйте путь отката. Проверяйте конфигурацию прокси после существенных изменений в Collabora или Nextcloud, поскольку требования к конечным точкам и WebSocket могут меняться. Также отслеживайте использование памяти, ЦП, хранилища и журналы контейнеров хоста по мере роста числа активных редакторов.
Для гипотетической команды установка готова к ограниченному использованию только после того, как конечная точка обнаружения ответит, Nextcloud сообщит о подключении, образец документа откроется в браузере, и сохраненные изменения сохранятся после повторного открытия. Если одна из этих проверок не пройдена, необходимо устранить неполадки на этом уровне, прежде чем предлагать пользователям использовать сервис.
Документация проверена 6 октября 2026 г. В стабильной версии руководства Nextcloud при проверке была указана версия 35; пошаговое руководство по Docker, на которое дана ссылка, относится к версии 28, поэтому используйте его в качестве примера установки и проверьте синтаксис прокси-сервера, сравнив его с руководством Collabora и версиями, которые вы используете на самом деле.
Подключите Seafile к Collabora Online с помощью Docker или отдельного хоста. Сравните компромиссы при развертывании, настройте параметры HTTPS и WOPI и проверьте корректность редактирования.
Диагностика медленной печати, прокрутки и сохранения файлов LibreOffice Writer, содержащих большое количество изображений. Проверка настроек дисплея, сжатие изображений большого размера и выявление проблем с профилем или оборудованием.
Разверните Collabora CODE в Kubernetes с помощью официального Helm-диаграммы. Настройте входящий трафик, TLS, доступ к хосту WOPI, секреты, масштабирование и сквозные проверки.
Уменьшите размер большой презентации LibreOffice Impress, сжав фотографии большого размера, выбрав разумное разрешение и качество JPEG, а также проверив сохраненный файл, не жертвуя при этом читаемостью слайдов.
Установите Collabora Online CODE в Docker, безопасно опубликуйте его через обратный прокси-сервер, подключите к Nextcloud Office и проверьте возможность редактирования документов в браузере.
Диагностика ошибок памяти ONLYOFFICE Docs на VPS, проверка ограничений хоста и Docker, просмотр логов и забытых документов, безопасное добавление файла подкачки и перезапуск без риска потери активных правок.
Для устранения неполадок с копированием и вставкой в Collabora Online в локальных приложениях проверьте сочетания клавиш, разрешения буфера обмена браузера, HTTPS, политики iframe и форматы контента.
Чтобы исправить размытый текст в настольных редакторах ONLYOFFICE на Linux, проверьте масштабирование экрана, масштабирование интерфейса приложения, доступность шрифтов и область рендеринга в безопасном порядке.
Узнайте, как добавлять элементы управления формами Writer, устанавливать метки и порядок перехода по вкладкам, экспортировать данные с включенной функцией создания PDF-форм и тестировать интерактивный PDF-файл перед его отправкой.
Узнайте, как блокировать печать и загрузку документов в интеграциях ONLYOFFICE Workspace, DocSpace или Docs, и проверьте, какие элементы управления применяются к каждому способу совместного доступа.
