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

参加者が異なるネットワーク上にいる場合にMatrixコールが失敗する場合は、パブリックIPアドレスを持つホストにcoturnをデプロイし、時間制限付きのTURN REST認証情報を有効にして、同じ共有シークレットとTURN URIを使用してSynapseを設定します。次に、TURNリスナーとUDPリレー範囲がすべてのファイアウォールを通過するようにします。STUNはクライアントがネットワークパスを検出するのに役立ちますが、直接パスを確立できない場合にメディアを伝送するのはTURNです。

この設定は、自己ホスト型のSynapseホームサーバーと、静的パブリックIPv4アドレスを持つ別のDebianまたはUbuntu TURNホストに対応しています。この例では、coturnのデフォルトリスナーをポート3478で使用し、デフォルトのUDPリレー範囲49152~65535を使用します。例のドメイン、シークレット、パスはご自身のものに置き換えてください。coturnがNATの背後にある場合は、下記のNATに関する注記を参照してください。直接アクセス可能なパブリックホストの方がシンプルで信頼性が高くなります。

1. TURNホスト名をサーバーに向けます。

coturnホストのパブリックIPv4アドレスを指すDNS Aレコードを作成しますturn.example.com。専用のホスト名を使用することで、ネットワーク設定と証明書設定をMatrixウェブサービスとは独立して管理できます。coturnに有効なIPv6接続と対応するファイアウォールルールが設定されていない限り、AAAAレコードを公開しないでください。到達不能なIPv6アドレスがあると、一部のクライアントが接続に失敗する経路を選択してしまう可能性があります。

Synapseの現在のTURNに関するドキュメントによると、TURNサービスにはパブリックIPエンドポイントが必要です。NATは、ゲートウェイがパブリックアドレスを持ち、必要なポートを正しく転送する場合にのみ機能します。また、ドキュメントでは、NATの設定は依然として不安定な場合があると警告しています。Synapse TURNの設定に関するドキュメントを参照してください。

2. coturnをインストールし、認証リレーを設定します。

DebianまたはUbuntuでは、ディストリビューションパッケージをインストールしてください。

sudo apt update
sudo apt install coturn

エディタでファイルを開き/etc/turnserver.conf、以下の重要な設定を構成してください。パスワードマネージャーまたは暗号的に安全なジェネレータを使用して、長いランダムな秘密鍵を生成してください。生成した秘密鍵は後でSynapseに正確に保存してください。Matrixのユーザーパスワードを再利用したり、秘密鍵を公開リポジトリに公開したりしないでください。

listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=REPLACE_WITH_A_LONG_RANDOM_SECRET
realm=turn.example.com
server-name=turn.example.com
min-port=49152
max-port=65535

use-auth-secretまた、static-auth-secretSynapse が一時的な認証情報を発行するために使用する TURN REST 認証情報メカニズムを有効にします。 はrealmTURN サービスのドメイン名である必要があります。リレー ポート範囲はリスナーとは別です。クライアントはポート 3478 に接続して割り当てを要求し、その後メディアは割り当てられたリレー ポートを使用します。coturnの構成例には、リスナー、リレー、TLS、および外部 IP オプションが記載されています。配布パッケージのデフォルト値とパスは異なる場合があります。

サービスを有効にして起動し、その状態を確認してください。

sudo systemctl enable --now coturn
sudo systemctl status coturn

パッケージに個別の有効化フラグがある場合は/etc/default/coturn、サービスを開始する前にそのファイルの指示に従ってください。sudo journalctl -u coturn -eサービスが起動しない場合は、ログを確認してください。

3. リスナーおよびリレーのトラフィックを許可する

ホストファイアウォールおよびプロバイダレベルのファイアウォールで、ポート3478でのUDPおよびTCPの受信、ならびにポート49152~65535でのUDPの受信を許可します。たとえば、UFWを使用する場合:

sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status

リレー範囲は、デプロイメントでサポートできる範囲でできるだけ狭くし、coturnmin-portとmax-portファイアウォールの範囲を一致させてください。TLS リスナーを有効にする場合は、その設定済みポートも開き、一致するturns:URI と証明書設定を使用してください。この基本的な例では、TURN 接続での TLS はオプションです。Synapse の手順では、TURN が通常の UDP/TCP リスナーを使用している場合でも WebRTC の音声およびビデオ メディアは暗号化されたままですが、シグナリングのセキュリティは Matrix HTTPS の設定に依存すると記載されています。

NATの背後にあるホストの場合、coturnのexternal-ip=PUBLIC_IP/PRIVATE_IPマッピングを設定し、外部リレーポート番号を変更せずに、ポート3478とリレー範囲全体をcoturnホストに転送します。たとえば、パブリックリレーポート52000は内部ポート52000に到達する必要があります。Synapseのガイダンスによると、NATは依然として問題を引き起こす可能性があるため、広範囲のUDP範囲を転送できない場合は、coturnをパブリックIPのVPSに配置する方が通常はより現実的な選択肢です。

4. Synapseをcoturnに接続する

アクティブな Synapse 設定ファイル (通常は ) に以下の設定を追加しますhomeserver.yaml。ホスト名、ポート、およびシークレットを coturn 設定と一致させてください。

turn_uris:
  - "turn:turn.example.com:3478?transport=udp"
  - "turn:turn.example.com:3478?transport=tcp"
turn_shared_secret: "REPLACE_WITH_A_LONG_RANDOM_SECRET"
turn_user_lifetime: 86400000
turn_allow_guests: false

有効期間はミリ秒単位です。この例では、Synapse に 24 時間有効な認証情報を発行するように要求しています。ゲスト アクセスは登録ポリシーに従って設定してください。登録済みユーザーの通話を有効にするためだけに必要というわけではありません。 はturn_shared_secretプライベートに保ち、coturn のものと同一にしてくださいstatic-auth-secret。 TURN の代わりに URI を追加しないでくださいstun:。この 2 つのプロトコルは関連していますが、異なる役割を果たします。

YAML構文の検証後、Synapseを再起動してください。

sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service

コンテナ展開では、マウントされたSynapse構成を更新し、代わりにSynapseコンテナを再起動する必要があります。クライアントはサーバー構成を再読み込みまたは更新する必要がある場合があります。Synapseによると、クライアントがTURN設定を更新するには最大で約1時間かかる場合があるとのことです。

リレー候補を検証する

TURNサーバーとは異なるネットワーク上のブラウザまたはデバイス(携帯電話のデータ通信を使用する端末など)からテストしてください。ブラウザベースのMatrixクライアントでは、認証済みのホームサーバーへのリクエストを検査します/_matrix/client/v3/voip/turnServer(古いクライアントではレガシー/r0/パスを使用する場合があります)。レスポンスにはTURN URIと一時的なユーザー名/パスワードフィールドが含まれているはずです。Matrix仕様では、このエンドポイントの認証情報レスポンスが定義されています。

公式のWebRTC Trickle ICE テストでこれらの認証情報を使用し、などのサーバーを入力してturn:turn.example.com:3478?transport=udp、ページに候補タイプのフィルタリング機能がある場合はリレー テストを選択します。テストが成功すると、タイプがである候補が表示されますrelay。最後に、別々のネットワーク上のデバイス間で Matrix コールを発信します。呼び出し音が鳴っても「接続中」のままの場合は、リレー ポートがブロックされている、NAT マッピングが間違っている、または認証情報が一致していないことが原因である可能性があります。無関係なコール設定を変更する前に、coturn ログと Synapse の TURN トラブルシューティング ノートを確認してください。

ブラウザの診断については、Synapse はchrome://webrtc-internals/Chrome とFirefox でそれぞれ推奨しています。リレー候補が表示されない場合は、まずシークレットが完全に一致することを確認し、次にホストとプロバイダのファイアウォールの両方で UDP 3478 とリレー範囲全体を確認してください。coturn プロジェクトでは、turnserver リファレンスabout:webrtcでポートと外部 IP オプションについて説明しています。

コメントを残す

独自のドメインにカスタム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または保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。

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