共有ファイルを破損させることなくSynapse Mediaのディスク容量を解放する

Synapse のメディア リポジトリがディスクを占有している場合は、まずどのディレクトリまたはボリュームが肥大化しているかを確認し、次に Synapse でサポートされている保持設定または管理 API を使用してメディアを削除してください。Synapsemedia_storeはデータベースにメディア メタデータを保持しているため、Synapse の背後にあるファイルを削除すると、参照が壊れたり、クリーンアップの監査が困難になったりする可能性があります。最も安全なポリシーは、その領域がローカル アップロード、他のホーム サーバーからのキャッシュ メディア、サムネイル、または同じディスクを共有する別のサービスによって使用されているかどうかによって異なります。

そのスペースを占めているのは何ですか?

Synapseのメディアリポジトリには、ローカルにアップロードされたアバター、添付ファイル、サムネイルが保存されます。また、リモートのMatrixサーバーから取得したメディアや、URLプレビューに使用されるリソースもキャッシュされます。これらは、Synapseデータベース、コンテナログ、および外部メディアリポジトリとは別個のものです。ルートファイルシステム全体がmedia_store問題の原因であるとは、それ自体では証明されません。

マウントされたデータを所有するホスト上またはコンテナ内で、ファイルシステムの使用状況をSynapseデータディレクトリと比較します。例のパスを、ご使用のデプロイメントにおける値に置き換えてください。

df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store

Synapse のmedia_store_pathデフォルトは でmedia_store、通常はデータ ディレクトリの下にありますが、インストール時に上書きできます。コンテナは、実際のストレージがホスト上にあるマウントされたボリュームに書き込むことができます。homeserver.yamlホスト パスを変更しても安全だと判断する前に、 、コンテナ ボリューム マッピング、またはオーケストレーターの persistent-volume 構成を確認してください。メディア ディレクトリが最大の消費量でない場合は、代わりに を表示するコンポーネントを調べてくださいdu。

メディアに適したクリーンアップポリシーを選択してください

検証済みの動作: Synapseのmedia_retention設定では、一定期間アクセスがないとローカルメディアとキャッシュされたリモートメディアが期限切れになります。アクセスには、ルームへのメディアの読み込みやダウンロードが含まれます。アイテムに一度もアクセスされていない場合、Synapseはその作成時刻を使用します。元のメディアとそのサムネイルの両方が削除されます。クリーンアップはメディアリポジトリワーカー(Synapseのメインプロセスである可能性があります)で実行されます。

使用状況によって異なります。リモートキャッシュされたファイルは、削除後、要求に応じて元のホームサーバーから再度取得できます。ローカルにアップロードされたファイルはサーバーでホストされるため、削除すると古い添付ファイルやアバターが利用できなくなる可能性があります。ローカル保持期間は、ユーザーがその結果を受け入れる場合にのみ選択してください。古い添付ファイルをアーカイブとして扱うコミュニティでは、ローカル保持期間を長くするか、自動的なローカルクリーンアップを行わない方が適切かもしれません。

保持とは、次のような意味ではありません。メディアを隔離するとアクセスはブロックされますが、ファイルやサムネイルは削除されません。必要なディスク容量が解放されることもありません。隔離したアイテムを保持しつつ他のデータを削除する必要がある場合は、隔離はアクセス制限であり、保持と削除はストレージ管理であるという点を明確に理解しておきましょう。

Synapseで自動保持を有効にする

編集する前に、アクティブな設定をバックアップしてください。トップレベルmedia_retentionセクションを追加するか、既存のセクションを更新してください。たとえば、このポリシーでは、ローカルメディアは180日間アクセスがないと期限切れになり、リモートキャッシュエントリは30日後に期限切れになります。

media_retention:
  local_media_lifetime: 180d
  remote_media_lifetime: 30d

これらの値は例であり、普遍的な推奨事項ではありません。保持義務と古いルームコンテンツに対する期待に応じて、ローカル期間を設定してください。リモート メディアのキャッシュのみを制御する場合は、のみを設定しますremote_media_lifetime。設定されていない、または null のライフタイムは、そのタイプが自動的に削除されないことを意味します。Synapse では、隔離されたメディアと隔離から保護されたローカル メディアは、保持クリーンアップから除外されることも説明されています。

デプロイメントの通常の再起動または再読み込みプロセスを使用して構成を適用し、メディアリポジトリワーカーが で実行されていることを確認しますenable_media_repo: true。Synapse が別のメディアワーカーを使用している場合は、メディアリポジトリサービスが有効になっているポリシーを構成します。有効な YAML 編集では、すべての領域がすぐに解放されるわけではありません。ワーカーがクリーンアップを実行する必要があり、選択したアクセスカットオフよりも古いメディアのみが対象となります。

管理APIを使用して、より早くスペースを解放しましょう

ディスクの容量が既に不足している場合は、Synapse がクリーンアップ用の管理エンドポイントを提供します。これらの操作により、メディアは完全に削除されます。使用する前に、データベースとメディアデータをバックアップし、URL が自分のホームサーバーを対象としていることを確認し、HTTPS 経由でサーバー管理者アクセストークンを使用してください。トークンはシェル履歴や共有ログに記録しないでください。

古いキャッシュされたリモートメディアを削除するには、Unixエポックからのミリ秒単位のカットオフタイムスタンプを指定して、ドキュメントに記載されているエンドポイントを呼び出します。

POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>

例えば、シェルはGNUを使って30日前のカットオフを計算できますdate。

cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
  -H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"

レスポンスでは、削除されたキャッシュアイテムの数が報告されます。ユーザーがこれらのリモートファイルを再度要求した場合、Synapseは元のサーバーから再度ファイルを取得します。これにより、よく使用されるメディアのディスク使用量を回復できます。

ローカルメディア削除APIは、最終アクセス時刻と、オプションで最小サイズに基づいてローカルメディアを削除できます。現在のエンドポイントは です。POST /_synapse/admin/v1/media/delete?before_ts=…以前のエンドポイント は<server_name>Synapse 1.78.0 以降非推奨となっています。カットオフはアップロード日ではなく最終アクセス時刻であり、このkeep_profilesオプションのデフォルト値は true です。この削除では、ユーザーが引き続き利用できることを期待しているファイルが削除される可能性があるため、適切なカットオフを特定してその影響を受け入れる場合を除き、保持期間を設定することをお勧めします。パラメータとインストールされている Synapse のバージョンについては、公式の API リファレンスを参照してください。

避けるべきよくある誤解

  • 「ルームを削除すると、その中のメディアもすべて消去される」と思い込まないでください。ルームの履歴、メディアファイル、キャッシュされたコピーは、それぞれ異なる操作で管理されます。メディアを個別に管理するには、メディア管理APIまたは保持ポリシーを使用してください。
  • 「隔離するとディスク容量が解放される」というのは誤りです。隔離されたメディアファイルやサムネイルはディスク上に残ります。ストレージ容量の解放が目的の場合は、削除または保持操作を使用してください。
  • 「リポジトリ内のすべてのメディアは、ユーザーがアップロードしたものです。」リポジトリには、リモートキャッシュとURLプレビューデータも含まれています。削除する前に、リポジトリのサブディレクトリとSynapseのストレージ構成を比較してください。
  • 「ファイルを手動で削除することは、Synapseのクリーンアップと同等です。」これはサポートされていない代替手段です。Synapseのメタデータは、保持プロセスまたは管理APIを通じて更新してください。

ディスク使用量が減少していることを確認してください。

クリーンアップワーカーの実行が完了したら、df -hメディアディレクトリのサイズを再度確認してください。API による削除の場合は、レスポンスで削除された件数を確認し、削除前後の関連ディレクトリを比較してください。Synapse のログで、構成エラーまたはワーカーエラーを確認してください。ディレクトリのサイズが大きいままの場合は、デプロイメントが構成済みのプロバイダまたは別のボリュームにメディアを書き込んでいるかどうかを確認してください。Synapse のローカルメディア削除 API は、外部メディアリポジトリに保存されているメディアには影響しません。ファイルが別の場所に存在する場合、API レスポンスが成功してもホストファイルシステムが縮小されるとは限りません。

公式資料

コメントを残す

SynapseのSystemdファイル制限を推測なしで引き上げる

SynapseのSystemdファイル制限を推測なしで引き上げる

Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。

要素に「復号化に失敗しました」と表示されますか?紛失したルームキーを復元してください。

要素に「復号化に失敗しました」と表示されますか?紛失したルームキーを復元してください。

エラーが特定のブラウザまたは特定のイベントに限定されているかどうかを確認し、残りの暗号化された履歴を危険にさらすことなく、Elementのリカバリキーまたは信頼できるデバイスを使用してください。

データを失うことなく、古いSynapseメッセージとメディアをクリーンアップする

Synapseの履歴およびメディア消去APIまたは保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。

Simple-Matrix-Bot-Libを使用してPythonでMatrix Echo Botを構築する

Simple-Matrix-Bot-Libを使用してPythonでMatrix Echo Botを構築する

最新のライブラリをインストールし、専用のMatrixアカウントに接続して、より安全な認証情報処理と明確なテストを備えた小型の!echoボットを実行します。

MatrixをWhatsApp、Telegram、Discordに個別のブリッジで接続する

MatrixをWhatsApp、Telegram、Discordに個別のブリッジで接続する

登録、ログイン、テストをそれぞれ別々に行う3つのmautrixブリッジを設定することで、Dockerのネットワーク、アカウントポリシー、同期に関する予期せぬ問題を回避できます。

共有ファイルを破損させることなくSynapse Mediaのディスク容量を解放する

Synapseストレージを占有しているファイルを特定し、安全なメディア保持期間を設定し、ディスクから直接ファイルを削除することなくリモートキャッシュを消去します。

ルーム履歴を削除せずに、非アクティブなマトリックスユーザーを無効化する

ルーム履歴を削除せずに、非アクティブなマトリックスユーザーを無効化する

デバイスのアクティビティを確認し、Admin API を介して確認済みの非アクティブな Synapse アカウントを無効化し、オプションの消去フラグが実際に何を削除するのかを学びます。

Matrix SynapseにおけるPostgreSQLのメモリ負荷を軽減する

PostgreSQLのメモリがクエリ処理、共有バッファ、接続、メンテナンスのいずれに起因しているかを特定し、Synapseに安全な変更を的確に行います。

マトリックスシナプスルームの結合が遅い理由と、確認すべき点

マトリックスシナプスルームの結合が遅い理由と、確認すべき点

Synapseの設定を変更する前に、Matrixルームへの参加が遅い原因を、リモートホームサーバー、フェデレーションのバックオフ、ローカルデータベースの負荷、または送信キューのいずれかに特定してください。

SynapseでMatrixサインアップを閉鎖するか、招待トークンを必須にする

自己ホスト型のSynapseサーバーでの新規アカウント作成を停止するか、登録を招待制にし、使用回数に制限のある登録トークンを使用するようにしてください。