Despliegue de Jitsi Meet

Configuración

La instalación básica de Jitsi Meet ya es funcional, pero se requieren configuraciones adicionales para la optimización, seguridad e integración del servidor TURN. Revisaremos los archivos de configuración principales.

1. Configuración principal de Jitsi Meet (config.js)

Este archivo define el comportamiento de la parte cliente de Jitsi Meet. Se encuentra en la ruta /etc/jitsi/meet/yourdomain.com-config.js. Ábralo para editar:

sudo nano /etc/jitsi/meet/meet.yourdomain.com-config.js

Busque la sección // BOSH URL y asegúrese de que apunte a su dominio:

var config = {
    // ... otros parámetros
    bosh: 'https://meet.yourdomain.com/http-bind',
    // ...
};

Desplácese hacia abajo hasta la sección // STUN and TURN server configuration. Aquí añadiremos la configuración de nuestro servidor Coturn. Reemplace YOUR_PUBLIC_IP con la dirección IP pública de su VPS, y YOUR_JITSI_SHARED_SECRET con el secreto que utilizó en turnserver.conf.

var config = {
    // ...
    // Configuración del servidor STUN y TURN
    // Use su propio servidor TURN para mayor fiabilidad
    p2p: {
        enabled: true,
        preferH264: true,
        disableH264: true,
        useStunTurn: true, // Set to true to use STUN/TURN for P2P connections
        stunServers: [
            { urls: 'stun:meet.yourdomain.com:3478' } // Su dominio Jitsi
        ],
        turnServers: [
            { urls: 'turn:meet.yourdomain.com:3478', secret: 'YOUR_JITSI_SHARED_SECRET', username: 'jitsi' },
            { urls: 'turns:meet.yourdomain.com:5349', secret: 'YOUR_JITSI_SHARED_SECRET', username: 'jitsi' }
        ]
    },
    // ...
};

Importante: Asegúrese de que stun:meet.yourdomain.com:3478 y turn:meet.yourdomain.com:3478/turns:meet.yourdomain.com:5349 utilicen su nombre de dominio, no la dirección IP, para evitar problemas con SSL y DNS. El parámetro username: 'jitsi', en combinación con secret y static-auth-secret en Coturn, permite a Jitsi generar dinámicamente credenciales temporales para el servidor TURN.

Configuraciones útiles adicionales:

• enableWelcomePage: false - deshabilita la página de bienvenida estándar de Jitsi si desea redirigir a los usuarios directamente a una conferencia.
• defaultLanguage: 'ru' - establece el idioma ruso por defecto.

Guarde los cambios en el archivo config.js.

2. Configuración de Jicofo (sip-communicator.properties)

Jicofo gestiona la lógica de las conferencias. Su configuración se encuentra en el archivo /etc/jitsi/jicofo/sip-communicator.properties. Ábralo:

sudo nano /etc/jitsi/jicofo/sip-communicator.properties

Asegúrese de que las siguientes líneas estén presentes y configuradas correctamente (reemplace meet.yourdomain.com con su dominio):

# Jicofo usará el servidor XMPP en meet.yourdomain.com
org.jitsi.jicofo.xmpp.SERVER_HOSTNAME=meet.yourdomain.com

# Para autenticación con Coturn, si no se usa static-auth-secret
# org.jitsi.jicofo.TURN_HOST=meet.yourdomain.com
# org.jitsi.jicofo.TURN_PORT=3478
# org.jitsi.jicofo.TURN_USER=jitsi
# org.jitsi.jicofo.TURN_PASSWORD=JitsiStrongPassword123

# Si se usa secreto compartido (recomendado)
org.jitsi.jicofo.TURN_SHARED_SECRET=YOUR_JITSI_SHARED_SECRET

Si utiliza static-auth-secret en Coturn (como recomendamos), basta con especificar org.jitsi.jicofo.TURN_SHARED_SECRET. Si utilizó un usuario/contraseña estáticos en Coturn, deberá descomentar y configurar las líneas correspondientes TURN_HOST, TURN_PORT, TURN_USER, TURN_PASSWORD. Guarde los cambios.

3. Configuración de Prosody (servidor XMPP)

Prosody es utilizado por Jitsi para la señalización. Sus archivos de configuración principales se encuentran en /etc/prosody/conf.d/. El archivo meet.yourdomain.com.cfg.lua contiene la configuración para su dominio. Normalmente, después de instalar Jitsi y ejecutar el script de Let's Encrypt, este archivo ya está configurado correctamente.

sudo nano /etc/prosody/conf.d/meet.yourdomain.com.cfg.lua

Asegúrese de que las secciones VirtualHost y Component "conference.meet.yourdomain.com" estén configuradas para su dominio, y que las rutas a los certificados SSL sean correctas (deben apuntar a los certificados de Let's Encrypt en /etc/letsencrypt/live/meet.yourdomain.com/).

4. Reinicio de servicios

Después de realizar todos los cambios en los archivos de configuración, es necesario reiniciar los servicios correspondientes de Jitsi Meet para que los cambios surtan efecto:

sudo systemctl restart jitsi-videobridge2
sudo systemctl restart jicofo
sudo systemctl restart prosody
sudo systemctl restart nginx # O apache2, si lo está usando

Tampoco olvide reiniciar Coturn si realizó cambios en su configuración:

sudo systemctl restart coturn

5. Verificación de la operatividad

Después de reiniciar todos los servicios, realice las siguientes comprobaciones:

• Disponibilidad de la interfaz web: Abra https://meet.yourdomain.com en el navegador. Asegúrese de que la conexión esté protegida (candado verde).
• Prueba del servidor TURN: Utilice herramientas en línea, como Trickle ICE, para verificar la disponibilidad de su servidor TURN. Introduzca la URL de su servidor TURN (por ejemplo, turn:meet.yourdomain.com:3478) y las credenciales (username: jitsi, password: YOUR_JITSI_SHARED_SECRET - temporalmente, para la prueba, si usa credenciales estáticas, de lo contrario este método no funcionará directamente). La mejor manera es simplemente intentar conectarse a una conferencia desde una red compleja (por ejemplo, a través de una VPN o desde una red corporativa).
• Verificación de registros:

  
  sudo journalctl -u jitsi-videobridge2 -f
  sudo journalctl -u jicofo -f
  sudo journalctl -u coturn -f
  

  Busque errores o advertencias. Las conexiones exitosas a Coturn serán visibles en los registros.

• Prueba de conferencia: Invite a varias personas a unirse a una conferencia desde diferentes redes. Asegúrese de que el video y el audio funcionen de manera estable, así como la función de compartir pantalla.

Si todas las comprobaciones han sido exitosas, su Jitsi Meet con SSL y servidor TURN está completamente listo para usar.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno del servidor Jitsi Meet son clave para su funcionamiento estable y seguro. No descuide estos pasos para evitar la pérdida de datos y los tiempos de inactividad.

1. Qué respaldar

Para Jitsi Meet, los componentes principales que requieren copia de seguridad son:

• Archivos de configuración de Jitsi Meet:
  • /etc/jitsi/meet/ (configuraciones principales de la interfaz web)
  • /etc/jitsi/jicofo/ (configuraciones de Jicofo)
  • /etc/jitsi/videobridge/ (configuraciones de Videobridge)
• Archivos de configuración de Prosody:
  • /etc/prosody/ (configuraciones principales de Prosody)
  • /var/lib/prosody/ (datos de Prosody, incluida la información del usuario si utiliza la autenticación de Prosody)
• Archivos de configuración de Coturn:
  • /etc/coturn/turnserver.conf
• Certificados SSL:
  • /etc/letsencrypt/ (aunque se renuevan automáticamente, tener una copia de seguridad es útil)
• Grabaciones de conferencias (si se usa Jibri):
  • Normalmente se encuentran en /var/lib/jitsi/jibri/recordings/ o en el directorio que haya configurado. Esto puede ser un gran volumen de datos.

2. Script simple de copia de seguridad automática

Puede crear un script simple que archivará los archivos clave y los enviará a una ubicación segura. Por ejemplo, a un almacenamiento remoto compatible con S3 o a otro VPS.

Cree el archivo /usr/local/bin/jitsi_backup.sh:

sudo nano /usr/local/bin/jitsi_backup.sh

Contenido del script (reemplace YOUR_BACKUP_DIR con la ruta al directorio donde se almacenarán las copias de seguridad, por ejemplo, /mnt/backups, y S3_BUCKET con su bucket S3 si usa AWS CLI):

#!/bin/bash

# Directorio para el almacenamiento temporal de copias de seguridad
BACKUP_TEMP_DIR="/tmp/jitsi_backup_$(date +%Y%m%d%H%M%S)"
CONFIG_DIR="/etc/jitsi"
PROSODY_DIR="/etc/prosody"
PROSODY_DATA_DIR="/var/lib/prosody"
COTURN_DIR="/etc/coturn"
LETSENCRYPT_DIR="/etc/letsencrypt"
RECORDINGS_DIR="/var/lib/jitsi/jibri/recordings" # Si usa Jibri

# Creamos el directorio temporal
mkdir -p "$BACKUP_TEMP_DIR"

# Copiamos los archivos de configuración
cp -R "$CONFIG_DIR" "$BACKUP_TEMP_DIR/"
cp -R "$PROSODY_DIR" "$BACKUP_TEMP_DIR/"
cp -R "$PROSODY_DATA_DIR" "$BACKUP_TEMP_DIR/"
cp -R "$COTURN_DIR" "$BACKUP_TEMP_DIR/"
cp -R "$LETSENCRYPT_DIR" "$BACKUP_TEMP_DIR/"

# Si hay grabaciones de Jibri, las copiamos (cuidado, puede ser un gran volumen)
# cp -R "$RECORDINGS_DIR" "$BACKUP_TEMP_DIR/"

# Creamos el archivo
BACKUP_FILE="$BACKUP_TEMP_DIR/jitsi_config_$(date +%Y%m%d%H%M%S).tar.gz"
tar -czvf "$BACKUP_FILE" -C "$BACKUP_TEMP_DIR" .

# Dónde almacenar las copias de seguridad (ejemplos)
# 1. Localmente (en un disco separado o en otro directorio)
# mv "$BACKUP_FILE" /mnt/backups/

# 2. En un almacenamiento remoto compatible con S3 (requiere AWS CLI)
# /usr/local/bin/aws s3 cp "$BACKUP_FILE" s3://YOUR_S3_BUCKET/jitsi/

# 3. En otro VPS mediante SCP/SFTP (requiere configurar claves SSH sin contraseña)
# scp "$BACKUP_FILE" user@remote_vps:/path/to/remote/backups/

# Eliminamos el directorio temporal
rm -rf "$BACKUP_TEMP_DIR"

echo "Backup completed: $(basename "$BACKUP_FILE")"

Haga el script ejecutable:

sudo chmod +x /usr/local/bin/jitsi_backup.sh

3. Automatización de copias de seguridad con Cron

Agregue el script a Cron para su ejecución diaria. Abra crontab:

sudo crontab -e

Agregue la siguiente línea para ejecutar el script diariamente a las 3:00 de la mañana:

0 3 * * * /usr/local/bin/jitsi_backup.sh >> /var/log/jitsi_backup.log 2>&1

Esto ejecutará el script y registrará su salida en el archivo de registro /var/log/jitsi_backup.log.

4. Dónde almacenar las copias de seguridad

Importante: Nunca almacene las copias de seguridad en el mismo servidor que está respaldando. En caso de fallo del disco o compromiso del servidor, perderá tanto los datos como sus copias.

• Almacenamiento externo compatible con S3: Una opción fiable y escalable. Utilice AWS S3, DigitalOcean Spaces, Backblaze B2 o similares.
• VPS separado: Alquile un VPS pequeño exclusivamente para almacenar copias de seguridad. Configure SCP/SFTP o Rclone.
• Compartición NFS/SMB: Si tiene un sistema de archivos de red local.

5. Actualizaciones: rolling vs maintenance window

La actualización regular del sistema y de Jitsi Meet es crítica para la seguridad y para obtener nuevas funciones. Utilice la siguiente estrategia:

• Actualización del SO y paquetes base:

  Ejecute sudo apt update && sudo apt upgrade -y regularmente (por ejemplo, una vez a la semana). Esto se puede automatizar con unattended-upgrades, pero para servidores clave se recomienda el control manual con revisión de logs.

• Actualización de Jitsi Meet:

  Las nuevas versiones de Jitsi Meet se lanzan con bastante frecuencia. La actualización del paquete jitsi-meet a través de sudo apt upgrade jitsi-meet -y suele ser fluida, pero puede requerir intervención manual para resolver conflictos de archivos de configuración (por ejemplo, si los ha modificado mucho). Siempre haga una copia de seguridad antes de actualizar Jitsi.

  Estrategia:

  • Ventana de mantenimiento: Para sistemas de producción, planifique las actualizaciones fuera del horario laboral. Notifique a los usuarios sobre posibles tiempos de inactividad breves.
  • Entorno de prueba: Si es posible, implemente primero las actualizaciones en un servidor de prueba antes de aplicarlas en el principal.
• Verificación después de la actualización: Después de cada actualización, verifique el funcionamiento de Jitsi Meet, los certificados SSL y el servidor TURN, como se describe en la sección "Configuración".

Siguiendo estas recomendaciones, asegurará el funcionamiento fiable y seguro de su servidor Jitsi Meet durante muchos años.

Solución de problemas + Preguntas frecuentes

En esta sección, abordaremos los problemas típicos que pueden surgir al implementar Jitsi Meet y daremos respuestas a las preguntas frecuentes.

No puedo conectarme a la conferencia, veo "Connecting..." o "Failed to connect"

Este es uno de los problemas más comunes. Primero, verifique el funcionamiento de su firewall (UFW) en el VPS. Asegúrese de que los siguientes puertos estén abiertos: 80 (TCP), 443 (TCP), 10000 (UDP), 3478 (UDP), 5349 (TCP). Verifique el estado de UFW con el comando sudo ufw status verbose. También asegúrese de que su dominio se resuelva correctamente a la dirección IP del servidor (dig meet.yourdomain.com A). Si el problema persiste, revise los logs de Jitsi Videobridge (sudo journalctl -u jitsi-videobridge2 -f) y Jicofo (sudo journalctl -u jicofo -f) en busca de errores.

Certificado SSL no válido o falta HTTPS

Verifique que su dominio esté configurado correctamente en DNS y apunte a la dirección IP de su VPS. Asegúrese de que el puerto 80 esté abierto en el firewall para la verificación HTTP-01 de Let's Encrypt. Ejecute el script de instalación del certificado nuevamente: sudo /usr/share/jitsi-meet/scripts/install-letsencrypt-cert.sh. Si arroja un error, revise los logs de Certbot (normalmente en /var/log/letsencrypt/). También asegúrese de que Nginx o Apache (si los usa como proxy) estén configurados correctamente para trabajar con SSL y proxy el tráfico a Jitsi.

Problemas de audio o video para algunos participantes (por ejemplo, "pantalla negra")

Esto a menudo indica problemas con el servidor TURN. Asegúrese de que Coturn esté en ejecución (sudo systemctl status coturn) y de que sus puertos (3478 UDP, 5349 TCP) estén abiertos en el firewall. Verifique la configuración de Coturn en /etc/coturn/turnserver.conf, especialmente external-ip y realm, así como static-auth-secret. Compare el secreto con el especificado en /etc/jitsi/meet/meet.yourdomain.com-config.js y /etc/jitsi/jicofo/sip-communicator.properties. Revise los logs de Coturn (sudo journalctl -u coturn -f) en busca de errores o mensajes de retransmisión.

Jitsi Meet funciona lento o se congela con muchos participantes

Lo más probable es que su VPS esté experimentando una escasez de recursos. Verifique la carga de CPU y RAM con los comandos htop o top. Jitsi Videobridge puede consumir mucha CPU con un gran número de transmisiones de video activas. Considere actualizar su VPS a un plan más potente con más núcleos de CPU y memoria RAM. También asegúrese de que su VPS tenga suficiente ancho de banda de red.

¿Cómo restringir el acceso a Jitsi Meet solo a usuarios autorizados?

Por defecto, Jitsi Meet permite a cualquiera crear una conferencia. Para restringir el acceso, puede configurar la autenticación. Jitsi admite varios métodos, incluida la autenticación de Prosody (XMPP). En el archivo /etc/prosody/conf.d/meet.yourdomain.com.cfg.lua, cambie authentication = "anonymous" a authentication = "internal_plain". Luego, cree usuarios de Prosody con el comando sudo prosodyctl register username meet.yourdomain.com password. Después de esto, los usuarios verán una solicitud para ingresar un nombre de usuario y contraseña al intentar crear o unirse a una conferencia.

¿Qué configuración mínima de VPS es adecuada?

Para un equipo pequeño de hasta 10-15 participantes simultáneos, un VPS con 2 vCPU, 4 GB de RAM, 50 GB de SSD y un canal de red de 200 Mbps o más será mínimamente adecuado. Es importante que estos sean recursos estables, no CPU "burst" o "compartida". Para garantizar un funcionamiento cómodo en la mayoría de los escenarios, es mejor apuntar a 4 vCPU, 8 GB de RAM y un canal de 1 Gbps.

¿Qué elegir: VPS o dedicado para esta tarea?

La elección entre un VPS y un servidor dedicado depende de la escala de uso. Para la mayoría de los equipos pequeños y medianos (hasta 30-40 usuarios simultáneos), un VPS bien configurado es suficiente. Un VPS ofrece flexibilidad, facilidad de gestión y rentabilidad. Un servidor dedicado se vuelve necesario si planea atender a 50 o más participantes simultáneos, ejecutar muchas grabaciones de conferencias en segundo plano (Jibri), o si requiere el máximo rendimiento garantizado sin la influencia de "vecinos" en el servidor. Un servidor dedicado proporciona acceso exclusivo a todos los recursos físicos, lo cual es crítico para cargas muy altas.

Conclusiones y próximos pasos

¡Felicidades! Ha implementado y configurado con éxito su propio servidor Jitsi Meet en un VPS, asegurando su funcionamiento seguro a través de HTTPS con certificados SSL y una conexión fiable a través de un servidor TURN. Ahora tiene una plataforma de videoconferencias totalmente controlada y privada, lista para ser utilizada por su equipo o comunidad.

Para aprovechar al máximo el potencial de su plataforma y asegurar su estabilidad a largo plazo, considere los siguientes pasos:

• Configuración de autenticación: Para controlar el acceso a las conferencias, configure la autenticación de usuarios, utilizando las capacidades integradas de Prosody o integrándose con proveedores externos (LDAP, JWT).
• Monitoreo de recursos: Instale herramientas de monitoreo (por ejemplo, Prometheus + Grafana, Netdata) para rastrear la carga de CPU, RAM, tráfico de red y el estado de los servicios de Jitsi. Esto ayudará a identificar y resolver problemas de manera oportuna.
• Implementación de Jibri para grabación: Si necesita la función de grabación de conferencias, considere la instalación y configuración de Jibri (Jitsi Broadcasting and Recording Infrastructure). Este es un componente separado que requiere recursos y configuraciones adicionales.
• Optimización del rendimiento: Revise la documentación de Jitsi para ajustar el rendimiento, por ejemplo, cambiando la calidad de video predeterminada, limitando el bitrate o utilizando códecs VP9/AV1.

Recuerde que las actualizaciones regulares y las copias de seguridad son clave para mantener la seguridad y estabilidad de su plataforma Jitsi Meet.