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

古い Matrix Synapse データを安全に削除するには、ルーム履歴とメディアを別々のジョブとして処理してください。古いルームイベントには履歴削除管理 API を、ローカルメディアにはメディア削除 API を、他のホームサーバーからダウンロードしたファイルにはリモートメディアキャッシュ API を使用してください。定期的なクリーンアップを行うには、メッセージとメディアの保持ポリシーを設定してください。データベース行を削除しても、ディスク上のデータベースファイルがすぐに縮小されるとは限りません。

あなたの目標に合った清掃方法を選びましょう

何が場所を取っているのか?使用重要な制限
古いメッセージとその他のルームイベント履歴削除管理API、または自動メッセージ保持履歴の消去はルームごとに異なります。ルームの状態は保持され、Synapseは各ルームに少なくとも1つのメッセージを保持します。
ホームサーバーに保存されているメディアローカルメディアAPIまたはローカルメディア保持を削除するプロフィールやルームのアバターで使用されるメディアは、デフォルトで日付/サイズエンドポイントによって保護されています。
他のホームサーバーからキャッシュされたメディアリモートメディアAPIの削除、またはリモートメディアの保持再度要求された場合、Synapse は元のサーバーから再度データを取得します。

これらの制御は、Synapse のデータベースとメディアリポジトリに影響します。Matrix Media Repository などの外部メディアリポジトリを使用している場合、Synapse のローカルメディア削除エンドポイントでは、そこに保存されているファイルは削除されません。データを削除する前に、そのリポジトリのドキュメントとバックアップポリシーを確認してください。

処分する前に準備する

  1. どの Synapse インスタンスがメディアを処理しているかを確認してください。ワーカーデプロイメントでは、メディアのクリーンアップはワーカー上で実行されますenable_media_repo: true。これがメインプロセスである可能性があります。クリーンアップが実行されていないように見える場合は、診断を行う前にルーティングと構成を確認してください。
  2. データベースとメディアストアをバックアップしてください。不可逆的な削除を行う前に、最新の復元可能なバックアップを取得してください。ルームIDとカットオフ時間を記録し、サーバー管理者アクセストークンを使用してください。トークンを共有シェル履歴に貼り付けたり、ログに公開したりしないでください。
  3. カットオフ時間は慎重に計画してください。パージエンドポイントはUnixミリ秒単位のタイムスタンプを受け入れます。UTCに基づくカットオフ時間を使用し、リクエストを送信する前にその数値を確認してください。カットオフ時間はプレビューではなく、対象となるデータを永久に削除する可能性があります。

以下の例では、https://matrix.example.com<homeserver> をクライアント側のベース URL に置き換え、有効なルーム ID を設定し、<administrator token> に管理者トークンをエクスポートしてくださいADMIN_TOKEN。ベアラートークンは秘密にしてください。

1つの部屋から古いメッセージ履歴を削除する

Purge History API は、Synapse のデータベースから指定された時点より古いイベントを削除します。他のサーバーのメッセージは削除されず、ルームの削除とは異なります。デフォルトでは、Synapse はリモート ユーザーが送信したイベントを削除しますが、ローカル ユーザーのイベントは保持します。ローカル ユーザーのイベントも削除したい場合にのみ、この設定を有効delete_local_eventsにしてくださいtrue。メンバーシップやトピックなどのルームの状態は保持されます。

例えば、Linuxホスト上で現在時刻の180日前をカットオフ日として設定するには、タイムスタンプをミリ秒単位で計算し、それを確認してから、単一の部屋の予約リクエストを送信します。

export SYNAPSE_URL='https://matrix.example.com'
export ROOM_ID='!roomid:example.com'
export ADMIN_TOKEN='replace-with-a-server-admin-token'
PURGE_BEFORE_MS=$(python3 -c 'import time; print(int((time.time() - 180*86400) * 1000))')
printf 'Cutoff (Unix milliseconds): %s\n' "$PURGE_BEFORE_MS"

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_history/$ROOM_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"purge_up_to_ts\":$PURGE_BEFORE_MS,\"delete_local_events\":true}"

Synapse のデフォルトの動作が必要な場合は、省略するdelete_local_eventsか、に設定してください。API が を返す場合、パージが開始されていますが、必ずしも完了しているとは限りません。ステータスエンドポイントが を報告するまでポーリングするか、ステータスが の場合はその を調査してください。falsepurge_idcompleteerrorfailed

curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

大規模な削除には数分以上かかる場合があります。削除処理中は、削除対象の時点から前のページに移動できなくなる可能性があります。Synapseは各ルームに少なくとも1つのメッセージを保持するため、このAPIを使用してもルームのタイムラインが完全に空になることはありません。

古いメディアファイルとキャッシュされたリモートファイルを削除します。

カットオフ前に最後に使用されたローカルメディアを一度だけクリーンアップするには、現在のローカルメディアエンドポイントを使用します。これはbefore_tsミリ秒単位のUnixタイムスタンプで、size_gtバイトしきい値を超えるファイルを対象とすることもできます。デフォルトでは、プロフィール画像やルームアバター画像に使用されているメディアは保持されます。これらのファイルを意図的に削除したい場合を除き、この設定は行わないでくださいkeep_profiles=false。

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/media/delete?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

レスポンスtotalと削除されたメディア ID を確認してください。エンドポイントはローカルのオリジナルとサムネイルを削除します。 を含む古いパスは使用しないでください/media/<server_name>/delete。Synapse のドキュメントでは、v1.78.0 以降、そのルートは非推奨となっています。現在のローカル メディア エンドポイントは、別の外部メディア リポジトリでは動作しません。

キャッシュされたリモートメディアは別のカテゴリです。同じカットオフ時刻より前に最後にアクセスされたキャッシュ内のリモートメディアを削除するには、以下を使用します。

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_media_cache?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

レスポンスでは、削除されたキャッシュアイテムの数が報告されます。ユーザーが後でこれらのファイルを要求した場合、Synapseは元のサーバーから再度ダウンロードする可能性があるため、この操作ではローカルディスクの使用量が増加する代わりに、ネットワークトラフィックと取得遅延が発生する可能性があります。

手動での削除を繰り返す代わりに、定期的な保持期間を設定してください。

Synapseメッセージの保持は、デフォルトでは無効になっています。保持状態が設定されていないルームに対してサーバー全体のデフォルト設定を適用するには、設定にポリシーを追加して有効にします。この例では、最大保持期間を1年と設定しています。

retention:
  enabled: true
  default_policy:
    max_lifetime: 1y

Synapse でサポートされている期間単位 (d日数やy年など) を使用してください。ルーム管理者とモデレーターはルームの状態イベントを設定することもできますが、サーバー管理者は許可される最大有効期間をm.room.retentionと で制限できます。有効にする前にポリシー全体を確認してください。対象となるイベントはバックグラウンドのパージ ジョブによって完全に削除されます。Synapse は期限切れのイベントを期限切れになるとすぐにクライアントから非表示にしますが、データベースのパージは定期的に実行されるため、ジョブが実行されるまで行が残る場合があります。状態イベントはメッセージ保持の対象外です。allowed_lifetime_minallowed_lifetime_max

メディアの場合、media_retention例えば以下のようにライフタイムを追加します。

media_retention:
  local_media_lifetime: 90d
  remote_media_lifetime: 14d

これらの有効期間は、単なるアップロード期間の制限ではなく、非アクティブ期間を表します。ファイルにアクセスがあった場合、Synapse はその最終アクセス時刻を使用します。アクセスされていないメディアについては、作成時刻を使用します。オリジナルファイルとサムネイルは削除されます。隔離されたメディアと隔離から保護されたローカルメディアは、このクリーンアップでは削除されません。メディアリポジトリをホストするプロセスでメディア保持を設定し、使用している Synapse のバージョンに対応する設定マニュアルを参照して設定を確認してください。

変更を適用する前に、公式の履歴削除API、メディア管理API、Synapse構成マニュアル、およびメッセージ保持ポリシーのドキュメントをお読みください。ここで説明するAPIの動作は、2026年10月10日に確認された公式ドキュメントに基づいています。エンドポイントと構成は、インストールされているリリースに合わせて確認してください。

ストレージが解放されたことを確認する

  • 履歴消去ステータスが「完了」と表示されるまでポーリングしcomplete、メンテナンスログ用に消去IDと応答を保存してください。
  • ローカルメディアとリモートキャッシュの応答を確認し、削除された件数を調べてから、クリーンアップ後にSynapseログとファイルシステムの使用状況を調べます。
  • データベースの行数が少ないからといって、必ずしもデータベースファイルが小さくなるとは限りません。Synapse のドキュメントには、PostgreSQL は解放された領域をオペレーティングシステムに返さずに再利用する可能性があると記載されています。PostgreSQL では、VACUUM FULLディスク領域を解放できますが、排他ロックが必要です。ダウンタイムや影響を考慮してスケジュールを立て、PostgreSQL の VACUUM ドキュメントに従ってください。SQLite の場合、Synapse の保持に関するドキュメントVACUUMで、対応する操作が示されています。
  • メンテナンス作業を終了する前に、想定されるファイルや古いイベントが配信されなくなったことを確認し、バックアップが引き続き利用可能であることを確認してください。

コメントを残す

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サーバーでの新規アカウント作成を停止するか、登録を招待制にし、使用回数に制限のある登録トークンを使用するようにしてください。