Настройте таймер простоя Collabora для активных представлений документов.

Чтобы изменить время, в течение которого открытое представление Collabora может оставаться неактивным, прежде чем оно погаснет и перестанет получать обновления, измените значение параметра per_view.idle_timeout_secs. В текущем coolwsd.xmlшаблоне этот таймер уровня представления установлен на 900 секунд (15 минут); например, установите его на 1800 секунд на 30 минут. Это не таймер выхода из системы и не таймаут, который выгружает неактивный документ.

Узнайте, какой таймер вы меняете.

Представление — это открытое в браузере окно просмотра документа одним пользователем. В coolwsdвеб-демоне, обслуживающем Collabora Online, per_viewпараметр idle_timeout_secsзадаёт количество секунд, после которого неактивное представление пользователя затемняется и обновления прекращаются, даже если вкладка браузера остаётся в фокусе. В исходном шаблоне по умолчанию установлено значение 900 секунд. Ваш пакет или управляемая служба могут переопределить это значение, поэтому проверьте конфигурацию, фактически используемую в вашем развертывании.

Первый параметр используйте, если пользователи хотят, чтобы сфокусированное окно редактирования оставалось активным дольше во время чтения или паузы. Второй параметр используйте только в том случае, если фоновые вкладки слишком быстро тускнеют. Третий параметр предназначен для очистки на стороне сервера после того, как в документе не осталось активных окон; его изменение не влияет на поведение окна, остающегося открытым, в режиме неактивности. Параметры автосохранения и сохранения в режиме ожидания определяют, когда сохраняется измененное содержимое, а не как долго окно остается активным.

Выберите время ожидания и подготовьте конфигурацию.

Выберите продолжительность, подходящую для вашего рабочего процесса, а затем переведите её в секунды: 20 минут — это 1200, 30 минут — это 1800, а 45 минут — это 2700. В приведенном ниже примере используется 30 минут; это всего лишь пример, а не универсальная рекомендация. Более длительные значения позволяют дольше сохранять неактивные представления и могут также дольше поддерживать процессы обработки документов и активность обновлений.

Перед редактированием определите, как установлена ​​Collabora. Docker CODE, пакет Linux, развертывание Helm и хостинг-провайдер могут предоставлять конфигурацию по-разному. Создайте резервную копию активной конфигурации или сохраните копию файла Compose. Если сервером управляет интеграция, используйте поддерживаемый ею механизм конфигурации, а не редактируйте временную файловую систему контейнера.

Установите тайм-аут простоя для каждого представления.

Docker CODE с Compose

Добавьте этот параметр к существующему extra_paramsзначению для сервиса Collabora:

services:
  collabora:
    environment:
      extra_params: "--o:per_view.idle_timeout_secs=1800"

Если extra_paramsпараметры уже содержатся, добавьте этот параметр к тому же значению вместо того, чтобы определять ключ дважды. Сохраните существующие настройки SSL, прокси и хоста. Образ Docker передает --o:параметры в coolwsd; в официальной документации CODE Docker описан этот метод настройки.

Пакет Linux или смонтированная XML-конфигурация

Отредактируйте активный coolwsd.xmlфайл и измените значение в его существующем <per_view>разделе. Сохраните окружающую конфигурацию и все атрибуты в вашем файле:

<per_view>
  <out_of_focus_timeout_secs>300</out_of_focus_timeout_secs>
  <idle_timeout_secs>1800</idle_timeout_secs>
</per_view>

Не вставляйте второй <per_view>блок и не редактируйте исходный шаблон coolwsd.xml.inтак, как если бы это была текущая конфигурация. Правильный путь к файлу и владелец конфигурации могут отличаться в зависимости от пакета и развертывания.

Примените настройки, перезапустив или создав службу Collabora заново. Для типичной службы Compose с именем collaboraвыполните следующую команду:

docker compose up -d --force-recreate collabora

Замените имя службы на имя, указанное в вашем файле Compose. Для установки пакета, управляемой systemd, перезапустите службу после редактирования ее активной конфигурации, например sudo systemctl restart coolwsd. Откройте документ в новой вкладке браузера, чтобы тест использовал только что созданное представление.

Проверьте поведение системы и устраните причину неисправности.

1. Откройте тестовый документ с низким уровнем риска в активной вкладке браузера и запишите время. Избегайте использования несохраненной версии документа в качестве теста на превышение времени ожидания.
2. Оставьте отображение неизменным в течение заданного интервала. Через 1800 секунд проверьте, потускнело ли отображение и перестало ли получать обновления, как описано в настройке для каждого отображения. Не следует интерпретировать это визуальное состояние как доказательство того, что пользователь вышел из системы или документ был выгружен.
3. Вернитесь к документу и убедитесь, что такое поведение приемлемо для вашей системы. Затем протестируйте случай с отдельной фоновой вкладкой, переключившись на более длительный режим out_of_focus_timeout_secs, если это имеет значение.

После перезапуска некоторые сборки записывают в лог список нестандартных значений конфигурации. Если в логе запуска это отображается, найдите per_view.idle_timeout_secs: 1800. Если поведение по-прежнему соответствует старому значению, убедитесь, что вы отредактировали файл или службу Compose, используемую запущенным процессом, применили изменения и что параметр среды или командной строки не переопределяет XML-файл.

Если документ исчезает только через длительный период без открытых представлений, проведите его проверку per_document.idle_timeout_secs. Если пользователи выходят из системы, проверьте политику аутентификации или сессий на хост-платформе. Это разные уровни, и они не контролируются per_view.idle_timeout_secs. Не сокращайте параметр document-unload только для того, чтобы представление исчезло раньше.

Для получения информации о текущих названиях параметров и значениях по умолчанию из исходного кода обратитесь к онлайн-шаблону конфигурации Collabora . Для получения информации о методе Docker extra_paramsсм. документацию по образу Docker CODE . Проверьте точное поведение в зависимости от используемой версии и пакета, поскольку значения по умолчанию и параметры доставки конфигурации могут различаться.