В Collabora Online есть несколько настроек, которые звучат как «тайм-аут простоя», но они управляют разным поведением. Если редактор затемняется или перестает обновляться, пока пользователь продолжает работать, отрегулируйте параметр неактивности для каждого просмотра. Если документ остается загруженным после того, как все ушли, отрегулируйте тайм-аут для каждого документа. Если редактор действительно отключается, проверьте тайм-аут WebSocket обратного прокси-сервера, прежде чем изменять политику простоя Collabora.
В текущем шаблоне конфигурации Collabora Online указаны следующие параметры: 15-минутный тайм-аут для каждого представления в режиме ожидания, 5-минутный тайм-аут, когда вкладка браузера теряет фокус, и часовой тайм-аут перед выгрузкой неактивного документа. Эти значения по умолчанию могут различаться в зависимости от версии и пакета, поэтому перед внесением изменений проверьте конфигурацию, поставляемую с установленной версией. Приведенные ниже значения относятся к текущему шаблону, проверенному в этом руководстве, и не являются гарантией для каждой версии CODE или корпоративного развертывания.
| Параметр | Что оно контролирует | Используйте его, когда | Компромисс |
|---|---|---|---|
per_view.idle_timeout_secs | Приглушение и остановка обновлений, когда пользователь неактивен, даже если вкладка браузера остается в фокусе. Текущее значение по умолчанию для шаблона: 900 секунд. | Людям требуется больше времени для чтения, проверки или редактирования без постоянного взаимодействия. | Увеличение времени ожидания позволяет дольше сохранять неактивными представления и может привести к использованию большего количества ресурсов клиента и сервера. |
per_view.out_of_focus_timeout_secs | Приглушение и остановка обновлений, когда вкладка браузера перестает быть активной. Текущее значение по умолчанию для шаблона: 300 секунд. | В процессе совместной работы пользователи переключаются между вкладками документа и другими вкладками. | Увеличение времени ожидания обеспечивает обновление вкладок в фоновом режиме; одновременное открытие нескольких документов может потреблять больше ресурсов. |
per_document.idle_timeout_secs | Выгрузка документа, перешедшего в режим ожидания. Текущее значение по умолчанию для шаблона: 3600 секунд. | Документы остаются в памяти слишком долго после того, как их режим редактирования перестал быть активным или был закрыт. | Более короткое значение позволяет быстрее освободить процессы обработки документа, но при последующем повторном открытии может потребоваться перезагрузка документа. |
per_document.idlesave_duration_secsиautosave_duration_secs | Сохранение измененных документов после периода бездействия или по расписанию автосохранения. Текущие значения по умолчанию для шаблона: 30 и 300 секунд. | Вы настраиваете частоту сохранения или исследуете особенности сохранения. | Это интервалы сохранения, а не настройки окончания сессии. Изменение этих параметров не предотвратит затемнение неактивного окна. |
| Таймаут WebSocket при использовании обратного прокси | Как долго прокси-сервер поддерживает открытое WebSocket-соединение в браузере. | Редактор отключается или выходит из строя через предсказуемый промежуток времени, особенно в режиме ожидания. | Для долговременных соединений необходимо устанавливать одинаковые лимиты на каждом прокси-сервере, балансировщике нагрузки и уровне входящего трафика. |
В документации Collabora значения и значения по умолчанию описаны в текущем шаблоне конфигурации coolwsd и справочнике по конфигурации . Тайм-аут простоя для каждого представления не то же самое, что закрытие учетной записи или отзыв доступа: он затемняет представление и останавливает обновления. Тайм-аут для каждого документа выгружает процесс простоя документа; это не таймер, который должен завершать работу пользователя, активно редактирующего документ.
per_view.idle_timeout_secsинтервал с заданного по умолчанию до измеренного значения, например, 1800 секунд (30 минут). Это практическая отправная точка, а не универсальная рекомендация.per_view.out_of_focus_timeout_secsотдельно. Не увеличивайте его только потому, что пользователи неактивны во вкладке, на которой они находятся.per_document.idle_timeout_secsпосле подтверждения того, что документ действительно находится в режиме ожидания и что сохранение данных в хранилище проходит успешно.При установке на основе пакетов найдите активный coolwsd.xmlфайл, используемый запущенной службой. Обычно это файлы /etc/coolwsd/coolwsd.xml, но пути могут различаться в зависимости от дистрибутива и более старых версий. Не следует предполагать, что редактирование образца файла или неиспользуемой смонтированной копии изменит запущенную службу.
Создайте резервную копию активного файла, затем отредактируйте только соответствующие значения в существующих <per_view>разделах <per_document>. Например, этот фрагмент устанавливает 30-минутный тайм-аут для неактивного пользователя, 15-минутный тайм-аут для фоновой работы вкладок и двухчасовой тайм-аут для выгрузки неактивных документов:
<per_view>
<idle_timeout_secs>1800</idle_timeout_secs>
<out_of_focus_timeout_secs>900</out_of_focus_timeout_secs>
</per_view>
<per_document>
<idle_timeout_secs>7200</idle_timeout_secs>
</per_document>Это фрагмент, а не полная конфигурация замены. Сохраните атрибуты, комментарии, вложенность и другие элементы в файле, поставляемом с вашей версией; некоторые сборки ожидают дополнительных XML-атрибутов. Если вы хотите изменить затемнение только тогда, когда вкладка остается в фокусе, отредактируйте только значение простоя для каждого представления. Одновременное увеличение значений для каждого представления и значения выгрузки документа затрудняет определение того, какой параметр был устранен.
Проверьте XML-файл с помощью поддерживаемых инструментами настройки вашей системы, затем перезапустите или перезагрузите Collabora, используя метод, описанный для этого пакета. Просмотрите журналы запуска на наличие ошибок анализа конфигурации и убедитесь, что запущенный процесс загрузил нужный файл. Изменение параметра, отсутствующего в активном процессе, не окажет никакого эффекта.
В образе Docker от Collabora администраторы обычно передают параметры конфигурации, extra_paramsиспользуя --o:синтаксис параметров. Следующий пример в стиле Compose иллюстрирует тот же случай:
extra_params=--o:per_view.idle_timeout_secs=1800 --o:per_view.out_of_focus_timeout_secs=900 --o:per_document.idle_timeout_secs=7200Используйте это только в том случае, если ваш образ и диаграмма развертывания поддерживают это extra_params. Для Kubernetes, Helm или установки, управляемой оператором, укажите параметры в поле поддерживаемой конфигурации диаграммы или пользовательского ресурса, а не редактируйте сгенерированный файл контейнера. При изменении переменных среды в Compose пересоздайте или повторно разверните службу, чтобы новые значения достигли контейнера; простой перезапуск может повторно использовать существующую конфигурацию контейнера.
Не устанавливайте один и тот же параметр в конфликтующих местах, например, одновременно в смонтированном XML-файле и параметре среды, без проверки правил приоритета для данного выпуска. После повторного развертывания проверьте журналы запуска контейнера и активную конфигурацию. В случае расхождения названий параметров или поведения контейнера следует обратиться к репозиторию исходного кода проекта Collabora и соответствующей версии документации по развертыванию.
Редактор Collabora использует WebSocket для постоянной связи с браузером. Прокси-сервер может закрыть действительный WebSocket, даже если таймауты документа и представления Collabora установлены на гораздо более длительный срок. В этом случае пользователи могут увидеть сообщение о разрыве соединения, запрос на повторное подключение или редактор, который перестает получать обновления, вместо просто затемненного окна.
Сравните таймаут чтения/отправки прокси-сервера, любой таймаут простоя входящего трафика или балансировщика нагрузки облака с предполагаемым поведением сессии в Collabora. Таймауты должны быть совместимы на всем протяжении маршрута. Руководство по настройкам прокси-сервера Collabora включает в себя конфигурацию прокси-сервера WebSocket и примеры длительных соединений. Применяйте рекомендации, соответствующие вашему конкретному прокси-серверу и версии; не копируйте старый блок Nginx вслепую в другой прокси-сервер или несвязанный маршрут.
Полезной подсказкой является характер сбоя. Если пользователи видят только затемненное окно неактивности, изучите его per_view. Если все пользователи отключаются примерно в одно и то же время, проверьте журналы прокси-сервера и балансировщика нагрузки за этот момент времени. Если документ закрывается только после того, как все участники покидают систему, более важным является тайм-аут для каждого документа.
per_view.idle_timeout_secsтолько это значение.Не проверяйте изменения на несохраненном рабочем документе. Убедитесь, что измененные файлы сохраняются в хранилище, прежде чем разрешать процессу выгрузки неактивного документа. Если проблема наблюдается только с несохраненными изменениями, проверьте ошибки автосохранения и хранилища как отдельную проблему, а не увеличивайте время ожидания.
Более длительные тайм-ауты для каждого просмотра подходят командам, которые просматривают документы с паузами или работают в нескольких вкладках браузера. Более короткие значения могут привести к более быстрому прекращению обновления неактивных представлений, что может снизить фоновую активность, но может прервать чтение документа читателем, который все еще его просматривает. Тайм-аут для каждого документа — это отдельный вопрос управления ресурсами: его увеличение позволяет дольше загружать неиспользуемые документы, а его сокращение может потребовать повторной загрузки при возвращении пользователя.
В большинстве случаев для соответствия наблюдаемому поведению следует изменять минимальное количество необходимых настроек. Сохраняйте интервалы сохранения, устанавливайте разумное окно неактивности для каждого представления для всей команды, оставляйте тайм-аут для фоновых вкладок преднамеренным и настраивайте ограничения WebSocket для прокси-сервера только в том случае, если журналы или данные хронометража указывают на проблему на уровне соединения. После обновления перепроверьте шаблон конфигурации установленной версии, поскольку значения по умолчанию и поддерживаемые параметры могут измениться.
Безопасно устраните предупреждение LibreOffice о блокировке от неизвестного пользователя. Проверьте активные сеансы, защитите копию, удалите только проверенную устаревшую блокировку и протестируйте документ.
Исправьте некорректное отображение, выравнивание или смешивание арабского или ивритского текста с английским в LibreOffice Writer. Включите сложную компоновку текста, задайте направление абзаца и проверьте результат.
Learn VLOOKUP and XLOOKUP in LibreOffice Calc, including exact matches, left lookups, not-found results, reverse search, INDEX/MATCH alternatives, and common errors.
Для устранения неполадок, связанных с ошибками проверки подлинности WOPI в Collabora Online, проверьте ключи обнаружения, ротацию ключей, URL-адреса прокси-серверов, метки времени и списки разрешенных хостов.
Включите функцию отслеживания изменений для всех пользователей в документе ONLYOFFICE, сохраните её активность после повторного открытия и ознакомьтесь с ограничениями глобальных настроек по умолчанию.
Сравните значения таймаутов для каждого представления, нерезкости, простоя документа, автосохранения и прокси-сервера в Collabora Online, а затем выберите и проверьте настройки для вашей системы.
Исправьте проблему с языком проверки орфографии в ONLYOFFICE, который не меняется. Узнайте, когда следует устанавливать язык документа, выделять текст, настраивать обнаружение редакторов рабочего стола и проверять словари.
Восстановите отсутствующие шрифты Calibri и Arial в LibreOffice, проверив системные шрифты, установив лицензионные шрифты или совместимые аналоги, обновив кэш шрифтов и проверив вывод в Writer.
Создавайте резервные копии и восстанавливайте конфигурационные файлы Collabora CODE в нативных или Docker-установках, включая coolwsd.xml, параметры развертывания, ключи подтверждения и результаты проверки.
Установите пользовательские шрифты на ONLYOFFICE Document Server для Linux или Docker, перегенерируйте список шрифтов и убедитесь, что они корректно отображаются в редакторах и экспортированных файлах.
