Una reunión de BigBlueButton puede cargarse normalmente, pero los participantes se quedan atascados al intentar unirse al audio. Los administradores pueden ver mensajes como "Tiempo de espera agotado para el registro SIP", "FreeSWITCH no se registró" o un error de conexión de audio en un registro o herramienta de monitorización. Estos mensajes no siempre indican el mismo problema. En una implementación estándar de BigBlueButton, una conexión de audio fallida puede deberse a un proceso de FreeSWITCH detenido, una conexión SIP o Event Socket bloqueada, una dirección incorrecta detrás de NAT o un medio WebRTC bloqueado. Un tiempo de espera agotado para el registro de un operador o una puerta de enlace PBX es un caso aparte.
Comience por identificar qué componente está experimentando un tiempo de espera agotado. Luego, verifique el estado del servicio, los oyentes locales, las rutas de red y las direcciones, en ese orden. Evite modificar la configuración SIP o abrir puertos hasta que la evidencia identifique la ruta afectada.
Primero, identifique a qué se refiere "tiempo de espera de registro".
La pila de audio actual de BigBlueButton utiliza el bbb-webrtc-sfuservicio para coordinar los medios con FreeSWITCH. La documentación de BigBlueButton describe la conexión de la SFU con el servicio SIP y la capa de sockets de eventos (ESL) de FreeSWITCH. Esto difiere del registro de una puerta de enlace de salida de FreeSWITCH a un proveedor SIP externo.
- Problema de conexión de audio de BigBlueButton: los usuarios no pueden unirse al audio, FreeSWITCH no está disponible o la unidad SFU informa de un tiempo de espera agotado. Investigue FreeSWITCH, ESL, la dirección SIP y el puerto configurados, NAT y el transporte WebRTC.
- Problema de registro de puerta de enlace externa: FreeSWITCH informa que una puerta de enlace configurada está inactiva o no registrada. Investigue el nombre de host del proveedor, las credenciales, el transporte, la ruta del firewall y el estado de la cuenta del proveedor.
Si no está seguro de qué caso se aplica, guarde el texto completo del error y el nombre del servicio que lo registró. El simple mensaje "Tiempo de espera de registro agotado" no justifica el cambio de un perfil SIP.
1. Ejecuta la comprobación de configuración de BigBlueButton.
En el servidor, ejecute el diagnóstico recomendado por BigBlueButton:
sudo bbb-conf --check
Revisa toda la información de salida, especialmente la sección titulada Potential problems. Esta sección verifica si los procesos necesarios se están ejecutando e informa sobre problemas de configuración comunes. Una advertencia puede reflejar una personalización intencional, así que compárala con tu configuración en lugar de aplicar automáticamente todas las soluciones sugeridas.
Luego, verifique el estado del servicio:
sudo bbb-conf --status
sudo systemctl status freeswitch --no-pager
sudo systemctl status bbb-webrtc-sfu --no-pager
En versiones anteriores de BigBlueButton, los nombres de los servicios o la arquitectura de los componentes pueden variar. Confirme la versión instalada sudo bbb-conf --versiony consulte la documentación correspondiente. Las rutas y los ejemplos que se muestran a continuación se refieren principalmente a la documentación de BigBlueButton 4.0, que se encuentra en desarrollo.
2. Confirma que FreeSWITCH esté funcionando y aceptando conexiones locales.
Si freeswitch.serviceestá inactivo, ha fallado o se reinicia repetidamente, lea su registro antes de editar la configuración:
sudo journalctl -u freeswitch.service -b --no-pager -n 100
Busque fallos de enlace, errores de carga de módulos, problemas de permisos o errores de base de datos cerca del último inicio. La guía de solución de problemas de BigBlueButton documenta casos específicos en los que FreeSWITCH no puede enlazar con IPv4 ni con el puerto ESL 8021. También identifica una base de datos de FreeSWITCH dañada como posible causa tras un reinicio, pero recomienda limpiar la base de datos solo cuando se presenten los errores correspondientes.
Comprueba qué direcciones y puertos están a la escucha:
sudo ss -luntp | grep -E ':(5060|5066|8021)\b'
El oyente SIP exacto depende de la versión y configuración de BigBlueButton. Si falta algún oyente, FreeSWITCH no pudo iniciar ese perfil o se conectó a una dirección diferente. El puerto 8021 es la interfaz de control ESL local en una instalación típica; normalmente, debe permanecer restringido a localhost o a una red privada de confianza. No lo exponga a internet.
Si FreeSWITCH está activo, puede inspeccionar el estado del perfil SIP con su CLI. El comando estándar de FreeSWITCH es sofia status; utilice los nombres de perfil que muestra su servidor en lugar de asumir que todas las implementaciones usan los mismos. Un perfil marcado RUNNINGconfirma que el perfil se inició, pero no prueba que los navegadores remotos puedan acceder a la ruta de medios de audio.
3. Relacione el error con la ruta de red que está fallando.
La guía de firewall de BigBlueButton distingue entre un fallo de señalización WebSocket y un fallo ICE/de medios. Esta distinción reduce las posibilidades de búsqueda:
- Error WebRTC 1002: el navegador no pudo establecer la conexión WebSocket. Compruebe si FreeSWITCH está en funcionamiento, la configuración de la ruta SIP-over-WebSocket y del proxy inverso, y cualquier regla de firewall que afecte a esa ruta de señalización.
- Error WebRTC 1007: la conexión WebSocket se estableció, pero el navegador no pudo establecer la comunicación multimedia utilizando las direcciones IP candidatas devueltas. Compruebe la dirección IP anunciada y la accesibilidad UDP bidireccional.
Para la configuración predeterminada del firewall de BigBlueButton, la guía oficial enumera los puertos UDP 16384–32768para medios en tiempo real. Permita el rango requerido tanto en el grupo de seguridad de la nube o firewall perimetral como en el firewall del host. Limite la regla al servidor y al tráfico necesario; abrir puertos SIP no relacionados de forma generalizada no sustituye una configuración correcta de NAT y WebRTC.
Por ejemplo, si utiliza UFW y ha confirmado que este rango es apropiado para su instalación, inspeccione las reglas existentes y agregue el rango de medios:
sudo ufw status numbered
sudo ufw allow 16384:32768/udp
Los firewalls en la nube y los grupos de seguridad del proveedor también deben permitir el tráfico. Una regla a nivel de host no puede anular un firewall de nivel superior bloqueado. Si solo fallan los usuarios en una red restrictiva mientras que otros usuarios se conectan, investigue su ruta de red o la configuración de TURN en lugar de reiniciar FreeSWITCH repetidamente.
4. Compruebe la NAT y las direcciones IP anunciadas.
Un servidor detrás de NAT puede tener un listener local correcto y aun así anunciar una dirección privada inaccesible a los navegadores. Verifique que la dirección IP externa, el reenvío de puertos y la configuración de FreeSWITCH coincidan. La guía del firewall 4.0 de BigBlueButton utiliza /opt/freeswitch/conf/vars.xmly /opt/freeswitch/conf/sip_profiles/external.xmlpara su ejemplo de NAT, y remite a /etc/bigbluebutton/bbb-webrtc-sfu/production.ymlpara anulaciones SFU relevantes.
No copie una IP de ejemplo ni asuma que la IP pública debe aparecer en todos los campos. En una configuración NAT, la dirección que FreeSWITCH asigna localmente puede diferir de la dirección pública que anuncia. Aplique las instrucciones específicas de la versión para su topología de red y, a continuación, verifique el reenvío del firewall correspondiente. Si la dirección externa del servidor cambió recientemente, verifique el DNS y cualquier valor de dirección configurado en BigBlueButton.
Cuando un proceso de servidor debe acceder a su propio nombre de host público, la traducción de direcciones de red (NAT) en bucle o la resolución de nombres de host locales también pueden ser relevantes. La guía oficial del firewall explica cómo asignar el nombre de host público a la dirección del firewall en /etc/hostseste caso. Pruebe esto solo cuando el patrón de fallos indique un bucle de retorno a través del nombre de host externo; no es una solución universal para los tiempos de espera de registro.
5. Si el registro menciona una puerta de enlace SIP externa
Si el elemento que falla es una puerta de enlace de operador con nombre en lugar de la ruta de audio interna de BigBlueButton, inspeccione el estado de la puerta de enlace por separado. FreeSWITCH documenta sofia status gateway <name>el estado de la puerta de enlace y sofia statusel perfil cargado. Verifique que el nombre de host del proveedor se resuelva desde el servidor, que el nombre de usuario y la contraseña SIP configurados coincidan, que el transporte y el puerto elegidos cumplan con los requisitos del proveedor y que las reglas del firewall de salida permitan el tráfico de señalización.
No restablezca los perfiles SIP incluidos en BigBlueButton para reparar una cuenta de operador. Evite compartir públicamente registros SIP completos: pueden contener números de teléfono, direcciones IP, nombres de cuenta o detalles relacionados con la autenticación. Oculte los valores confidenciales antes de solicitar a un proveedor o administrador que revise los registros.
6. Aplique un cambio específico y reinicie una vez.
Después de corregir un problema confirmado de servicio, dirección o firewall, reinicie BigBlueButton usando el comando compatible:
sudo bbb-conf --restart
Úselo sudo bbb-conf --cleanúnicamente cuando la documentación específica de la versión o la evidencia de diagnóstico lo indiquen. No es una respuesta genérica para todos los tiempos de espera de SIP. Asimismo, evite eliminar los archivos de la base de datos de FreeSWITCH a menos que aparezcan los síntomas documentados de corrupción de la base de datos; conserve los registros y las copias de seguridad de la configuración antes de cualquier reparación que elimine el estado.
Verificar la reparación
Vuelva sudo bbb-conf --checka ejecutar la prueba y confirme que FreeSWITCH y el bbb-webrtc-sfuservidor funcionan correctamente. Únase a una reunión de prueba desde un navegador fuera de la red del servidor, seleccione el micrófono o el audio de solo escucha y confirme que la conexión se completa. Para cambios en NAT o firewall, realice la prueba desde al menos una red que haya fallado anteriormente. Un estado de servicio verde por sí solo no garantiza que los datos multimedia UDP puedan atravesar la red.
Si el tiempo de espera persiste, recopile la versión de BigBlueButton, el texto completo del error, la bbb-conf --checksalida relevante, el estado del servicio, las entradas recientes del registro de FreeSWITCH y SFU, y la topología de la red. Elimine la información confidencial y los datos públicos de los usuarios. Esta información ayuda a distinguir entre un receptor inactivo, un tiempo de espera de ESL, una dirección anunciada incorrecta, un rango de medios bloqueado y un fallo genuino en el registro de la puerta de enlace SIP.
Referencias oficiales
Documentación revisada el 6 de octubre de 2026. La documentación de BigBlueButton 4.0 indica que esta versión está en desarrollo; confirme las rutas y los comandos con la versión instalada en su servidor.