Solución de problemas¶
Problemas habituales y qué los causa. Todo lo de abajo está extraído de las propias notas y recomendaciones del plugin.
Las sesiones se cortan a los 5 minutos¶
Síntoma: las conferencias terminan de forma abrupta tras unos cinco minutos.
Causa: el plugin se conecta por defecto al servidor público meet.jit.si, que
restringe el modo embebido a 5 minutos por conferencia.
Solución: meet.jit.si solo es adecuado para pruebas rápidas. Para producción usa una de las
opciones de servidor reales — un servidor autogestionado de GCP, una
cuenta de JaaS (8x8) (gratuita hasta 25 usuarios activos mensuales), o un
servidor Jitsi autoalojado.
Todos entran como moderador (JWT autoalojado)¶
Síntoma: en un servidor autoalojado, todos los usuarios pueden silenciar o expulsar a otros — el rol de Moodle se ignora.
Causa: el campo moderator del token JWT se está ignorando porque falta el
plugin de Prosody necesario.
Solución: instala el jitsi-token-moderation-plugin en tu servidor Jitsi autoalojado (tipo 1). No es necesario en servidores 8x8 JaaS ni en los autogestionados de GCP. Consulta JWT / modo token.
Las restricciones de moderación se pueden evitar (sin modo token)¶
Síntoma: los usuarios experimentados sortean silenciar a todos / expulsar participante aunque esos botones estén ocultos para ellos.
Causa: sin la configuración de token, la moderación solo se oculta en la interfaz, no se aplica en el servidor.
Solución: despliega un servidor en modo basado en token para que solo los usuarios con la capacidad
mod/jitsi:moderation sean moderadores reales. Consulta JWT / modo token.
Faltan las funciones de informes y analítica¶
Síntoma: el informe de asistencia, el seguimiento de visualización de grabaciones, el mapa de calor de visualización, la vista general del curso o las estadísticas de uso de sesiones no aparecen.
Causa: estas funciones requieren una cuenta de mod_jitsi registrada.
Solución: registra tu instalación desde Administración del sitio → Plugins → Módulos de actividad → Jitsi (la sección Cuenta de mod_jitsi de la parte superior). El registro es gratuito.
Los datos de asistencia a sesiones en directo están vacíos
Para la pestaña de sesiones en directo, la tarea programada aggregate_usage_stats debe haberse
ejecutado al menos una vez — los datos se precalculan cada noche. Las sesiones nuevas no mostrarán
los tiempos exactos de conexión hasta que se ejecute esa tarea de cron.
Los enlaces de grabación de JaaS (8x8) dejan de funcionar¶
Síntoma: el botón Descargar de una grabación en la nube de JaaS deja de funcionar.
Causa: los enlaces de grabación en la nube de JaaS (8x8) están alojados en la CDN de 8x8 y caducan tras 24 horas (o según tu plan de JaaS).
Solución: esto es lo esperado. Una vez caducados, los enlaces se ocultan automáticamente de la pestaña Grabaciones — no hace falta ninguna limpieza manual.
El enlace de grabación de Dropbox no aparece automáticamente¶
Síntoma: después de detener una grabación de Dropbox, no aparece ningún enlace en la pestaña Grabaciones.
Causa: Jitsi dispara recordingStatusChanged cuando la grabación se detiene, pero la URL de
Dropbox la genera Dropbox de forma asíncrona después de que la subida se complete, por lo que no se
incluye en el evento. Por tanto, los enlaces de Dropbox no se pueden capturar automáticamente.
Solución: el profesor debe publicar el enlace manualmente — obtén el enlace de compartir desde Dropbox y pégalo en el formulario Añadir enlace de grabación de la pestaña Grabaciones de la actividad.
El vídeo de Dropbox embebido deja de reproducirse para algunos estudiantes¶
Síntoma: una grabación de Dropbox embebida deja de estar disponible cuando muchos estudiantes la ven a la vez.
Causa: Dropbox impone un límite mensual de ancho de banda en las cuentas gratuitas, y puede bloquear temporalmente el acceso directo cuando muchos estudiantes ven el vídeo embebido simultáneamente.
Solución: esto es una limitación de Dropbox. Siempre se muestra un enlace alternativo Abrir grabación debajo del reproductor embebido.
La autorización de YouTube caduca continuamente¶
Síntoma: la grabación/emisión corporativa de YouTube deja de funcionar y pide reautorización cada pocos días.
Causa: cuando la aplicación de Google OAuth está en estado "Testing", solo las cuentas añadidas explícitamente pueden autorizarla y los tokens caducan cada 7 días.
Solución: o bien publica la aplicación de OAuth, o — si tu institución usa Google Workspace — configura el "User type" de la pantalla de consentimiento de OAuth como INTERNAL, donde los tokens nunca caducan.
Nunca elimines las credenciales de OAuth
Eliminar las credenciales de OAuth en Google Cloud borrará todas las grabaciones de las cuentas de YouTube asociadas.
El navegador muestra avisos de SSL en un servidor autogestionado de GCP¶
Síntoma: los usuarios ven avisos de certificado al entrar en un servidor de GCP recién creado.
Causa: si el DNS aún no se había propagado cuando la VM terminó de instalarse, el script de arranque recurre a un certificado autofirmado en lugar de uno de Let's Encrypt. Sin un DNS correcto, la autenticación JWT también puede comportarse de forma anómala.
Solución: crea los registros A necesarios en cuanto se muestre la IP estática — tanto
your-hostname como auth.your-hostname apuntando a la misma IP — para que Let's Encrypt pueda
emitir un certificado válido. Consulta configuración de GCP.