Подключение Nextcloud к CODE Docker: настройка и компромиссы.

Подключите Nextcloud к Collabora CODE, используя официальный collabora/codeобраз, ограничьте его порт только хостом, направьте HTTPS-поддомен офиса через обратный прокси-сервер с поддержкой WebSocket и укажите этот публичный URL-адрес в интеграции Nextcloud с Collabora. Десять минут — это реально, только если Docker, DNS, TLS и прокси-сервер готовы.

Сначала выберите подходящий офисный сервис. Начиная с октября 2026 года, Nextcloud отличает свой Nextcloud Office на базе Euro-Office от Collabora Online. CODE — это Collabora Online Development Edition, поэтому используйте интеграцию с Collabora, а не коннектор Euro-Office. Встроенное приложение CODE работает быстрее всего в личных целях, но Nextcloud описывает его как более медленное и не обладающее расширенными возможностями масштабирования. Отдельный контейнер проще в управлении, но добавляет работу с прокси и обновлениями. CODE подходит для домашнего использования и тестирования; если бизнесу требуется поддержка в производственной среде, выбирайте поддерживаемое развертывание Collabora Online.

Перед началом: десятиминутный маршрут

Необходимо иметь работающий HTTPS-адрес Nextcloud, отдельное имя хоста офиса с действительным TLS-протоколом и доступ к Docker на хосте CODE. Имя хоста офиса должно быть перенаправлено на обратный прокси-сервер, способный перенаправлять трафик к контейнеру. Как браузеры пользователей, так и сервер Nextcloud должны иметь доступ к URL-адресу офиса.

Если DNS или TLS еще не готовы, не открывайте порт 9980 публично в качестве ярлыка. Привяжите его к локальной области (loopback) и сначала завершите работу прокси.

1. Запустите контейнер Docker CODE.

Замените указанное в примере имя хоста Nextcloud на точное имя HTTPS-источника, которое пользователи используют для входа в систему. Этот aliasgroup1параметр ограничивает круг хостов WOPI (файловой службы, предоставляющей документы редактору), которые могут подключаться. Не используйте подстановочный знак только для того, чтобы скрыть неудачное соединение.

docker pull collabora/code

docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/code

Привязка к 127.0.0.1порту обеспечивает его приватность, в то время как прокси-сервер на том же хосте может получить к нему доступ. Если ваш прокси-сервер находится в другом месте, разрешите подключение к порту 9980 только этому доверенному прокси-серверу.

Убедитесь, что контейнер запущен и что его точка обнаружения отвечает локально:

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-kЭта процедура обходит проверку сертификата только для локальной самоподписанной проверки; она не исправляет недействительный открытый сертификат.

2. Добавьте имя хоста общедоступного офиса за протокол HTTPS.

Используйте https://office.example.comобратный прокси-сервер с действительным сертификатом для отправки запросов в CODE. Рекомендации Collabora по работе с прокси охватывают ресурсы редактора, обнаружение/возможности /cool/и переадресацию WebSocket. Без обновления WebSocket страница может загружаться, в то время как редактор может давать сбой.

Используйте сохраненную конфигурацию вашего прокси-сервера. Если TLS завершается до CODE, следуйте описанным в документации настройкам TLS на стороне бэкэнда; не отключайте проверку сертификатов глобально.

3. Подключите интеграцию Collabora в Nextcloud.

В Nextcloud включите или установите приложение интеграции Collabora, доступное для вашей версии. Затем откройте административную панель Office и введите общедоступный URL-адрес Collabora https://office.example.com. В текущих руководствах этот параметр обозначен как «Сервер Collabora Online»; формулировки и названия приложений могут различаться в зависимости от версии, особенно с учетом добавления опции Euro-Office в Nextcloud. Выберите Collabora Online для этого сервера CODE. Не вводите адрес только для контейнера, https://127.0.0.1:9980если Nextcloud не работает на том же хосте, и этот адрес также не является настроенной конечной точкой службы; в рекомендуемой настройке прокси используйте общедоступное имя хоста Office.

Сохраните настройки и запустите встроенную проверку подключения, если она доступна в вашей версии. Если она не пройдена, сравните точный источник Nextcloud в файле конфигурации aliasgroup1, убедитесь, что Nextcloud и браузер могут разрешить и получить доступ к имени хоста офиса, и проверьте журналы обратного прокси-сервера на наличие запрещенных путей или ошибок WebSocket.

4. Проверьте правки, затем выберите, подходит ли КОД.

Откройте небольшой тестовый документ в Nextcloud и убедитесь, что он открывается в редакторе браузера, принимает изменения, сохраняется и открывается снова с этими изменениями в неизменном виде. Протестируйте как с обычной учетной записи пользователя, так и с учетной записью администратора. Проверка работоспособности системы обнаружения сама по себе подтверждает, что CODE отвечает; она не доказывает работоспособность авторизации WOPI, прокси-сервера WebSocket и операций сохранения документов.

Для личного сервера или небольшой команды CODE Docker отделяет редактор от стека PHP Nextcloud. Вы также контролируете прокси, перезапуски, проверки совместимости и обновления образов. Встроенное приложение CODE проще, но использует тот же хост и имеет меньше возможностей масштабирования. Для организации, которая зависит от ежедневного редактирования, следует рассмотреть поддерживаемый сервис Collabora Online, а не рассматривать CODE как гарантию работоспособности в производственной среде.

Когда будете готовы обновить CODE, загрузите новый образ и создайте контейнер заново с теми же параметрами. Перед обновлением сервиса, на который полагаются пользователи, ознакомьтесь с примечаниями к выпуску и протестируйте открытие и сохранение документа; тег latestможет переместиться. Закрепите определенную версию образа, если важны повторяющиеся развертывания.

Проверка

Настройка считается работоспособной, если имя хоста в общедоступном офисе предоставляет действительный сертификат, проверка подключения Nextcloud проходит успешно, и тестовый документ открывается, сохраняется и повторно открывается в редакторе. Если целевая страница офиса загружается, но редактирование зависает, проверьте переадресацию WebSocket. Если Nextcloud сообщает, что хост не разрешен, исправьте это, aliasgroup1чтобы он соответствовал фактическому источнику Nextcloud. Если CODE отвечает локально, но не из браузеров пользователей, проверьте общедоступный DNS, маршрутизацию брандмауэра и обратный прокси-сервер.

Ссылки: пример установки Docker в Nextcloud ; параметры установки Nextcloud Office ; конфигурация Nextcloud Collabora ; настройки обратного прокси Collabora ; официальные сведения об образе Docker CODE ; параметры летней версии Office для Nextcloud Hub 26 .