Когда Collabora Online сообщает о неожиданном разрыве сокетного соединения, сначала проверьте, проходит ли запрос WebSocket из браузера coolwsdчерез обратный прокси-сервер. Сопоставьте маршрут прокси с версией Collabora, сохраните обновление WebSocket и путь URL, затем протестируйте один документ, наблюдая за панелью «Сеть» браузера и журналами сервера. Если проблема возникла после обновления CODE 26.04 за Apache, ProxyPassсначала проверьте правила Apache: в примечаниях к выпуску Collabora 26.04 указано изменение компактного URL WebSocket.
WebSocket — это долговременное двустороннее соединение, которое Collabora использует между браузером и своим сервером, пока открыт документ. Обратный прокси — это служба, которая принимает публичный запрос и перенаправляет его в Collabora. Сообщение об ошибке указывает на это соединение, но не доказывает, что причиной является прокси; отклоненный хост WOPI, некорректный публичный URL, несоответствие TLS или неправильный бэкэнд также могут остановить сессию.
Запишите версию или тег образа Collabora, программное обеспечение прокси, общедоступное имя хоста Collabora и то, заканчивается ли TLS на прокси или на Collabora. Проверьте имя службы и текущий образ, не изменяя развертывание:
docker compose ps collabora
docker compose images collaboraЗамените collaboraна имя сервиса в вашем файле Compose. Для контейнера, не использующего Compose, используйте docker psи docker inspectдля идентификации контейнера и образа. Не предполагайте, что latestтег по-прежнему указывает на ту же версию, которую вы тестировали на прошлой неделе.
В браузере откройте инструменты разработчика, выберите «Сеть» , отфильтруйте по типу протокола (WS или WebSocket) и попробуйте открыть один документ. URL-адрес запроса должен использоваться, wss://если общедоступная страница использует HTTPS. Выберите неудачный запрос и запишите его статус, путь URL и заголовки ответа. Успешное рукопожатие обычно завершается успешно 101 Switching Protocolsи остается открытым, пока активна сессия с документом.
coolwsdозначающий «Недействительный или неизвестный запрос», может означать, что запрос достиг Collabora с путем, который она не принимает.Используйте текущие настройки обратного прокси Collabora для используемого вами программного обеспечения и версии прокси. Убедитесь, что маршрут WebSocket обрабатывается как WebSocket, что прокси пересылает заголовки обновления и сохраняет путь и закодированную строку запроса, а не перенаправляет или перезаписывает их. Прокси также должен отправлять общедоступный хост и схему в соответствии с настроенным в Collabora именем внешнего сервера и параметрами завершения TLS.
Для Nginx проверьте расположение параметров WebSocket и директив HTTP/1.1, Upgradeа также Connectionпереадресацию в текущем примере Collabora. Для Apache сравните ProxyPassправило и порядок с текущим примером; не вставляйте старый /cool/…/wsрезультат без изменений, не проверив, что запрашивает ваша установленная версия.
Проверка версии важна для CODE 26.04. В примечаниях к выпуску Collabora, опубликованных 8 июня 2026 года, описывается более компактный URL-адрес WebSocket и указывается, что пользователям обратного прокси Apache необходимо внести соответствующие корректировки ProxyPass. В более поздней версии 26.04 было добавлено резервное поведение для устаревших URL-адресов, поэтому старое правило может по-прежнему работать в некоторых сборках; в отчете Collabora о проблемах с WebSocket в версии 26.04 задокументированы эти изменения. Резервное поведение не заменяет сопоставление текущей конфигурации прокси с установленной версией. Ознакомьтесь с примечаниями к выпуску CODE 26.04 и обновленным примером SDK вместе.
Перед повторной попыткой отправки документа запустите короткий поток логов. Опция Docker --sinceограничивает первоначальный вывод, а --followновые строки отправляются потоком; см. справочник по логам Docker Compose .
docker compose logs --since=2m --follow collaboraЗапишите время выполнения теста и найдите тот же запрос в журналах Collabora и прокси-сервера. Если браузер запрашивает путь, который прокси-сервер перенаправляет на неправильный бэкэнд, обновите только этот маршрут WebSocket, используя пример Collabora, соответствующий версии. Если запрос достигает Collabora, но хост, источник или схема отклоняются, сравните общедоступное имя хоста и порт с настроенным именем сервера и перенаправленными заголовками. Если в журнале вместо этого отображается отклонение хоста WOPI или неудачный запрос информации о файле, проверьте разрешенный хост интеграционного сервера и его доступность из контейнера Collabora; это отдельный шаг от рукопожатия WebSocket в браузере.
Перезагрузите прокси-сервер после проверки его конфигурации с помощью собственной команды проверки синтаксиса этого прокси. Избегайте одновременного изменения параметров завершения TLS, списков разрешенных хостов и перезаписи URL-адресов: изменение одной причины для каждой проверки делает следующий результат интерпретируемым. Не отключайте проверку TLS и не разрешайте доступ ко всем хостам WOPI в качестве ярлыка.
Попробуйте открыть тот же документ. В инструментах разработчика убедитесь, что запрос WebSocket возвращается 101 Switching Protocolsи остается открытым. Убедитесь, что документ полностью загружается, остается подключенным и принимает небольшие правки, которые успешно сохраняются. Одного лишь стабильного соединения недостаточно, если доступ к файлу WOPI или его сохранение по-прежнему не удается.
Если рукопожатие по-прежнему не удается, сравните путь запроса в браузере, строку доступа/ошибки прокси-сервера и соответствующую coolwsdзапись в журнале с той же меткой времени. Это трехточечное сравнение покажет, где следует искать проблему: в браузере, прокси-сервере, маршруте Collabora или хосте WOPI. При обращении за помощью удалите токены доступа, идентификаторы документов, имена пользователей и частные имена хостов как из сведений о браузере, так и из журналов.
Смонтируйте файлы шрифтов в Docker и системную панель Collabora, чтобы пользовательские шрифты отображались в редакторе и корректно отображались в документах.
Создайте резервную копию файла coolwsd.xml и его исходных файлов развертывания, безопасно восстановите их и проверьте код, прежде чем пользователи вернутся к редактированию.
Разрешите использование именно Nextcloud или другого источника WOPI в коде, затем проверьте список разрешенных активных хостов и сопоставьте его с ограничением Nextcloud по IP-адресу источника.
Проанализируйте соединения Collabora с браузером, WOPI и WebSocket, чтобы выяснить, почему документ не открывается, а затем примените исправление, соответствующее вашей настройке Nextcloud.
Разверните реплики Collabora CODE с помощью Helm, разместите каждый документ в отдельном поде с помощью привязки WOPI и проверьте входящий трафик, размещение узлов и редактирование в Nextcloud.
Проследите за ошибкой установления соединения между браузером и coolwsd, затем сопоставьте маршрут обратного прокси с вашей версией Collabora, включая изменение Apache в коде 26.04.
Обнаруживайте причины сбоев подтверждения WOPI в Collabora, такие как несоответствие ключей, устаревшие данные обнаружения, смещение времени или изменения URL-адресов прокси-сервера, — без ослабления проверки.
Сбросьте масштаб браузера, протестируйте чистую сессию и определите, когда меню с некорректным размером требует обновления сервера Collabora.
Разверните Collabora CODE с помощью Docker, безопасно подключите его к Nextcloud Office и проверьте корректность редактирования документов с помощью практических проверок WOPI и прокси-сервера.
Временно переведите coolwsd в режим отладки, зафиксируйте одну неудачную попытку открытия и используйте последовательность логов для разделения проблем, связанных с WebSocket, WOPI, прокси и контейнерами.
