独自のドメインにカスタムMatrixルームエイリアスを設定する
ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。
Matrix ルームに のようなアドレスを割り当てるには#support:example.com、設定済みのサーバー名が であるホームサーバー上にローカルルームエイリアスを作成しexample.com、そのエイリアスを Element でルームのメインアドレスとして選択します。ルームエイリアスごとに個別の DNS レコードは必要ありませんが、既存のホームサーバーのエイリアスドメインを DNS の方向を指定するだけで変更することはできません。
ルームエイリアスとは、Matrixルームの永続的なルームID(通常は「」で始まる識別子)に解決される読み取り可能なアドレスです!。1つのルームには複数のエイリアスを設定できます。たとえば、「」#support:example.comと#help:example.com「」はどちらも同じルームを指します。コロンの後のテキストは、そのエイリアスを解決するホームサーバーを識別するものであり、必ずしもすべての参加者をホストするサーバーを識別するものではありません。
Matrix では、エイリアスを の形式で定義します#localpart:server-name。Synapse の場合、このserver_name設定はローカルで作成されたルーム アドレスに使用されるドメインを決定し、Synapse のドキュメントには、この設定は初期設定後には変更できないと記載されています。既存のサーバー名が の場合、 を所有しているという理由だけでmatrix.example.comElement がローカル エイリアスを に変更することはありません。Matrix識別子仕様とSynapse 設定マニュアルを参照してください。#support:example.comexample.com
https://matrix.example.comその設定がserver_nameであると想定していますexample.com。クライアントURLとサーバー名は異なる場合があります。support。エイリアスは、作成元のサーバー上で一意である必要があります。以下のパスは、2026年10月に確認されたElementのルーム設定に関するドキュメントに記載されているルーム設定の用語と一致しています。メニューの位置は、Elementのバージョンや他のMatrixクライアントによって異なる場合があります。
Element WebまたはElement Desktopで、目的のルームを開きます。ルーム情報パネルから「ルーム設定」を選択するか、ルームの3点メニューから「設定」を選択します。後でトラブルシューティングのために内部ルームIDが必要な場合は、「詳細設定」セクションを確認し、文字を変更せずにコピーしてください。
一般設定ページで、 「ルームアドレス」を見つけてから「ローカルアドレス」を選択します。 「ルームアドレス」supportフィールドにエイリアス localpart(例:)を入力し、「追加」または同等の保存コントロールを選択します。結果として得られる完全なアドレスが であることを確認してください。代わりに で終わる場合は、そこで作業を中止してください。これはホームサーバー名の問題であり、ルーム設定で修正できるタイプミスではありません。#support:example.com:matrix.example.com
「ルームアドレス」の下にある「公開アドレス」を見つけて、 「メインアドレス」を「 」に設定します#support:example.com。Elementのドキュメントによると、通常、最初に作成されたローカルアドレスが自動的にメインアドレスとして選択されます。このアドレスを明示的に選択すると、ルームに複数のエイリアスが既に存在する場合に便利です。
メインアドレスは、ルームの正規エイリアス、つまりルームステートで通知される優先アドレスです。エイリアスの作成と正規エイリアスの選択は関連していますが、それぞれ異なる操作です。Matrixは、代替の通知エイリアスもサポートしています。正規エイリアスは、通知される前にそのルームに解決される必要があります。
ディレクトリ検索機能が必要な場合にのみ、「このルームを公開ルームディレクトリに公開」を有効にしてください。アドレスを設定しただけではルームが公開されるわけではなく、ルームの公開は参加ルールとは別個のものです。プライベートルームや招待制ルームでも、全員に参加権限を与えなくても、覚えやすいエイリアスを設定できます。公開コミュニティルームの場合は、アドレスを広く共有する前に、ディレクトリ設定とルームの参加ルールの両方を確認してください。
管理者と自動化ツールは、標準のMatrix Client-Server API を使用できます。以下の例では同じエイリアスを作成します。Elementが既に作成されている場合は実行しないで#support:example.comください。実際のルーム ID と、ホームサーバーのエイリアス ポリシーで許可されているユーザーの有効なアクセス トークンに置き換えてください。トークンはパスワードとして扱います。
curl --request PUT \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{"room_id":"!yourRoomId:example.com"}' \
'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'
リクエストが成功すると、200空の JSON オブジェクトを含む HTTP が返されます。%23と の部分は、と の%3AURL エンコードです。 PUT リクエストはエイリアスとルームのマッピングを作成しますが、必ずしもルームの正規エイリアスを変更するわけではありません。 API のみで作成した後、そのエイリアスをプライマリとして公開したい場合は、Element のメイン アドレス コントロールに戻ってください。実際のベアラー トークンを共有シェル コマンド、スクリーンショット、またはサポート チケットに貼り付けないでください。#:
ディレクトリ検索にはログインは不要です。URLホストを、アクセス可能なクライアントAPIエンドポイントに置き換えてください。
curl --fail-with-body --silent --show-error \
'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'
応答には、room_id宛先ルームと一致するIDとservers配列が含まれている必要があります。これはエイリアス解決をテストするものであり、すべてのリモートサーバーがあなたのサーバーと連携できるかどうかをテストするものではありません。
Synapse の設定を確認してくださいserver_name。既存のサーバーのエイリアスをリブランディングしようとして、その値を変更しないでください。サーバーの ID と既存の Matrix 識別子は、この値に依存しています。新規展開の場合は、ユーザーとルームを作成する前に、希望するサーバー名を計画してください。既に別の名前で運用している場合は、新しいエイリアスを所有する適切な名前のホームサーバーを用意できない限り、実際のエイリアスドメインを使用する方が安全な選択肢となる可能性があります。
HTTP は403通常、アクセス権限が拒否されたか、サーバー ポリシーが適用されることを示します。ユーザーのルーム権限と Synapse のalias_creation_rules; ルールは順番に評価され、明示的に空のリストを指定すると、すべてのエイリアスの作成が阻止されます。HTTP は、409エイリアスが既に存在することを意味します。既存のマッピングを盲目的に上書きするのではなく、別の localpart を選択するか、既存のマッピングを調査してください。エイリアス ポリシー オプションについては、Synapse の設定マニュアルを参照してください。
まず、エイリアスがローカルで解決されることを確認してください。ローカルでの検索は成功するものの、外部での検出が失敗する場合は、HTTPS 証明書、関連する委任、公開されているフェデレーション リスナーなど、エイリアス/.well-known/matrix/serverドメインのフェデレーションを調べてください。クライアント トラフィックに使用されるホスト名は、別の Matrix サーバー名に対して自動的にフェデレーションを確立するものではありません。サーバーの検出と委任については、Matrix Server-Server APIを参照してください。また、リモート ユーザーが参加できることを確認してください。招待制のルームは、参加を拒否しながらも正常に解決される場合があります。
#support:example.comの下に表示され、要素の意図したメインアドレスとして表示されていることを確認してください。room_idルーム設定に表示されているIDと比較してください。https://matrix.to/#/%23support%3Aexample.com。リンクは目的のルームに繋がるはずですが、アカウントが参加できるかどうかは、ルームのアクセスルールによって異なります。Matrixのroom-aliasとmatrix.toフォーマットリファレンスは、エンコードされた共有リンクのフォーマットを定義します。3つのチェックすべてに合格すれば、新しいアドレスは共有可能になり、元のルームIDは変更されません。
ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。
coturnとSynapseを一致するTURN認証情報で設定し、必要なリレーポートを開き、Matrixクライアントがリレー候補を取得できることを確認します。
Docker Compose、PostgreSQL、プライベート設定、およびHTTPS経由で公開する前にチェックを行う機能を備えた、永続的なSynapseホームサーバーをセットアップします。
Element Web デプロイメント用にブランド名、カスタムカラー、ログインアセットを設定すると同時に、どの部分が Element ブランドのままになるかを理解してください。
Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。
エラーが特定のブラウザまたは特定のイベントに限定されているかどうかを確認し、残りの暗号化された履歴を危険にさらすことなく、Elementのリカバリキーまたは信頼できるデバイスを使用してください。
Synapseの履歴およびメディア消去APIまたは保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。
最新のライブラリをインストールし、専用のMatrixアカウントに接続して、より安全な認証情報処理と明確なテストを備えた小型の!echoボットを実行します。
登録、ログイン、テストをそれぞれ別々に行う3つのmautrixブリッジを設定することで、Dockerのネットワーク、アカウントポリシー、同期に関する予期せぬ問題を回避できます。
Synapseストレージを占有しているファイルを特定し、安全なメディア保持期間を設定し、ディスクから直接ファイルを削除することなくリモートキャッシュを消去します。