Mumble¶

Dans cet article

• Mumble. Caractéristiques principales
• 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
• Commander un serveur avec Mumble en utilisant l'API

Mumble. Caractéristiques principales¶

• Les applications client pour cette plateforme sont disponibles sur Windows, Linux, macOS, iOS et Android, ce qui la rend compatible avec plusieurs systèmes d'exploitation.
• Le codec audio Opus est utilisé pour garantir une faible latence et une haute qualité sonore.
• Le trafic vocal est crypté en utilisant le 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 son 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¶

• Logiciels installés:
  • Serveur Mumble dans un conteneur Docker.
• Emplacement des fichiers clés (à l'intérieur du conteneur Docker):
  • Fichier de configuration : /etc/mumble-server.ini ;
  • Base de données: /mumble/mumble-server.sqlite ;
  • Fichier journal: /mumble/mumble-server.log ;
  • Fichier PID: /run/mumble-server/mumble-server.pid.

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

Un e-mail vous sera envoyé à l'adresse indiquée lors de votre inscription, notifiant que le serveur est prêt pour un usage une fois la commande payée. Il contiendra l'adresse IP du VPS ainsi que les identifiants de connexion. Les clients de notre société gèrent le matériel dans le panneau de contrôle du serveur et API — Invapi.

• Nom d'utilisateur et Mot de passe 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@VOTRE_ADRESSE_IP

É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

Mémorisez le CONTAINER ID (première colonne) : a1f296c17976

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

docker exec -it <ID_conteneur> /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'

Enregistrez ce mot de passe !

docker exec -it <ID_conteneur> murmurd -ini /etc/mumble-server.ini -supw NouveauMotDePasse123

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

Étape 4 : Quittez le conteneur et vérifiez que le serveur fonctionne :

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.

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

1. Device input and output - 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. Device Tuning - régler au minimum à l'aide du curseur;

3. Volume Tuning - ajuster le niveau;

4. Voice Activity Detection - définir le seuil (à cette étape, vous pouvez également assigner un bouton pour activer la communication vocale);

5. Quality & Notifications - définir les préférences;

6. Positional Audio - effectuer les réglages;

7. Use Existing Certificate - il est recommandé de choisir Automatic certificate creation;

8. Cliquer sur le bouton Finish.

Changer la langue de l'interface¶

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

1. Fermez la liste des serveurs;
2. Allez dans : Configure → Settings → User Interface → Language;
3. Sélectionnez le français (ou toute autre 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), possible réduction de 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.

Réglage de la sensibilité :

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

Modes alternatifs :

• Push-to-Talk - le microphone ne s'active que lorsqu'on appuie 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 choisis en fonction de l'équipement utilisé :

• Lors de l'utilisation de haut-parleurs - mode d'annulation d'écho plus agressif;
• Lors de l'utilisation d'un casque - 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 bégaie lorsque les gens commencent à parler.

2. Output Delay

• Ajoute une mise en mémoire tampon avant la sortie audio;
• Quand augmenter : si vous entendez un bégaiement rapide 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;
• Attenuation - fonctionnalité utile qui réduit automatiquement la musique ou les sons de jeu lorsque quelqu'un parle.

Test des paramètres¶

Utilisez Loopback Test pour la vérification :

• Local mode - teste l'entrée et la sortie audio;
• Server mode - teste la connexion réseau.

Notifications et chat¶

Section : Messages

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

• S'afficher dans la fenêtre des messages;
• Être accompagnés d'un signal sonore;
• Être annoncés à l'aide de 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 se connecter au serveur Mumble, utilisez les identifiants suivants :

• Nom d'utilisateur - SuperUser;
• Mot de passe - 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 fiche du serveur dans le panneau Invapi dans 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. Le mot de passe n'est pas 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. Clic droit sur le canal racine;
2. Add;
3. Entrez le nom du canal.

Exemple de structure :

Root (Canal racine)
├── Salle générale
├── Jeux
│   ├── Counter-Strike
│   └── Dota 2
├── Travail
│   ├── Réunions
│   └── Communication
└── AFK (pour les absents)

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 de création de sous-canaux.

Gestion des utilisateurs¶

Inscription des utilisateurs¶

Comment un utilisateur s'inscrit :

1. Se connecte au serveur avec n'importe quel nom;
2. Clic droit sur son nom → Register;
3. Le serveur se souvient du certificat de l'utilisateur.

Après l'inscription :

• L'utilisateur se connecte automatiquement lors de la prochaine connexion;
• Le nom d'utilisateur est réservé;
• Les 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¶

Changement de 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 sur l'hôte :

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

Étape 2 : Éditez 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 en retour :

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

Étape 4 : Redémarrez le serveur :

docker restart <ID_conteneur>

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

IP:nouveau_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 <ID_conteneur>:/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 tombe en panne, vous pouvez déployer un nouveau conteneur et restaurer tous les paramètres :

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

docker restart <ID_nouveau_conteneur>

Commander un serveur avec Mumble en utilisant l'API¶

Pour installer ce logiciel en utilisant l'API, suivez les instructions.

Une partie du contenu de cette page a été créée ou traduite à l'aide d'une intelligence artificielle.