Mumble¶

Dans cet article

• Mumble. Fonctionnalités clés
• Fonctionnalités de déploiement
• Premiers pas après le déploiement de Mumble
• Configuration du client
• Connexion au serveur
• Gestion du serveur
• Sécurité et maintenance
• Tutoriel vidéo
• Commande d'un serveur avec Mumble via l'API

Mumble. Fonctionnalités clés¶

• Les applications clientes de cette plateforme sont disponibles sur Windows, Linux, macOS, iOS et Android, ce qui la rend compatible multiplateforme.
• Le codec audio Opus est utilisé pour garantir une faible latence et une haute qualité sonore.
• Le trafic vocal est chiffré à l'aide du protocole TLS pour maintenir la confidentialité des conversations.
• Le serveur peut gérer des milliers d'utilisateurs simultanés, ce qui le rend très évolutif.
• L'audio spatial et la parole directionnelle sont pris en charge, offrant un audio réaliste dans les jeux et la réalité virtuelle.
• L'architecture de plug-ins peut être utilisée pour étendre les fonctionnalités des composants client et serveur.

Fonctionnalités de déploiement¶

• Logiciel installé :
  • Serveur Mumble.

Premiers pas après le déploiement de Mumble¶

Une notification sera envoyée à l'adresse e-mail spécifiée lors de l'inscription indiquant que le serveur est prêt pour le travail après le paiement de la commande. Elle contiendra l'adresse IP du VPS, ainsi que le nom d'utilisateur et le mot de passe pour la connexion. Les clients de notre entreprise gèrent le matériel dans les serveurs et le panneau de contrôle API — Invapi.

• Login et Password pour la connexion au serveur : envoyés par e-mail à votre adresse e-mail lorsque le serveur est prêt après le déploiement du logiciel.

Obtention du mot de passe administrateur¶

Étape 1 : Connectez-vous au serveur via SSH :

ssh root@YOUR_IP_ADDRESS

Étape 2 : Trouvez l'ID du conteneur Docker pour Mumble :

docker ps

La sortie affichera une ligne similaire à celle-ci :

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

Retenez l'ID DU CONTENEUR (première colonne) : a1f296c17976

Étape 3 : Entrez dans le conteneur et affichez le journal :

docker exec -it <container_ID> /bin/bash


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

La sortie affichera quelque chose comme :

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

Conservez ce mot de passe !

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

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

Étape 4 : Quittez le conteneur et vérifiez que le serveur est en cours d'exécution :

exit


docker ps

Configuration du client¶

Pour commencer à utiliser le service, vous devez télécharger le client Mumble sur votre appareil local et l'installer.

Lors du premier lancement, vous devrez effectuer la configuration initiale via l'assistant de configuration :

1. Entrée et sortie de l'appareil - vous pouvez laisser les options par défaut, et également sélectionner des paramètres supplémentaires (facultatif) :

   • Utiliser la suppression d'écho ;
   • Activer l'audio positionnel ;
   • Atténuer les applications pendant que d'autres utilisateurs parlent.

2. Réglage de l'appareil - réglez sur la valeur minimale à l'aide du curseur ;

3. Réglage du volume - ajustez le niveau ;

4. Détection de l'activité vocale - définissez le seuil (à cette étape, vous pouvez également attribuer un bouton pour activer la communication vocale) ;

5. Qualité et notifications - définissez les préférences ;

6. Audio positionnel - ajustez les paramètres ;

7. Utiliser un certificat existant - il est recommandé de choisir Création automatique de certificat ;

8. Cliquez sur le bouton Finish.

Modification de la langue de l'interface¶

L'interface de Mumble est en anglais par défaut. Pour modifier les paramètres de langue :

1. Fermez la liste des serveurs ;
2. Accédez à : Configure > Settings > User Interface > Language ;
3. Sélectionnez la langue dans la liste déroulante ;
4. Cliquez sur les boutons Apply et OK :

L'application redémarrera avec la langue d'interface sélectionnée.

Configuration de la sortie audio¶

Après la connexion au serveur, il est recommandé de configurer le client Mumble. Tous les paramètres sont disponibles dans le menu Configure > Settings dans les versions de bureau ou dans les paramètres de l'application sur les clients mobiles.

Qualité audio¶

Mumble utilise le codec Opus avec une qualité de transmission audio cible ajustable.

Section : Audio Input > Compression > Quality

• 40 kbit/s - valeur standard, suffisante pour une communication vocale confortable
• 64-96 kbit/s - haute qualité pour la musique ou l'audio professionnel
• 32 kbit/s - économie de trafic (internet mobile), réduction possible de la qualité

Modes de transmission audio¶

Section : Audio Input > Transmission

Par défaut, le mode Voice Activity est utilisé. Dans ce mode, le microphone s'active automatiquement lorsque la parole est détectée.

Ajustement de la sensibilité :

• Les curseurs vous permettent d'ajuster le seuil de déclenchement ;
• Évitez de transmettre le bruit de fond ;
• Assurez une reconnaissance vocale correcte.

Modes alternatifs :

• Push-to-Talk - le microphone s'active uniquement lors de l'appui sur un bouton (recommandé pour les environnements bruyants) ;
• Continuous - le microphone fonctionne en permanence (non recommandé).

Traitement audio¶

Section : Audio Input > Audio Processing

Le client prend en charge les algorithmes de suppression du bruit :

• Speex - algorithme classique ;
• RNNoise - plus efficace pour supprimer le bruit de fond constant (ventilateur, climatiseur, clavier).

Vous pouvez utiliser les deux algorithmes ensemble pour un effet maximal.

Suppression du bruit :

• Ajustez le curseur de force de suppression du bruit Speex ;
• Activez RNNoise pour un filtrage supplémentaire ;
• Combinez les deux méthodes pour de meilleurs résultats.

Annulation d'écho¶

Les paramètres d'annulation d'écho doivent être sélectionnés en fonction de l'équipement utilisé :

• Lors du travail avec des haut-parleurs - mode d'annulation d'écho plus agressif ;
• Lors de l'utilisation d'écouteurs - l'annulation d'écho peut être désactivée.

Configuration de l'entrée audio¶

Mise en mémoire tampon¶

Section : Audio Output

Deux paramètres clés affectent la stabilité de la lecture :

1. Default Jitter Buffer

• Accumule l'audio entrant avant la lecture ;
• Compense l'instabilité du réseau ;
• Par défaut : 10 ms ;
• Quand augmenter : si la parole saccade lorsque les gens commencent à parler.

2. Output Delay

• Ajoute une mise en mémoire tampon avant la sortie audio ;
• Quand augmenter : si vous entendez des saccades rapides ou des artefacts sur certains pilotes audio.

Volume et atténuation¶

• Ajustez le volume avec le curseur dans le client ou via le mélangeur système ;
• Atténuation - fonctionnalité utile qui abaisse automatiquement la musique ou les sons du jeu lorsque quelqu'un parle.

Test des paramètres¶

Utilisez le Loopback Test pour la vérification :

• Mode local - teste l'audio d'entrée et de sortie ;
• Mode serveur - teste la connexion réseau.

Notifications et chat¶

Section : Messages

Dans cette section, vous pouvez configurer de manière flexible quels événements seront :

• Affichés dans la fenêtre de messages ;
• Accompagnés d'un signal sonore ;
• Annoncés à l'aide de la synthèse vocale (Text-to-Speech).

Par défaut, les notifications principales sont activées :

• Connexion et déconnexion des utilisateurs ;
• Messages critiques et avertissements.

Connexion au serveur¶

Pour vous connecter au serveur Mumble, utilisez les informations d'identification suivantes :

• Login - SuperUser ;
• Password - mot de passe généré automatiquement (obtenu à partir des journaux).

Processus de connexion¶

Étape 1 : Lancez le client Mumble et cliquez sur le bouton Add New...

Étape 2 : Remplissez le formulaire de connexion :

• Label : n'importe quel nom pour votre serveur ;
• Address : l'adresse IP de votre VPS ;
• Port : 64738 (par défaut, si non modifié) ;
• Username : SuperUser ;
• Password : mot de passe des journaux du serveur.

!!! tip Où trouver l'adresse IP L'adresse IP du serveur peut être trouvée dans la carte du serveur dans le panneau Invapi sur l'onglet Network :

![](./images/mumble_8.png)

Étape 3 : Cliquez sur OK, sélectionnez le serveur dans la liste et cliquez sur Connect.

Étape 4 : Lors de la première connexion, le client affichera un avertissement concernant un certificat SSL auto-signé - c'est normal pour un nouveau serveur, cliquez sur Yes.

Après la connexion, vous serez dans le canal racine avec le nom SuperUser et l'icône d'administrateur.

Connexion des utilisateurs réguliers¶

Pour se connecter au serveur, les utilisateurs réguliers doivent :

1. Ajouter un nouveau serveur dans le client Mumble ;
2. Spécifier l'adresse IP du serveur ;
3. Spécifier le port 64738 ;
4. Choisir un nom d'utilisateur ;
5. Aucun mot de passe n'est requis pour les utilisateurs réguliers.

Gestion du serveur¶

Création de la structure des canaux¶

Par défaut, il n'y a que le canal racine. Pour plus de commodité, créons plusieurs sous-canaux.

Création d'un canal :

1. Faites un clic droit sur le canal racine ;
2. Add ;
3. Entrez le nom du canal.

Exemple de structure :

Root (Canal racine)
├── General Room
├── Games
│   ├── Counter-Strike
│   └── Dota 2
├── Work
│   ├── Meetings
│   └── Communication
└── AFK (pour absent)

Droits d'accès aux canaux¶

Les droits d'accès sont configurés via le menu contextuel du canal :

1. Clic droit sur le canal > Edit ;
2. Onglet ACL :

Ce qui peut être configuré :

• Définir un mot de passe pour le canal ;
• Restreindre l'accès à des groupes d'utilisateurs spécifiques ;
• Autoriser/interdire de parler dans le canal ;
• Configurer les droits pour créer des sous-canaux.

Gestion des utilisateurs¶

Enregistrement des utilisateurs¶

Comment un utilisateur s'enregistre :

1. Se connecte au serveur avec n'importe quel nom ;
2. Clic droit sur son nom > Register ;
3. Le serveur mémorise le certificat de l'utilisateur.

Après l'enregistrement :

• L'utilisateur se connecte automatiquement lors de la prochaine connexion ;
• Le nom d'utilisateur est réservé ;
• Des droits d'accès peuvent être attribués.

Création manuelle de comptes¶

L'administrateur peut créer des comptes manuellement :

1. Menu Server > Registered Users > Add ;
2. Entrez le nom d'utilisateur.

Sécurité et maintenance¶

Modification du port¶

Le port standard 64738 est facilement trouvé par les scanners. Si vous souhaitez rendre la découverte du serveur plus difficile, vous pouvez changer le port pour n'importe quel autre.

Étape 1 : Copiez la configuration vers l'hôte :

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

Étape 2 : Modifiez la configuration :

nano mumble-server.ini

Trouvez la ligne port=64738 et changez-la pour le port souhaité, par exemple :

port=25000

Étape 3 : Copiez à nouveau :

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

Étape 4 : Redémarrez le serveur :

docker restart <container_ID>

Étape 5 : Maintenant, les utilisateurs doivent spécifier le nouveau port lors de la connexion :

IP:new_port

Sauvegarde¶

La sauvegarde est importante si vous utilisez Mumble non seulement pour la communication familiale.

La base de données Mumble avec les paramètres des utilisateurs et des canaux se trouve à /mumble/mumble-server.sqlite à l'intérieur du conteneur.

Sauvegarde manuelle¶

Copiez périodiquement la base de données pour vous-même :

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

Cette commande créera un fichier avec la date actuelle, par exemple : mumble-backup-20250112.sqlite

Restauration à partir d'une sauvegarde¶

Si le serveur plante, vous pouvez déployer un nouveau conteneur et restaurer tous les paramètres :

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

docker restart <new_container_ID>

Tutoriel vidéo¶

Commande d'un serveur avec Mumble via l'API¶