SynapseのSystemdファイル制限を推測なしで引き上げる
Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。
古い Matrix Synapse データを安全に削除するには、ルーム履歴とメディアを別々のジョブとして処理してください。古いルームイベントには履歴削除管理 API を、ローカルメディアにはメディア削除 API を、他のホームサーバーからダウンロードしたファイルにはリモートメディアキャッシュ API を使用してください。定期的なクリーンアップを行うには、メッセージとメディアの保持ポリシーを設定してください。データベース行を削除しても、ディスク上のデータベースファイルがすぐに縮小されるとは限りません。
| 何が場所を取っているのか? | 使用 | 重要な制限 |
|---|---|---|
| 古いメッセージとその他のルームイベント | 履歴削除管理API、または自動メッセージ保持 | 履歴の消去はルームごとに異なります。ルームの状態は保持され、Synapseは各ルームに少なくとも1つのメッセージを保持します。 |
| ホームサーバーに保存されているメディア | ローカルメディアAPIまたはローカルメディア保持を削除する | プロフィールやルームのアバターで使用されるメディアは、デフォルトで日付/サイズエンドポイントによって保護されています。 |
| 他のホームサーバーからキャッシュされたメディア | リモートメディアAPIの削除、またはリモートメディアの保持 | 再度要求された場合、Synapse は元のサーバーから再度データを取得します。 |
これらの制御は、Synapse のデータベースとメディアリポジトリに影響します。Matrix Media Repository などの外部メディアリポジトリを使用している場合、Synapse のローカルメディア削除エンドポイントでは、そこに保存されているファイルは削除されません。データを削除する前に、そのリポジトリのドキュメントとバックアップポリシーを確認してください。
enable_media_repo: true。これがメインプロセスである可能性があります。クリーンアップが実行されていないように見える場合は、診断を行う前にルーティングと構成を確認してください。以下の例では、https://matrix.example.com<homeserver> をクライアント側のベース URL に置き換え、有効なルーム ID を設定し、<administrator token> に管理者トークンをエクスポートしてくださいADMIN_TOKEN。ベアラートークンは秘密にしてください。
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と応答を保存してください。VACUUM FULLディスク領域を解放できますが、排他ロックが必要です。ダウンタイムや影響を考慮してスケジュールを立て、PostgreSQL の VACUUM ドキュメントに従ってください。SQLite の場合、Synapse の保持に関するドキュメントVACUUMで、対応する操作が示されています。Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。
エラーが特定のブラウザまたは特定のイベントに限定されているかどうかを確認し、残りの暗号化された履歴を危険にさらすことなく、Elementのリカバリキーまたは信頼できるデバイスを使用してください。
Synapseの履歴およびメディア消去APIまたは保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。
最新のライブラリをインストールし、専用のMatrixアカウントに接続して、より安全な認証情報処理と明確なテストを備えた小型の!echoボットを実行します。
登録、ログイン、テストをそれぞれ別々に行う3つのmautrixブリッジを設定することで、Dockerのネットワーク、アカウントポリシー、同期に関する予期せぬ問題を回避できます。
Synapseストレージを占有しているファイルを特定し、安全なメディア保持期間を設定し、ディスクから直接ファイルを削除することなくリモートキャッシュを消去します。
デバイスのアクティビティを確認し、Admin API を介して確認済みの非アクティブな Synapse アカウントを無効化し、オプションの消去フラグが実際に何を削除するのかを学びます。
PostgreSQLのメモリがクエリ処理、共有バッファ、接続、メンテナンスのいずれに起因しているかを特定し、Synapseに安全な変更を的確に行います。
Synapseの設定を変更する前に、Matrixルームへの参加が遅い原因を、リモートホームサーバー、フェデレーションのバックオフ、ローカルデータベースの負荷、または送信キューのいずれかに特定してください。
自己ホスト型のSynapseサーバーでの新規アカウント作成を停止するか、登録を招待制にし、使用回数に制限のある登録トークンを使用するようにしてください。