Solucionar los tiempos de espera de registro SIP de BigBlueButton FreeSWITCH: una guía práctica de diagnóstico

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.

Dejar un comentario

Cómo restringir las fechas de vencimiento de los enlaces públicos en ownCloud Server

Cómo restringir las fechas de vencimiento de los enlaces públicos en ownCloud Server

Establezca una fecha de vencimiento máxima para los enlaces públicos de ownCloud Server, comprenda a qué recursos compartidos afecta y verifique la política sin pasar por alto los enlaces más antiguos.

Cómo configurar la sincronización automática de la GAL de Zimbra y verificar que funcione.

Cómo configurar la sincronización automática de la GAL de Zimbra y verificar que funcione.

Configure la sincronización automática de la lista global de direcciones (GAL) de Zimbra, establezca el intervalo de sondeo, fuerce una sincronización de prueba, verifique las marcas de tiempo y solucione problemas con contactos LDAP internos o externos obsoletos.

Cómo configurar la autenticación LDAP en ownCloud Infinite Scale

Cómo configurar la autenticación LDAP en ownCloud Infinite Scale

Configure el inicio de sesión basado en LDAP para ownCloud Infinite Scale, asigne usuarios y grupos, elija OIDC integrado o externo, proteja las credenciales y verifique la autenticación de forma segura.

Cómo migrar de ownCloud 10 Classic a ownCloud Infinite Scale

Cómo migrar de ownCloud 10 Classic a ownCloud Infinite Scale

Planifica una migración de ownCloud Classic 10 a Infinite Scale con la aplicación compatible migrate-to-ocis. Descubre qué se transfiere, qué no, los requisitos previos de LDAP, los comandos y las comprobaciones de transición.

Cómo configurar reglas personalizadas de SpamAssassin en Zimbra (de forma segura)

Cómo configurar reglas personalizadas de SpamAssassin en Zimbra (de forma segura)

Aprende dónde carga Zimbra las reglas personalizadas de SpamAssassin, cómo escribir y validar una regla .cf, reiniciar Amavis, probar los encabezados de los mensajes y revertir los cambios de forma segura.

Cómo realizar copias de seguridad y restaurar buzones individuales en Zimbra CE

Cómo realizar copias de seguridad y restaurar buzones individuales en Zimbra CE

Realice copias de seguridad y restaure un buzón de correo individual de Zimbra CE con zmmailbox. Exporte un archivo ZIP con metadatos, verifíquelo y pruebe la recuperación de forma segura en una cuenta de prueba.

Cómo configurar las cuotas de almacenamiento para usuarios en ownCloud oCIS

Cómo configurar las cuotas de almacenamiento para usuarios en ownCloud oCIS

Aprende a establecer una cuota de espacio personal para un usuario de ownCloud Infinite Scale, a distinguirla de los límites globales y del espacio de proyecto, y a asignar valores predeterminados a los nuevos usuarios según su rol.

Solucionar los tiempos de espera de registro SIP de BigBlueButton FreeSWITCH: una guía práctica de diagnóstico

Solucionar los tiempos de espera de registro SIP de BigBlueButton FreeSWITCH: una guía práctica de diagnóstico

Diagnostique los tiempos de espera de registro SIP de BigBlueButton FreeSWITCH comprobando el estado del servicio, los oyentes SIP y ESL, las direcciones NAT, las reglas del firewall y los registros.

Cómo solucionar el error "Conexión rechazada" de la aplicación móvil de ownCloud

Cómo solucionar el error "Conexión rechazada" de la aplicación móvil de ownCloud

Solucione los errores de conexión rechazada de la aplicación móvil ownCloud comprobando la URL del servidor, el puerto HTTPS, el servidor web, el cortafuegos, el proxy, el TLS y los dominios de confianza.

Cómo restringir el registro de usuarios en un servidor Matrix autohospedado.

Cómo restringir el registro de usuarios en un servidor Matrix autohospedado.

Compara las diferentes formas de controlar las nuevas cuentas de Matrix en Synapse, desde deshabilitar el registro público hasta emitir tokens de uso limitado, con ejemplos de configuración y comprobaciones.