Collaboraのアクティブなドキュメントビューのアイドルタイマーを設定する

Collaboraビューが非アクティブ状態のままで、暗くなって更新を受信しなくなるまでの時間を変更するには、 を調整しますper_view.idle_timeout_secs。現在のアップストリームcoolwsd.xmlテンプレートでは、このビューレベルのタイマーは900秒（15分）に設定されています。たとえば、30分にするには、1800に設定します。これはサインアウトタイマーや、アイドル状態のドキュメントをアンロードするタイムアウトではありません。

どのタイマーを変更するのかを把握してください。

ビューとは、ユーザーが開いているドキュメントのブラウザビューのことです。Collabora coolwsdOnline を提供する Web デーモンでは、per_view設定はidle_timeout_secs、ブラウザのタブがフォーカスされたままであっても、非アクティブなユーザー ビューが暗くなり、更新が停止するまでの秒数です。アップストリーム テンプレートでは現在、デフォルト値として 900 秒が設定されています。パッケージまたはマネージド サービスによってこの値が上書きされる場合があるため、デプロイメントで実際に使用されている構成を確認してください。

ユーザーが閲覧中や一時停止中に、フォーカスされた編集ビューをより長くアクティブな状態に保ちたい場合は、最初の設定を使用してください。背景タブが暗くなるのが早すぎる場合にのみ、2番目の設定を使用してください。3番目の設定は、ドキュメントにアクティブなビューがなくなった後のサーバー側のクリーンアップです。この設定を変更しても、開いたままになっているビューの非アクティブ状態の動作は変わりません。自動保存とアイドル保存の設定は、変更されたコンテンツが保存されるタイミングを制御するものであり、ビューがアクティブな状態を維持する時間を制御するものではありません。

タイムアウトを選択し、設定を準備します。

ワークフローに合った期間を選択し、それを秒数に変換します。20分は1200秒、30分は1800秒、45分は2700秒です。以下の例では30分を使用していますが、これはあくまで例であり、一般的な推奨事項ではありません。値を長く設定すると、アイドル状態のビューがより長く保持され、ドキュメントの処理や更新アクティビティもより長く維持される可能性があります。

編集する前に、Collaboraがどのようにインストールされているかを確認してください。Docker CODE、Linuxパッケージ、Helmデプロイメント、ホスティングプロバイダーなど、インストール方法によって設定の公開方法が異なります。アクティブな設定をバックアップするか、Composeファイルのコピーを保存してください。統合ツールがサーバーを管理している場合は、コンテナの一時ファイルシステムを編集するのではなく、そのツールがサポートする設定メカニズムを使用してください。

ビューごとのアイドルタイムアウトを設定します

Docker CODEとCompose

extra_paramsCollaboraサービスの既存の値にオプションを追加します。

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

既にオプションが含まれている場合はextra_params、キーを2回定義する代わりに、このオプションを同じ値に追加します。既存の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>2つ目のブロックを貼り付けたり、実行中の構成であるかのようにソーステンプレートを編集したりしないでください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。ビューを早く暗くするためだけに、ドキュメントのアンロード設定を短くしないでください。

現在の設定名とアップストリームのデフォルト値については、Collabora Online の設定テンプレートを参照してください。Docker のextra_params方法については、CODE Docker イメージのドキュメントを参照してください。デフォルト値と設定の提供方法はバージョンやパッケージによって異なる場合があるため、実行するバージョンとパッケージに合わせて正確な動作を確認してください。