BigBlueButton FreeSWITCH SIP登録タイムアウトの修正：実践的な診断ガイド

BigBlueButton のミーティングは正常にロードされるものの、参加者が音声接続時にフリーズすることがあります。管理者は、ログや監視ツールに「SIP 登録タイムアウト」、「FreeSWITCH が登録されませんでした」、または音声接続エラーが表示される場合があります。これらのメッセージは必ずしも同じ障害を示しているわけではありません。標準的な BigBlueButton の展開では、音声接続の失敗は、FreeSWITCH プロセスの停止、SIP またはイベントソケット接続のブロック、NAT の背後にあるアドレスの誤り、または WebRTC メディアのブロックが原因である可能性があります。キャリアまたは PBX ゲートウェイの実際の登録タイムアウトは、別のケースです。

まず、どのコンポーネントがタイムアウトしているかを特定してください。次に、サービスの状態、ローカルリスナー、ネットワークパス、アドレスの順に確認してください。影響を受けるパスが特定できるまでは、SIP設定を変更したり、ポートを開放したりしないでください。

まず、「登録タイムアウト」が何を指すのかを特定します。

BigBlueButtonの現在のオーディオスタックは、bbb-webrtc-sfuFreeSWITCHとのメディア連携にこのサービスを利用しています。BigBlueButtonのドキュメントでは、SFUがFreeSWITCHのSIPサービスおよびイベントソケットレイヤー（ESL）に接続する方法について説明しています。これは、FreeSWITCHが外部SIPプロバイダにアウトバウンドゲートウェイを登録するのとは異なります。

• BigBlueButtonの音声接続に関する問題：ユーザーが音声に参加できない、FreeSWITCHに接続できない、またはSFUがタイムアウトを報告する。FreeSWITCH、ESL、設定されているSIPアドレスとポート、NAT、およびWebRTCトランスポートを調査してください。
• 外部ゲートウェイ登録の問題： FreeSWITCHが、設定済みのゲートウェイをダウンまたは未登録と報告します。プロバイダのホスト名、認証情報、トランスポート、ファイアウォールパス、およびプロバイダ側のアカウントステータスを調査してください。

どちらのケースに該当するか不明な場合は、エラーの全文と、そのエラーをログに記録したサービス名を保存してください。「登録タイムアウト」だけでは、SIPプロファイルを変更する正当な理由にはなりません。

1. BigBlueButtonの設定チェックを実行します。

サーバー上で、BigBlueButtonが推奨する診断を実行します。

sudo bbb-conf --check

すべての出力、特に「」というタイトルのセクションを確認してくださいPotential problems。このセクションでは、必要なプロセスが実行されているかどうかを確認し、一般的な構成上の問題点を報告します。警告は意図的なカスタマイズを反映している可能性があるため、提案された修正をすべて自動的に適用するのではなく、ご自身の設定と比較してください。

次に、サービスの状態を確認します。

sudo bbb-conf --status
sudo systemctl status freeswitch --no-pager
sudo systemctl status bbb-webrtc-sfu --no-pager

古いBigBlueButtonリリースでは、サービス名やコンポーネントのアーキテクチャが異なる場合があります。インストールされているバージョンを確認しsudo bbb-conf --version、そのリリースのドキュメントを参照してください。以下のパスと例は、主に開発中のBigBlueButton 4.0のドキュメントを参照しています。

2. FreeSWITCHが実行されており、ローカル接続を受け入れていることを確認します。

非アクティブ、失敗、または繰り返し再起動している場合はfreeswitch.service、設定を編集する前にジャーナルを確認してください。

sudo journalctl -u freeswitch.service -b --no-pager -n 100

直近の起動時に発生したバインド失敗、モジュール読み込みエラー、権限の問題、またはデータベースエラーを探してください。BigBlueButtonのトラブルシューティングガイドには、FreeSWITCHがIPv4またはESLポート8021にバインドできない具体的なケースが記載されています。また、再起動後にFreeSWITCHデータベースが破損している可能性も指摘していますが、データベースのクリーンアップは、該当するデータベースエラーが発生した場合にのみ推奨しています。

どのアドレスとポートがリッスンしているかを確認します。

sudo ss -luntp | grep -E ':(5060|5066|8021)\b'

SIPリスナーの正確な動作は、BigBlueButtonのバージョンと設定によって異なります。リスナーが見つからない場合は、FreeSWITCHがそのプロファイルの起動に失敗したか、別のアドレスにバインドされたことを示唆しています。ポート8021は、一般的なパッケージインストールにおけるローカルESL制御インターフェースです。通常はlocalhostまたは信頼できるプライベートネットワークに限定して使用してください。パブリックインターネットに公開しないでください。

FreeSWITCHがアクティブな場合、CLIを使用してSIPプロファイルの状態を確認できます。標準のFreeSWITCHコマンドは次のとおりです。sofia statusすべての展開で同じプロファイル名が使用されると想定するのではなく、サーバーに表示されるプロファイル名を使用してください。プロファイルがマークされている場合RUNNING、プロファイルが開始されたことは確認できますが、リモートブラウザーがオーディオメディアパスにアクセスできることを証明するものではありません。

3. エラーを障害が発生しているネットワークパスと照合する

BigBlueButtonのファイアウォールガイドでは、WebSocketシグナリング障害とICE/メディア障害を区別しています。この区別により、検索範囲を絞り込むことができます。

• WebRTCエラー1002：ブラウザがWebSocket接続を確立できませんでした。FreeSWITCHが実行されているか、SIP over WebSocketルートとリバースプロキシの設定、およびそのシグナリングパスに影響を与えるファイアウォールルールを確認してください。
• WebRTCエラー1007： WebSocket接続は成功しましたが、ブラウザは返されたアドレス候補を使用してメディア接続を確立できませんでした。通知されたIPアドレスと双方向UDP接続の可否を確認してください。

BigBlueButtonのデフォルトのファイアウォール設定では、公式ガイドに16384–32768リアルタイムメディア用のUDPポートが記載されています。クラウドセキュリティグループまたは境界ファイアウォールとホストファイアウォールの両方で、必要な範囲を許可してください。ルールはサーバーと必要なトラフィックに限定してください。無関係なSIPポートを広く開放しても、適切なNATおよびWebRTC設定の代わりにはなりません。

例えば、UFWを使用しており、この範囲がインストール環境に適していることを確認している場合は、既存のルールを調べてメディア範囲を追加します。

sudo ufw status numbered
sudo ufw allow 16384:32768/udp

クラウドファイアウォールとプロバイダのセキュリティグループも、トラフィックを許可する必要があります。ホストレベルのルールでは、ブロックされたアップストリームファイアウォールを上書きすることはできません。制限付きネットワーク上のユーザーのみが接続に失敗し、他のユーザーは接続できる場合は、FreeSWITCHを繰り返し再起動するのではなく、ネットワークパスまたはTURN構成を調査してください。

4. NATとアドバタイズされたIPアドレスを確認する

NAT の背後にあるサーバーは、正しいローカルリスナーを持ちながらも、ブラウザに到達できないプライベート アドレスを通知する可能性があります。外部 IP アドレス、ポート転送、および FreeSWITCH の設定が一致していることを確認してください。BigBlueButton の 4.0 ファイアウォール ガイドでは、 NAT の例として/opt/freeswitch/conf/vars.xmlとを使用し/opt/freeswitch/conf/sip_profiles/external.xml、/etc/bigbluebutton/bbb-webrtc-sfu/production.yml関連する SFU オーバーライドについては を参照しています。

サンプルIPアドレスをコピーしたり、すべてのフィールドにパブリックIPアドレスが該当すると想定したりしないでください。NAT構成では、FreeSWITCHがローカルにバインドするアドレスは、通知するパブリックアドレスと異なる場合があります。ネットワークトポロジーに合わせてバージョン固有の手順を適用し、関連するファイアウォール転送を確認してください。サーバーの外部アドレスが最近変更された場合は、DNSとBigBlueButton構成で保持されているアドレス値を確認してください。

サーバープロセスが自身のパブリックホスト名にアクセスする必要がある場合、ヘアピンNATまたはローカルホスト名解決も重要になることがあります。公式ファイアウォールガイドでは、/etc/hostsこのシナリオにおけるパブリックホスト名をファイアウォールアドレスにマッピングする方法について説明しています。この方法は、障害パターンが外部ホスト名を介したループバックを示している場合にのみテストしてください。登録タイムアウトに対する万能の解決策ではありません。

5. ログに外部SIPゲートウェイの名前が記載されている場合

障害が発生している項目がBigBlueButtonの内部オーディオパスではなく、指定されたキャリアゲートウェイである場合は、ゲートウェイの状態を別途確認してください。sofia status gateway <name>ゲートウェイの状態、sofia statusロードされたプロファイル、およびゲートウェイの状態については、FreeSWITCHのドキュメントを参照してください。プロバイダのホスト名がサーバーから解決されること、設定されているSIPユーザー名とパスワードが一致すること、選択されたトランスポートとポートがプロバイダの要件に一致すること、および送信ファイアウォールルールでシグナリングトラフィックが許可されていることを確認してください。

キャリアアカウントの修復のために、BigBlueButtonにバンドルされているSIPプロファイルをリセットしないでください。SIPトレース全体を公開することは避けてください。SIPトレースには、電話番号、IPアドレス、アカウント名、認証関連の詳細が含まれている可能性があります。プロバイダーまたは管理者にログの確認を依頼する前に、機密性の高い値を伏せ字にしてください。

6. 対象を絞った変更を適用し、一度再起動する

サービス、アドレス、またはファイアウォールの問題が修正されたら、サポートされているコマンドを使用してBigBlueButtonを再起動してください。

sudo bbb-conf --restart

sudo bbb-conf --cleanリリース固有のドキュメントまたは診断結果で必要とされる場合にのみ使用してください。これは、あらゆる SIP タイムアウトに対する一般的な対応策ではありません。同様に、文書化されたデータベース破損の症状が現れない限り、FreeSWITCH データベース ファイルを削除しないでください。状態を削除する修復を行う前に、ログと構成のバックアップを保存してください。

修理内容を確認してください

再度実行してsudo bbb-conf --check、FreeSWITCH がbbb-webrtc-sfu正常に動作していることを確認してください。サーバーのネットワーク外のブラウザーからテストミーティングに参加し、マイクまたはリスニング専用オーディオを選択して、接続が完了することを確認してください。NAT またはファイアウォールの変更については、以前に失敗したネットワークから少なくとも 1 つテストしてください。緑色のサービスステータスだけでは、UDP メディアがネットワークを通過できることの証明にはなりません。

タイムアウトが解消されない場合は、BigBlueButtonのバージョン、エラーメッセージ全文、関連するbbb-conf --check出力、サービスステータス、最近のFreeSWITCHおよびSFUジャーナルエントリ、ネットワークトポロジを収集してください。機密情報および公開ユーザーデータは削除してください。これらの情報は、リスナーの停止、ESLタイムアウト、誤ったアドレスの通知、ブロックされたメディア範囲、およびSIPゲートウェイ登録の失敗を区別するのに役立ちます。

公式資料

• BigBlueButton 4.0 トラブルシューティングガイド
• BigBlueButton 4.0 ファイアウォール設定
• FreeSWITCH CLIおよびAPIコマンドリファレンス
• Sofiaを使用したFreeSWITCH SIPプロファイル

ドキュメントは2026年10月6日に確認済みです。BigBlueButtonの4.0ドキュメントでは、このバージョンは開発中とされています。サーバーにインストールされているリリース版と照らし合わせて、パスとコマンドを確認してください。