モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする

最新の Matrix モバイル クライアントの場合、古いスタンドアロンの Sliding Sync プロキシを Docker Compose に追加しないでください。このプロキシは 2025 年 11 月にアーカイブされました。Synapse はネイティブの Simplified Sliding Sync を独自に提供しており、Synapse 1.114 以降はデフォルトで有効になっています。Synapse をサポート対象リリースに更新し、ネイティブ機能がパブリック URL 経由でクライアントに届くことを確認し、ネイティブ機能をサポートするクライアントで負荷を測定してください。

何が変わったのか、そしてあなたに必要なものは何か

「Sliding Sync」は元々、Synapse の前に配置され、個別のサービスと検出設定が必要だった MSC3575 のプロキシ実装を指していました。Matrix 仕様は進化し、MSC4186 (Simplified Sliding Sync) がその設計に取って代わりました。公式プロキシリポジトリはアーカイブされてお​​り、最新のクライアントはもはやそれを使用することは想定されていないとされています。Synapse は、v1.114.0 以降、MSC3575 と MSC4186 のネイティブサポートを追加し、デフォルトで有効にしました。これはSynapse の変更履歴に記載されています。

このガイドでは、Synapse が既に公開 HTTPS URL (例: ) の背後で Docker Compose を使用して実行されていることを前提としていますhttps://matrix.example.org。Compose プロジェクトへのシェル アクセス、イメージ タグとホームサーバー構成を編集する方法、および現在のバージョンがネイティブの Sliding Sync をサポートするモバイル アプリが必要です。サポートされていないクライアントで初期読み込みを高速化したいだけであれば、プロキシを追加してもそのクライアントがこの機能を使用するようにはなりません。

安全なSynapseアップデートを準備する

新規デプロイメントを過去の最小機能バージョンに固定するのではなく、現在サポートされている Synapse リリースを使用してください。移行元のバージョンの公式Synapse リリースとアップグレード ノートを確認してください。アップグレード前にデータベースと Synapse データ/構成ボリュームをバックアップし、ノートに中間アップグレード手順が必要かどうかを確認してください。これは特に古いインストール環境で重要です。Sliding Sync のルーム状態漏洩に関する Synapse のセキュリティ アドバイザリでは、v1.120.0 までの影響を受けるリリースがリストされており、v1.120.1 で修正されています。最初のパッチ適用済みバージョンだけでなく、より新しい修正が適用された、現在サポートされているリリースを選択してください。

Compose ファイルで、Synapse のサービス キーと、それが使用するイメージ タグを特定します。タグが古いバージョンに固定されている場合は、選択したサポート対象リリースに変更します。次に、そのサービスのみをプルして再作成します。synapseサービス名が異なる場合は、以下の部分を置き換えてください。

ターミナルに、SynapseイメージをプルするためのDocker Composeコマンドが表示されています。
デプロイメント用に選択したリリースに合わせてタグを更新した後、Synapseイメージをプルしてください。
docker compose pull synapse
Synapseサービスを再作成するためのDocker Composeコマンドが表示されたターミナル画面。
Synapseサービスを再作成して、Composeが選択したイメージを実行するようにします。
docker compose up -d synapse
docker compose logs --tail=100 synapse

続行する前に、起動エラーとデータベースのアップグレード完了状況についてログを確認してください。起動に失敗した場合でも、安易にダウングレードを実行しないでください。バージョン固有のアップグレードガイダンスを参照し、データベースに適した復旧プロセスを使用してバックアップを復元してください。

ネイティブのスライディング同期が有効になっていることを確認してください。

Synapse は通常、デフォルトでネイティブのスライディング同期を有効にするため、新規インストールでは追加の YAML は不要です。この設定は古い MSC という名前を保持しており、紛らわしい場合があります。これは Synapse のネイティブ実装を制御するものであり、廃止されたプロキシを実行するよう要求するものではありません。既存の設定homeserver.yamlで明示的に false の値がないか確認してください。見つかった場合は、既存の機能ブロックで変更してください。

YAMLエディタで、msc3575_enabledがtrueに設定されたexperimental_featuresを表示しています。
Synapseの設定でその機能が明示的に無効になっている場合は、既存のexperimental_featuresブロックで有効にしてください。
experimental_features:
  msc3575_enabled: true

既に存在する場合はexperimental_features、重複する YAML キーを追加するのではなく、そのブロックを編集してください。設定が存在しない場合、または既に true の場合は、そのままにしておいてください。設定変更後は Synapse サービスを再作成し、ログを確認してください。YAML のインデントエラーがあると、Synapse が起動しない場合があります。

廃止されたプロキシパスを削除して検出をテストします

で提供される JSON を調べますhttps://matrix.example.org/.well-known/matrix/client。古いorg.matrix.msc3575.proxyプロパティが含まれている場合は、無関係なクライアント検出エントリを保持したまま、そのプロパティを削除します。また、Matrix クライアントのリクエストを廃止されたプロキシに送信するリバースプロキシ ルールもすべて削除します。標準の/_matrix/client/API パスは Synapse に到達する必要があります。ネイティブ MSC4186 用に新しいプロキシ ポートを追加したり、プロキシ URL を公開したりしないでください。ホームサーバーの URL など、設定で必要なその他の既知の値は保持してください。

パブリックホームサーバーにアクセスできるマシンから、クライアント/サーバーバージョンのエンドポイントにクエリを実行します。これにより、プライベートDockerネットワーク上のコンテナだけでなく、クライアントが実際に検出するサービスも確認できます。

curlとjqコマンドを使用して、公開されているMatrixバージョンのエンドポイントから簡略化されたMSC3575機能を読み取るターミナル。
ネイティブのsimplified_msc3575機能について、公開ホームサーバーの応答を確認してください。
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'

ネイティブ サポートが有効でエンドポイントが正しくルーティングされている Synapse リリースの場合、これは を出力するはずですtrue。jqが利用できない場合は、curlパイプなしでリクエストを実行し、JSON フィールドを調べます。 が欠落しているか、偽の値は有用な障害シグナルです。DNS と HTTPS が想定されるサーバーに到達していること、リバース プロキシがクライアント API パスを Synapse に渡していること、実行中のイメージが選択したバージョンであること、明示的な構成で機能が無効になっていないことを確認してください。診断出力を共有する際にはアクセス トークンを公開しないでください。この公開バージョンのリクエストにはアクセス トークンは必要ありません。

互換性のあるスマートフォンで結果を確認してください

比較に使用するのと同じアカウントと電話機を使用して、ネイティブプロトコルをサポートするクライアントバージョンにサインインまたは再接続してください。可能であれば、サーバーを変更する前にベースラインを記録してください。ローカルアプリデータをクリアまたは再構築した後のコールドアプリの起動を比較する場合は、キャッシュされたコンテンツが削除されることを理解している場合に限ります。その後、通常のウォームスタートと、電話機がオフラインになった後の再接続を比較してください。ネットワーク、アカウント、ルーム設定、およびテスト方法を常に同じに保ってください。

  • アプリを起動してから部屋リストが使用可能になるまでの時間を計測してください。スプラッシュ画面が消えるまでの時間だけではなく、アプリを起動してから実際に使用できるまでの時間を計測してください。
  • 再接続後、最近のルーム名、未読状態、新着メッセージが速やかに表示されるかどうかを確認してください。
  • 同じテスト中に、Synapseのログを監視して、エンドポイントのエラー、繰り返しの再試行、またはワーカー/データベースへの負荷状況を確認してください。

最初のルームリストが速く、再接続後にスムーズに追いつけることは、クライアントが想定どおりのパスを使用していることを示す実際的な兆候です。速度向上は一律ではありません。クライアントの実装とローカルキャッシュ、ネットワーク遅延、データベースのパフォーマンス、アカウントのルーム数、サーバー負荷など、すべてが結果に影響します。また、Sliding Sync はメディアのダウンロードを高速化したり、過負荷状態のデータベースを修復したりしません。機能チェックに合格してもアプリが遅い場合は、プロキシまたはキャッシュの設定を変更する前に、サポートされている別のクライアントと比較し、ボトルネックを調査してください。廃止された MSC3575 プロキシに依存する古いクライアントをまだ運用している場合は、古い検出パスを削除する前に、互換性を個別にテストしてください。1 つのエンドポイントがすべての世代のクライアントに対応していると想定しないでください。

コメントを残す

モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする

モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする

廃止されたプロキシはスキップし、Synapseに組み込まれているスライディング同期を設定してください。クライアント検出機能をチェックした後、互換性のあるスマートフォンでルームリストの読み込みと再接続の動作を測定します。

カスタムホームサーバーを使用してNginx上でWebサイトをホストする

Element Webを静的サイトとしてデプロイし、Matrixホームサーバーに接続し、HTTPSを追加し、Nginxを設定して古いファイルなしで更新を配信します。

Raspberry Pi 4で軽量なMatrix Homeserverを実行する

64ビット版Raspberry Pi 4に、永続データ、HTTPSフェデレーション、保護された登録、および動作中のホームサーバーのチェック機能を備えたConduitをセットアップします。

独自のドメインにカスタムMatrixルームエイリアスを設定する

ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。

信頼性の高いマトリックス音声通話およびビデオ通話のためのcoturnを設定する

coturnとSynapseを一致するTURN認証情報で設定し、必要なリレーポートを開き、Matrixクライアントがリレー候補を取得できることを確認します。

Docker ComposeとPostgreSQLを使用してMatrix Synapseをデプロイする

Docker ComposeとPostgreSQLを使用してMatrix Synapseをデプロイする

Docker Compose、PostgreSQL、プライベート設定、およびHTTPS経由で公開する前にチェックを行う機能を備えた、永続的なSynapseホームサーバーをセットアップします。

Element Webのテーマとブランディングをカスタマイズする

Element Web デプロイメント用にブランド名、カスタムカラー、ログインアセットを設定すると同時に、どの部分が Element ブランドのままになるかを理解してください。

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

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

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

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

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

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

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

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