Une réunion BigBlueButton peut se charger normalement, mais les participants peuvent rester bloqués lors de la connexion audio. Les administrateurs peuvent voir des messages d'erreur tels que « Délai d'enregistrement SIP dépassé », « FreeSWITCH n'a pas pu s'enregistrer » ou une erreur de connexion audio dans les journaux ou les outils de surveillance. Ces messages ne signalent pas toujours la même panne. Dans une configuration BigBlueButton standard, une panne de connexion audio peut provenir d'un processus FreeSWITCH arrêté, d'une connexion SIP ou Event Socket bloquée, d'une adresse IP incorrecte derrière un NAT ou d'un flux WebRTC bloqué. Un délai d'enregistrement dépassé auprès d'un opérateur ou d'une passerelle PBX est un cas distinct.
Commencez par identifier le composant qui expire. Vérifiez ensuite l'état du service, les écouteurs locaux, les chemins réseau et les adresses, dans cet ordre. Évitez de modifier les paramètres SIP ou d'ouvrir des ports tant que le chemin affecté n'est pas identifié.
La pile audio actuelle de BigBlueButton utilise ce bbb-webrtc-sfuservice pour coordonner les flux multimédias avec FreeSWITCH. La documentation de BigBlueButton décrit la connexion du SFU au service SIP et à la couche de sockets d'événements (ESL) de FreeSWITCH. Ceci diffère de l'enregistrement par FreeSWITCH d'une passerelle sortante auprès d'un fournisseur SIP externe.
En cas de doute, conservez le texte complet de l'erreur et le nom du service qui l'a enregistrée. Un simple « délai d'enregistrement dépassé » ne justifie pas la modification d'un profil SIP.
Sur le serveur, exécutez le diagnostic recommandé par BigBlueButton :
sudo bbb-conf --checkExaminez attentivement tous les résultats, en particulier la section intitulée « » Potential problems. Celle-ci vérifie si les processus requis sont en cours d'exécution et signale les problèmes de configuration courants. Un avertissement peut indiquer une personnalisation intentionnelle ; comparez-le donc à votre configuration au lieu d'appliquer automatiquement toutes les corrections suggérées.
Vérifiez ensuite l'état du service :
sudo bbb-conf --status
sudo systemctl status freeswitch --no-pager
sudo systemctl status bbb-webrtc-sfu --no-pagerSur les versions antérieures de BigBlueButton, les noms de services ou l'architecture des composants peuvent différer. Vérifiez votre version installée sudo bbb-conf --versionet consultez la documentation correspondante. Les chemins d'accès et les exemples ci-dessous se réfèrent principalement à la documentation de BigBlueButton 4.0, actuellement en développement.
Si freeswitch.servicele processus est inactif, défaillant ou redémarre de manière répétée, consultez son journal avant de modifier la configuration :
sudo journalctl -u freeswitch.service -b --no-pager -n 100Recherchez les échecs de liaison, les erreurs de chargement de modules, les problèmes d'autorisation ou les erreurs de base de données à proximité du dernier démarrage. Le guide de dépannage de BigBlueButton documente les cas spécifiques où FreeSWITCH ne parvient pas à se lier à IPv4 ou au port ESL 8021. Il identifie également une base de données FreeSWITCH corrompue comme cause possible après un redémarrage, mais recommande un nettoyage de la base de données uniquement lorsque les erreurs correspondantes sont présentes.
Vérifiez quelles adresses et quels ports sont à l'écoute :
sudo ss -luntp | grep -E ':(5060|5066|8021)\b'Le client SIP exact dépend de votre version et de votre configuration BigBlueButton. L'absence de client indique que FreeSWITCH n'a pas pu démarrer ce profil ou qu'il est lié à une autre adresse. Le port 8021 est l'interface de contrôle ESL locale dans une installation standard ; il doit normalement rester restreint à l'hôte local ou à un réseau privé de confiance. Ne l'exposez pas à Internet.
Si FreeSWITCH est actif, vous pouvez consulter l'état des profils SIP via son interface de ligne de commande (CLI). La commande standard de FreeSWITCH estsofia status ; utilisez les noms de profils affichés par votre serveur plutôt que de supposer que tous les déploiements utilisent les mêmes. Un profil marqué comme démarré RUNNINGconfirme que le profil a démarré, mais ne garantit pas que les navigateurs distants peuvent accéder au flux audio.
Le guide du pare-feu de BigBlueButton établit une distinction entre une défaillance de signalisation WebSocket et une défaillance ICE/média. Cette distinction permet de restreindre la recherche :
Pour la configuration par défaut du pare-feu BigBlueButton, le guide officiel indique les ports UDP 16384–32768pour les flux multimédias en temps réel. Autorisez la plage requise à la fois dans le groupe de sécurité cloud ou le pare-feu de périmètre et dans le pare-feu hôte. Limitez la règle au serveur et au trafic nécessaire ; l’ouverture de ports SIP non pertinents ne remplace pas une configuration NAT et WebRTC correcte.
Par exemple, si vous utilisez UFW et avez confirmé que cette plage convient à votre installation, examinez les règles existantes et ajoutez la plage de supports :
sudo ufw status numbered
sudo ufw allow 16384:32768/udpLes pare-feu cloud et les groupes de sécurité des fournisseurs doivent également autoriser le trafic. Une règle au niveau de l'hôte ne peut pas contourner un pare-feu en amont qui bloque la connexion. Si seuls les utilisateurs d'un réseau restrictif rencontrent des difficultés de connexion, tandis que d'autres utilisateurs parviennent à se connecter, examinez leur chemin réseau ou leur configuration TURN plutôt que de redémarrer FreeSWITCH à répétition.
Un serveur derrière un NAT peut avoir un écouteur local correct et pourtant annoncer une adresse privée inaccessible aux navigateurs. Vérifiez que l'adresse IP externe, la redirection de ports et la configuration FreeSWITCH sont cohérentes. Le guide du pare-feu 4.0 de BigBlueButton utilise `<configuration>` /opt/freeswitch/conf/vars.xmlet /opt/freeswitch/conf/sip_profiles/external.xml`<configuration>` pour son exemple de NAT et renvoie à ` /etc/bigbluebutton/bbb-webrtc-sfu/production.yml<configuration>` pour les substitutions SFU pertinentes.
Ne copiez pas un exemple d'adresse IP et ne présumez pas que l'adresse IP publique doit être renseignée dans tous les champs. Dans une configuration NAT, l'adresse locale de FreeSWITCH peut différer de l'adresse publique qu'il annonce. Suivez les instructions spécifiques à votre version et à votre topologie réseau, puis vérifiez la configuration du pare-feu. Si l'adresse externe du serveur a récemment changé, vérifiez les paramètres DNS et toutes les adresses enregistrées dans la configuration de BigBlueButton.
Lorsqu'un processus serveur doit accéder à son propre nom d'hôte public, le NAT en boucle ou la résolution de nom d'hôte local peuvent également avoir une incidence. Le guide officiel du pare-feu explique comment associer le nom d'hôte public à l'adresse du pare-feu dans /etc/hostsce cas de figure. Testez cette solution uniquement si le problème persiste lors de la boucle locale via le nom d'hôte externe ; elle ne constitue pas une solution universelle aux délais d'attente d'enregistrement.
Si l'élément défaillant est une passerelle opérateur nommée plutôt que le chemin audio interne de BigBlueButton, examinez l'état de la passerelle séparément. FreeSWITCH documente sofia status gateway <name>l'état de la passerelle ainsi sofia statusque le profil chargé et son état. Vérifiez que le nom d'hôte du fournisseur est résolu par le serveur, que le nom d'utilisateur et le mot de passe SIP configurés correspondent, que le transport et le port choisis correspondent aux exigences du fournisseur et que les règles du pare-feu sortant autorisent le trafic de signalisation.
Ne réinitialisez pas les profils SIP intégrés à BigBlueButton pour réparer un compte opérateur. Évitez de partager publiquement l'intégralité des traces SIP : elles peuvent contenir des numéros de téléphone, des adresses IP, des noms de compte ou des informations d'authentification. Masquez les données sensibles avant de demander à un fournisseur ou à un administrateur de consulter les journaux.
Après avoir corrigé un problème confirmé de service, d'adresse ou de pare-feu, redémarrez BigBlueButton à l'aide de sa commande prise en charge :
sudo bbb-conf --restartN’utilisez cette méthode sudo bbb-conf --cleanque lorsque la documentation spécifique à la version ou les éléments de diagnostic le préconisent. Il ne s’agit pas d’une réponse générique à chaque expiration de délai SIP. De même, évitez de supprimer les fichiers de base de données FreeSWITCH, sauf si les symptômes de corruption de base de données documentés apparaissent ; conservez les journaux et les sauvegardes de configuration avant toute réparation entraînant la suppression de l’état.
Relancez le test sudo bbb-conf --checket vérifiez que FreeSWITCH et les autres services bbb-webrtc-sfufonctionnent correctement. Rejoignez une réunion test depuis un navigateur externe au réseau du serveur, activez le microphone ou le mode écoute seule, et vérifiez que la connexion s'établit. En cas de modification du NAT ou du pare-feu, effectuez un test depuis au moins un réseau ayant précédemment rencontré des problèmes. Un statut de service vert ne garantit pas à lui seul que les flux multimédias UDP puissent transiter sur le réseau.
Si le délai d'attente persiste, collectez la version de BigBlueButton, le texte complet de l'erreur, la bbb-conf --checksortie pertinente, l'état du service, les entrées récentes des journaux FreeSWITCH et SFU, ainsi que la topologie du réseau. Masquez les données sensibles et les données utilisateur publiques. Ces éléments permettent de distinguer un écouteur inactif, un délai d'attente ESL, une adresse annoncée erronée, une plage média bloquée et un véritable échec d'enregistrement de la passerelle SIP.
Documentation vérifiée le 6 octobre 2026. La documentation de BigBlueButton 4.0 indique que cette version est en développement ; veuillez vérifier les chemins d'accès et les commandes par rapport à la version installée sur votre serveur.
Comparez 10 outils de balayage ping pour une découverte rapide du réseau local, une analyse multiplateforme et la gestion des adresses IP. Découvrez ce qu'un balayage peut – et ne peut pas – vous révéler.
Comparez six outils de gestion de réseau pour la surveillance des performances, notamment la couverture SNMP, la cartographie, les alertes, les modèles de déploiement et les compromis en matière de coûts.
Comparez sept moniteurs de ping gratuits et open source, allant des suites réseau complètes aux sondes de latence ciblées, et choisissez celui qui convient le mieux à vos besoins en matière de disponibilité, de perte de paquets et d'historique.
Comparez les meilleurs analyseurs Wi-Fi pour Windows, iPhone et Android, incluant des outils pour la congestion des canaux, la couverture du signal, les cartes thermiques et le dépannage réseau.
Découvrez ce que signifie la QoS dans le domaine des réseaux, comment les marquages DSCP et les files d'attente de trafic priorisent la voix, la vidéo et les applications professionnelles, et ce que la QoS ne peut pas corriger.
Comparez les logiciels serveurs SFTP fiables pour Windows et Linux, notamment OpenSSH, Bitvise, SolarWinds et SFTPGo. Trouvez la solution idéale pour vos besoins en matière de sécurité et de transfert de fichiers.
Comparez sept outils de gestion d'adresses IP pour la découverte de sous-réseaux, la coordination DNS et DHCP, l'inventaire réseau et l'IPAM open source.
Mettez en place une surveillance réseau pratique avec une couverture claire des périphériques, des indicateurs de performance utiles, des alertes exploitables et une comparaison de SolarWinds NPM, PRTG et OpManager.
Comparez les outils d'analyse réseau pour la découverte rapide des périphériques, les analyses IP multiplateformes et la gestion des identités et des accès IP (IPAM) d'entreprise, avec des conseils pour adapter chaque option à votre réseau.
Utilisez l'option --traceroute de Nmap pour associer les sauts à un hôte autorisé, comprendre les résultats des sauts et du RTT, et résoudre les problèmes de réponses manquantes sans sur-analyse.
