Для начала проверьте, затрагивает ли пустой экран один файл или все файлы, затем изучите панели «Сеть» и «Консоль» браузера, а также журналы Collabora и платформы хранения данных. Пустой холст — это симптом, а не диагноз: редактор мог загрузиться, когда подключение к документу, авторизация WOPI или встроенные ресурсы не были установлены.
Откройте заведомо исправный документ в том же приложении, затем попробуйте открыть проблемный файл в другом поддерживаемом браузере или в режиме приватного просмотра. Не редактируйте оригинал во время диагностики. Одна неисправная файловая система указывает на проблемы с форматом, содержимым или правами доступа; распространенные сбои указывают на проблемы с общими службами или изменениями в сети.
| Что вы наблюдаете | Наиболее полезная следующая проверка | Компромисс |
|---|---|---|
| Один документ пуст. | Попробуйте другой файл того же формата; проверьте журналы файлов и WOPI приложения для хранения данных. | Быстрая изоляция, но не исключает проблем с анализом файла или правами доступа. |
| Все документы не отображаются в одном браузере. | Приватное окно, другой браузер, расширения и консоль браузера. | Это простой и быстрый способ решения проблемы, но обходной путь через браузер не устраняет неполадку на сервере. |
| Все пользователи и браузеры не справляются. | Сетевые запросы, обратный прокси-сервер, политика хоста WOPI и журналы сервера. | Более информативно для диагностики, но изменения могут затронуть каждого пользователя; сначала зафиксируйте текущие настройки. |
Приватное окно — это тест, а не решение проблемы. Если там всё работает, отключайте расширения по одному или очищайте данные сайта только для затронутого источника, убедившись, что у вас нет несинхронизированной работы. Очистка всех данных браузера может привести к выходу пользователей из системы и удалению не относящегося к сайту состояния.
В Chrome или Chromium откройте инструменты разработчика ( F12 или Ctrl+Shift+I ), выберите «Сеть» , включите параметр «Сохранить журнал» и перезагрузите страницу. Отфильтруйте запросы по протоколу WS (WebSocket) и просмотрите ошибки; в справочнике по сети в инструментах разработчика Chrome объясняется работа с фильтрами запросов и подробная информация о состоянии. Проверьте консоль на наличие ошибок CSP, сертификатов, смешанного контента или JavaScript.
Интерпретируйте имеющиеся данные, а не применяйте универсальный алгоритм действий:
/browser/путями редактора: проверьте, перенаправляет ли обратный прокси текущие пути Collabora в нужный вышестоящий сервер./hosting/discoveryконечной точки подтверждает только базовый HTTP-доступ; она не доказывает работоспособность прямого соединения редактора.Для запросов WebSocket целью является успешное установление соединения; отображаемый статус зависит от версии HTTP и пути прокси-сервера, поэтому не следует рассматривать единое ожидаемое число состояния как универсальное.
В текущих рекомендациях Nextcloud по устранению неполадок указано, что браузер пользователя должен подключаться к обоим серверам по протоколу HTTP(S), Nextcloud должен подключаться к Collabora, а Collabora — к Nextcloud. Также требуется использовать один и тот же протокол для обеих служб. Проверьте публичный адрес Collabora в браузере по адресу https://office.example.com/hosting/discoveryи https://office.example.com/hosting/capabilities. С хоста Nextcloud используйте:
curl -fsS https://office.example.com/hosting/discovery -o /dev/null
curl -fsS https://office.example.com/hosting/capabilities -o /dev/null
Замените пример имени хоста на ваш фактический URL-адрес Collabora. Эти проверки устанавливают доступность по протоколу HTTP, а не успешность редактирования. Если сервер работает, но браузер не работает, проверьте общедоступные DNS-серверы, TLS, брандмауэр или прокси-сервер. В руководстве по устранению неполадок Nextcloud Office перечислены эти проверки подключения и рекомендуется просмотреть журналы приложений.
Если статические ресурсы редактора возвращают ошибку 404, а соединение в реальном времени — 502, сравните маршруты обратного прокси с официальными настройками прокси Collabora . Убедитесь, что прокси отправляет необходимые пути Collabora к правильному вышестоящему серверу и поддерживает соединение WebSocket, используемое браузером. Сохраните информацию о внешнем хосте и HTTPS, ожидаемую вашей системой. Не копируйте конфигурацию для другого прокси, префикса URL или версии Collabora, не проверив её параметры. Выделенное имя хоста Collabora часто проще для отладки; маршрутизация на основе путей требует согласованной обработки префиксов.
WOPI — это протокол, который Collabora использует для получения и сохранения документа через платформу хранения. Хост WOPI обычно представляет собой имя хоста Nextcloud или другого хранилища, а не имя хоста Collabora. Если в журналах отображается сообщение об ошибке No acceptable WOPI hosts found, добавьте или исправьте точный хост хранилища в конфигурации хоста WOPI Collabora, а затем убедитесь, что список разрешенных запросов WOPI платформы хранения содержит адрес сервера Collabora. Nextcloud рекомендует ограничить запросы WOPI ожидаемыми IP-адресами Collabora и настроить Collabora на доверие ожидаемым хостам в соответствии со своим руководством по настройке Office .
Добавление конкретного доверенного хоста безопаснее, чем отключение проверки хоста или разрешение широких доменов. Запишите текущую настройку, изменяйте только соответствующую запись и перезапускайте или перезагружайте службы только по мере необходимости для вашего развертывания. Если вы используете Docker, просмотрите недавний вывод Collabora с помощью команды docker logs --since=10m <collabora-container>`;`. Замените заполнитель реальным именем контейнера. Для установок пакетов или Kubernetes используйте вместо этого журналы их служб или подов.
Перезагрузите тот же документ. Убедитесь, что ресурсы загружаются, соединение остается открытым, контент отображается, а ошибки в консоли исчезают. Проверьте второй документ и другого пользователя, если проблема была общей. Сохраните безобидный тестовый вариант редактирования и откройте его снова, чтобы проверить чтение и сохранение.
Если пустое поле остается, но запросы теперь выполняются успешно, проверьте журналы сервера на наличие ошибок преобразования документов или ошибок, специфичных для файлов, и сравните их с другим файлом того же формата. Если проблема возникла сразу после обновления Collabora, браузера или прокси-сервера, протестируйте контролируемый откат или изменение прокси-сервера в зависимости от версии в рамках планового обслуживания, а не изменяйте несколько переменных одновременно. Очистка кэша браузера полезна только в том случае, если есть основания полагать, что клиентские ресурсы устарели; она не может восстановить заблокированные маршруты или отклоненные запросы WOPI.
Установите официальный Helm-диаграмму Collabora, настройте доступ к WOPI и привязку входящего трафика, а также проверьте развертывание на наличие распространенных ошибок настройки.
Используйте запросы браузера, журналы WOPI и целевые проверки прокси-серверов, чтобы выяснить, почему Collabora открывает пустой документ, и выберите решение, соответствующее полученным данным.
Настройте словари CODE Docker и правильно разметьте фрагменты документа, чтобы проверка орфографии на английском, французском и других поддерживаемых языках выполнялась корректно.
В coolwsd отрегулируйте пороговое значение неактивности для каждого представления и различайте его от затемнения фоновых вкладок, выгрузки документов, автосохранения и истечения срока действия авторизации.
Остановите запланированные проверки обновлений CODE, просмотрите дополнительные удаленные сервисы и используйте исходящие сетевые элементы управления, не нарушая редактирование документов.
Обеспечьте безопасное редактирование документов в Seafile, настроив URL-адрес обнаружения Collabora, HTTPS и доступ WOPI для вашей системы.
Проверьте буфер обмена системы, настройте разрешения браузера и определите, когда для встроенной интеграции Collabora требуется изменение политики iframe.
Смонтируйте файлы шрифтов в Docker и системную панель Collabora, чтобы пользовательские шрифты отображались в редакторе и корректно отображались в документах.
Создайте резервную копию файла coolwsd.xml и его исходных файлов развертывания, безопасно восстановите их и проверьте код, прежде чем пользователи вернутся к редактированию.
Разрешите использование именно Nextcloud или другого источника WOPI в коде, затем проверьте список разрешенных активных хостов и сопоставьте его с ограничением Nextcloud по IP-адресу источника.
