Mumble¶

En este artículo

• Mumble. Características principales
• Funcionalidades de implementación
• Primeros pasos después de implementar Mumble
• Configuración del cliente
• Conexión al servidor
• Gestión del servidor
• Seguridad y mantenimiento
• Tutorial en video
• Pedido de un servidor con Mumble usando la API

Mumble. Características principales¶

• Las aplicaciones cliente para esta plataforma están disponibles en Windows, Linux, macOS, iOS y Android, lo que la hace compatible con múltiples plataformas.
• Se utiliza el códec de audio Opus para garantizar baja latencia y alta calidad de sonido.
• El tráfico de voz está cifrado utilizando el protocolo TLS para mantener la confidencialidad de las conversaciones.
• El servidor puede manejar miles de usuarios simultáneos, lo que lo hace altamente escalable.
• Se admite audio espacial y voz direccional, proporcionando audio realista en juegos y realidad virtual.
• La arquitectura de complementos se puede utilizar para ampliar la funcionalidad de los componentes cliente y servidor.

Funcionalidades de implementación¶

• Software instalado:
  • Servidor Mumble.

Primeros pasos después de implementar Mumble¶

Se enviará una notificación al correo electrónico especificado durante el registro indicando que el servidor está listo para trabajar después de pagar el pedido. Contendrá la dirección IP del VPS, así como el nombre de usuario y la contraseña para la conexión. Los clientes de nuestra empresa gestionan el hardware en el servidor y el panel de control de API — Invapi.

• Login y Password para la conexión al servidor: enviados por correo electrónico a su dirección cuando el servidor esté listo después del despliegue del software.

Obtención de la contraseña de administrador¶

Paso 1: Conéctese al servidor mediante SSH:

ssh root@YOUR_IP_ADDRESS

Paso 2: Busque el ID del contenedor Docker para Mumble:

docker ps

La salida mostrará una línea similar a esta:

CONTAINER ID   IMAGE                  COMMAND        PORTS
a1f296c17976   ajmandourah/mumble    /start.sh    0.0.0.0:64738->64738/tcp,
                                                  0.0.0.0:64738->64738/udp

Recuerde el CONTAINER ID (primera columna): a1f296c17976

Paso 3: Entre en el contenedor y vea el registro:

docker exec -it <container_ID> /bin/bash


tail -100 /mumble/mumble-server.log | grep Password for 'SuperUser'

La salida mostrará algo como:

<W>2025-12-19 10:15:23.456 Password for 'SuperUser' set to 'aB3dE7gH9kL2'

¡Guarde esta contraseña!

docker exec -it <container_ID> murmurd -ini /etc/mumble-server.ini -supw NewPassword123

murmurd -ini /etc/mumble-server.ini -supw NewPassword123

Paso 4: Salga del contenedor y verifique que el servidor esté en ejecución:

exit


docker ps

Configuración del cliente¶

Para comenzar a usar el servicio, debe descargar el cliente Mumble en su dispositivo local e instalarlo.

En el primer lanzamiento, deberá completar la configuración inicial a través del asistente de configuración:

1. Entrada y salida de dispositivo: puede dejar las opciones predeterminadas y también seleccionar configuraciones adicionales (opcional):

   • Usar supresión de eco;
   • Habilitar audio posicional;
   • Atenuar aplicaciones mientras otros usuarios hablan.

2. Ajuste del dispositivo: establezca en el valor mínimo usando el control deslizante;

3. Ajuste de volumen: ajuste el nivel;

4. Detección de actividad de voz: establezca el umbral (en este paso también puede asignar un botón para activar la comunicación por voz);

5. Calidad y notificaciones: establezca preferencias;

6. Audio posicional: ajuste la configuración;

7. Usar certificado existente: se recomienda elegir Creación automática de certificado;

8. Haga clic en el botón Finish.

Cambio del idioma de la interfaz¶

La interfaz de Mumble está en inglés por defecto. Para cambiar la configuración del idioma:

1. Cierre la lista de servidores;
2. Navegue a: Configure > Settings > User Interface > Language;
3. Seleccione el idioma de la lista desplegable;
4. Haga clic en los botones Apply y OK:

La aplicación se reiniciará con el idioma de interfaz seleccionado.

Configuración de la salida de audio¶

Después de conectarse al servidor, se recomienda configurar el cliente Mumble. Todas las configuraciones están disponibles en el menú Configure > Settings en las versiones de escritorio o en la configuración de la aplicación en los clientes móviles.

Calidad de audio¶

Mumble utiliza el códec Opus con calidad de transmisión de audio objetivo ajustable.

Sección: Audio Input > Compression > Quality

• 40 kbit/s - valor estándar, suficiente para una comunicación por voz cómoda
• 64-96 kbit/s - alta calidad para música o audio profesional
• 32 kbit/s - ahorro de tráfico (internet móvil), posible reducción de calidad

Modos de transmisión de audio¶

Sección: Audio Input > Transmission

Por defecto, se utiliza el modo Voice Activity. En este modo, el micrófono se activa automáticamente cuando se detecta voz.

Ajuste de sensibilidad:

• Los controles deslizantes le permiten ajustar el umbral de activación;
• Evite transmitir ruido de fondo;
• Asegure el reconocimiento correcto de la voz.

Modos alternativos:

• Push-to-Talk - el micrófono se activa solo al presionar un botón (recomendado para entornos ruidosos);
• Continuous - el micrófono funciona constantemente (no recomendado).

Procesamiento de audio¶

Sección: Audio Input > Audio Processing

El cliente admite algoritmos de supresión de ruido:

• Speex - algoritmo clásico;
• RNNoise - más efectivo para suprimir ruido de fondo constante (ventilador, aire acondicionado, teclado).

Puede usar ambos algoritmos juntos para un efecto máximo.

Supresión de ruido:

• Ajuste el control deslizante de intensidad de supresión de ruido Speex;
• Habilite RNNoise para filtrado adicional;
• Combine ambos métodos para obtener los mejores resultados.

Cancelación de eco¶

Los parámetros de cancelación de eco deben seleccionarse dependiendo del equipo utilizado:

• Al trabajar con altavoces - modo de cancelación de eco más agresivo;
• Al usar auriculares - la cancelación de eco puede desactivarse.

Configuración de la entrada de audio¶

Buffering¶

Sección: Audio Output

Dos parámetros clave afectan la estabilidad de la reproducción:

1. Default Jitter Buffer

• Acumula audio entrante antes de la reproducción;
• Compensa la inestabilidad de la red;
• Predeterminado: 10 ms;
• Cuándo aumentar: si el habla tartamudea cuando las personas comienzan a hablar.

2. Output Delay

• Añade buffering antes de la salida de audio;
• Cuándo aumentar: si escucha tartamudeo rápido o artefactos en algunos controladores de audio.

Volumen y atenuación¶

• Ajuste el volumen con el control deslizante en el cliente o a través del mezclador del sistema;
• Atenuación - función útil que reduce automáticamente la música o los sonidos del juego cuando alguien está hablando.

Prueba de configuraciones¶

Use Loopback Test para la verificación:

• Modo local - prueba la entrada y salida de audio;
• Modo servidor - prueba la conexión de red.

Notificaciones y chat¶

Sección: Messages

En esta sección, puede configurar de manera flexible qué eventos se:

• Mostrarán en la ventana de mensajes;
• Acompañarán con una señal de sonido;
• Anunciarán usando Text-to-Speech.

Por defecto, las notificaciones principales están habilitadas:

• Conexión y desconexión de usuarios;
• Mensajes críticos y advertencias.

Conexión al servidor¶

Para conectarse al servidor Mumble, use las siguientes credenciales:

• Login - SuperUser;
• Password - contraseña generada automáticamente (obtenida de los registros).

Proceso de conexión¶

Paso 1: Inicie el cliente Mumble y haga clic en el botón Add New...

Paso 2: Complete el formulario de conexión:

• Label: cualquier nombre para su servidor;
• Address: la dirección IP de su VPS;
• Port: 64738 (predeterminado, si no se ha cambiado);
• Username: SuperUser;
• Password: contraseña de los registros del servidor.

Paso 3: Haga clic en OK, seleccione el servidor de la lista y haga clic en Connect.

Paso 4: En la primera conexión, el cliente mostrará una advertencia sobre un certificado SSL autofirmado: esto es normal para un servidor nuevo, haga clic en Yes.

Después de conectarse, estará en el canal raíz con el nombre SuperUser y el icono de administrador.

Conexión de usuarios regulares¶

Para conectarse al servidor, los usuarios regulares necesitan:

1. Agregar un nuevo servidor en el cliente Mumble;
2. Especificar la dirección IP del servidor;
3. Especificar el puerto 64738;
4. Elegir un nombre de usuario;
5. No se requiere contraseña para usuarios regulares.

Gestión del servidor¶

Creación de estructura de canales¶

Por defecto, solo hay el canal raíz. Para mayor comodidad, creemos varios subcanales.

Creación de un canal:

1. Haga clic derecho en el canal raíz;
2. Add;
3. Ingrese el nombre del canal.

Estructura de ejemplo:

Root (Canal raíz)
├── General Room
├── Games
│   ├── Counter-Strike
│   └── Dota 2
├── Work
│   ├── Meetings
│   └── Communication
└── AFK (para ausentes)

Derechos de acceso al canal¶

Los derechos de acceso se configuran a través del menú contextual del canal:

1. Haga clic derecho en el canal > Edit;
2. Pestaña ACL:

Qué se puede configurar:

• Establecer una contraseña para el canal;
• Restringir el acceso a grupos de usuarios específicos;
• Permitir/prohibir hablar en el canal;
• Configurar derechos para crear subcanales.

Gestión de usuarios¶

Registro de usuario¶

Cómo se registra un usuario:

1. Se conecta al servidor con cualquier nombre;
2. Haga clic derecho en su nombre > Register;
3. El servidor recuerda el certificado del usuario.

Después del registro:

• El usuario se conecta automáticamente en el siguiente inicio de sesión;
• El nombre de usuario está reservado;
• Se pueden asignar derechos de acceso.

Creación manual de cuentas¶

El administrador puede crear cuentas manualmente:

1. Menú Server > Registered Users > Add;
2. Ingrese el nombre de usuario.

Seguridad y mantenimiento¶

Cambio de puerto¶

El puerto estándar 64738 es fácilmente encontrado por escáneres. Si desea dificultar el descubrimiento del servidor, puede cambiar el puerto a cualquier otro.

Paso 1: Copie la configuración al host:

docker cp <container_ID>:/etc/mumble-server.ini ./mumble-server.ini

Paso 2: Edite la configuración:

nano mumble-server.ini

Busque la línea port=64738 y cámbiela al puerto deseado, por ejemplo:

port=25000

Paso 3: Copie de vuelta:

docker cp ./mumble-server.ini <container_ID>:/etc/mumble-server.ini

Paso 4: Reinicie el servidor:

docker restart <container_ID>

Paso 5: Ahora los usuarios deben especificar el nuevo puerto al conectarse:

IP:new_port

Copia de seguridad¶

La copia de seguridad es importante si está usando Mumble no solo para comunicación familiar.

La base de datos de Mumble con configuraciones de usuario y canal se encuentra en /mumble/mumble-server.sqlite dentro del contenedor.

Copia de seguridad manual¶

Copie periódicamente la base de datos para usted:

docker cp <container_ID>:/mumble/mumble-server.sqlite ./mumble-backup-$(date +%Y%m%d).sqlite

Este comando creará un archivo con la fecha actual, por ejemplo: mumble-backup-20250112.sqlite

Restauración desde copia de seguridad¶

Si el servidor falla, puede implementar un nuevo contenedor y restaurar todas las configuraciones:

docker cp ./mumble-backup-DATE.sqlite <new_container_ID>:/mumble/mumble-server.sqlite

docker restart <new_container_ID>

Tutorial en video¶

Pedido de un servidor con Mumble usando la API¶

Para instalar este software usando la API, siga estas instrucciones.

Algunos de los contenidos de esta página fueron creados o traducidos usando IA.