Mumble¶

In dit artikel

• Mumble. Key Features
• Implementatiefuncties
• Aan de slag na het implementeren van Mumble
• Clientconfiguratie
• Verbinden met de server
• Server Management
• Beveiliging en onderhoud
• Video tutorial
• Een server bestellen met Mumble via de API

Mumble. Key Features¶

• De client-applicaties voor dit platform zijn beschikbaar voor Windows, Linux, macOS, iOS en Android, waardoor het cross-platform compatibel is.
• De Opus audio-codec wordt gebruikt om een lage latentie en hoge geluidskwaliteit te garanderen.
• Spraakverkeer wordt versleuteld met het TLS-protocol om de vertrouwelijkheid van gesprekken te waarborgen.
• De server kan duizenden gelijktijdige gebruikers aan, waardoor deze zeer schaalbaar is.
• Spatial audio en directionele spraak worden ondersteund, wat zorgt voor realistisch geluid in games en virtual reality.
• De plug-in architectuur kan worden gebruikt om de functionaliteit van zowel client- als servercomponenten uit te breiden.

Implementatiefuncties¶

• Geïnstalleerde software:
  • Mumble server.

Aan de slag na het implementeren van Mumble¶

Nadat u heeft betaald voor de bestelling, wordt er een melding naar het e-mailadres gestuurd dat tijdens de registratie is opgegeven om te laten weten dat de server klaar is voor gebruik. Deze bevat het IP-adres van de VPS, evenals de login en het wachtwoord voor de verbinding. De klanten van ons bedrijf beheren de hardware in het server s en API control panel — Invapi.

• Login and Password for the serververbinding: wordt per e-mail naar uw adres gestuurd wanneer de server klaar is na de software-implementatie.

Het Administrator Wachtwoord ophalen¶

Stap 1: Verbind met de server via SSH:

ssh root@YOUR_IP_ADDRESS

Stap 2: Zoek de Docker container ID voor Mumble:

docker ps

De output zal een regel tonen die lijkt op deze:

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

Onthoud de CONTAINER ID (eerste kolom): a1f296c17976

Stap 3: Ga de container in en bekijk het logbestand:

docker exec -it <container_ID> /bin/bash

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

De output zal iets tonen als:

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

Sla dit wachtwoord op!

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

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

Stap 4: Verlaat de container en controleer of de server draait:

exit

docker ps

Clientconfiguratie¶

Om de service te gaan gebruiken, moet u de Mumble client downloaden naar uw lokale apparaat en deze installeren.

Bij de eerste keer opstarten moet u de initiële configuratie voltooien via de configuratiewizard:

1. Device input and output - u kunt de default opties laten staan en ook extra instellingen selecteren (optioneel):

   • Gebruik echo-onderdrukking;
   • Schakel positional audio in;
   • Demp applicaties terwijl andere gebruikers praten.

2. Device Tuning - instellen op de minimale waarde met de schuifregelaar;

3. Volume Tuning - het niveau aanpassen;

4. Voice Activity Detection - de drempelwaarde instellen (bij deze stap kunt u ook een knop toewijzen om spraakcommunicatie te activeren);

5. Quality & Notifications - voorkeuren instellen;

6. Positional Audio - instellingen aanpassen;

7. Use Existing Certificate - het is aanbevolen om Automatic certificate creation te kiezen;

8. Klik op de Finish knop.

De taal van de interface wijzigen¶

De Mumble-interface staat standaard ingesteld op Engels. Om de taalinstellingen te wijzigen:

1. Sluit de serverlijst;
2. Navigeer naar: Configure > Settings > User Interface > Language;
3. Selecteer een taal uit de vervolgkeuzelijst;
4. Klik op de Apply en OK knoppen:

De applicatie wordt opnieuw gestart met de geselecteerde taal voor de interface.

Audio Output configureren¶

Nadat u verbinding heeft gemaakt met de server, is het aanbevolen om de Mumble client te configureren. Alle instellingen zijn beschikbaar in het menu Configure > Settings in desktopversies of in de app-instellingen op mobiele clients.

Audiokwaliteit¶

Mumble maakt gebruik van de Opus codec met een aanpasbare doelkwaliteit voor audio-transmissie.

Sectie: Audio Input > Compression > Quality

• 40 kbit/s - standaardwaarde, voldoende voor comfortabele spraakcommunicatie
• 64-96 kbit/s - hoge kwaliteit voor muziek of professionele audio
• 32 kbit/s - verkeersbesparing (mobiel internet), mogelijke kwaliteitsvermindering

Audiotransmissiemodi¶

Sectie: Audio Input > Transmission

Standaard wordt de modus Voice Activity gebruikt. In deze modus wordt de microfoon automatisch geactiveerd wanneer er spraak wordt gedetecteerd.

Gevoeligheidsinstelling:

• Schuifregelaars stellen u in staat om de drempelwaarde voor activatie aan te passen;
• Voorkom het verzenden van achtergrondruis;
• Zorg voor een correcte spraakherkenning.

Alternatieve modi:

• Push-to-Talk - de microfoon wordt alleen geactiveerd wanneer u een knop indrukt (aanbevolen voor lawaaierige omgevingen);
• Continuous - de microfoon werkt constant (niet aanbevolen).

Audiabehandeling¶

Sectie: Audio Input > Audio Processing

De client ondersteunt algoritmen voor ruisonderdrukking:

• Speex - klassiek algoritme;
• RNNoise - effectiever in het onderdrukken van constante achtergrondruis (ventilator, airconditioning, toetsenbord).

U kunt beide algoritmen samen gebruiken voor een maximaal effect.

Ruisonderdrukking:

• Pas de sterkte van de Speex ruisonderdrukking aan met de schuifregelaar;
• Schakel RNNoise in voor extra filtering;
• Combineer beide methoden voor het beste resultaat.

Echo-onderdrukking¶

De parameters voor echo-onderdrukking moeten worden geselecteerd afhankelijk van de gebruikte apparatuur:

• Bij gebruik van luidsprekers - een agressievere modus voor echo-onderdrukking;
• Bij gebruik van een headset - echo-onderdrukking kan worden uitgeschakeld.

Geluidsinput configureren¶

Buffering¶

Sectie: Audio Output

Twee belangrijke parameters beïnvloeden de stabiliteit van de weergave:

1. Default Jitter Buffer

• Accumuleert inkomende audio voor weergave;
• Compenseert voor netwerkinstabiliteit;
• Default: 10 ms;
• Wanneer te verhogen: als spraak hapert wanneer mensen beginnen te praten.

2. Output Delay

• Voegt buffering toe vóór de audio-output;
• Wanneer te verhogen: als u snel haperingen of artefacten hoort op bepaalde audiodrivers.

Volume en Attenuation¶

• Pas het volume aan met de schuifregelaar in de client of via de systeemmixer;
• Attenuation - een handige functie die automatisch muziek- of gamegeluiden verlaagt wanneer iemand spreekt.

Instellingen testen¶

Gebruik de Loopback Test voor verificatie:

• Local mode - test de audio-input en -output;
• Server mode - test de netwerkverbinding.

Meldingen en Chat¶

Sectie: Messages

In deze sectie kunt u flexibel configureren welke gebeurtenissen zullen:

• Worden weergegeven in het berichtenvenster;
• Worden vergezeld door een geluidssignaal;
• Worden aangekondigd via Text-to-Speech.

Standaard zijn de belangrijkste meldingen ingeschakeld:

• Gebruikersverbinding en -ontkoppeling;
• Kritieke berichten en waarschuwingen.

Verbinden met de server¶

Om verbinding te maken met de Mumble-server, gebruikt u de volgende gegevens:

• Login - SuperUser;
• Password - automatisch gegenereerd wachtwoord (verkregen uit de logs).

Verbindingsproces¶

Stap 1: Start de Mumble client en klik op de Add New... knop

Stap 2: Vul het verbindingsformulier in:

• Label: een willekeurige naam voor uw server;
• Address: uw VPS IP-adres;
• Port: 64738 (standaard, tenzij gewijzigd);
• Username: SuperUser;
• Password: wachtwoord uit de serverlogs.

Stap 3: Klik op OK, selecteer de server uit de lijst en klik op Connect.

Stap 4: Bij de eerste verbinding toont de client een waarschuwing over een zelfondertekend SSL-certificaat - dit is normaal voor een nieuwe server, klik op Yes.

Na het verbinden bevindt u zich in het rootkanaal met de naam SuperUser en het administrator-icoon.

Verbinden van gewone gebruikers¶

Om verbinding te maken met de server moeten gewone gebruikers:

1. Een nieuwe server toevoegen in de Mumble client;
2. Het server IP address opgeven;
3. Port 64738 opgeven;
4. Een username kiezen;
5. Voor gewone gebruikers is een Password niet vereist.

Server Management¶

Kanaalstructuur maken¶

Standaard is er alleen een rootkanaal. Voor het gemak maken we verschillende subkanalen aan.

Een kanaal aanmaken:

1. Klik met de rechtermuisknop op het rootkanaal;
2. Add;
3. Voer de kanaalnaam in.

Voorbeeldstructuur:

Root (Root channel)
├── General Room
├── Games
│   ├── Counter-Strike
│   └── Dota 2
├── Work
│   ├── Meetings
│   └── Communication
└── AFK (for away)

Toegangsrechten voor kanalen¶

Toegangsrechten worden geconfigureerd via het contextmenu van het kanaal:

1. Klik met de rechtermuisknop op een kanaal > Edit;
2. Tabblad ACL:

Wat geconfigureerd kan worden:

• Stel een wachtwoord in voor het kanaal;
• Beperk toegang tot specifieke gebruikersgroepen;
• Sta/verbied spreken in het kanaal;
• Configureer rechten voor het maken van subkanalen.

Gebruikersbeheer¶

Gebruikersregistratie¶

Hoe een gebruiker zich registreert:

1. Maakt verbinding met de server met een willekeurige naam;
2. Klik met de rechtermuisknop op hun naam > Register;
3. De server onthoudt het certificaat van de gebruiker.

Na registratie:

• Gebruiker maakt automatisch verbinding bij de volgende login;
• De gebruikersnaam is gereserveerd;
• Toegangsrechten kunnen worden toegewezen.

Handmatige accountcreatie¶

De administrator kan handmatig accounts aanmaken:

1. Menu Server > Registered Users > Add;
2. Voer de gebruikersnaam in.

Beveiliging en onderhoud¶

De poort wijzigen¶

De standaardpoort 64738 is gemakkelijk te vinden door scanners. Als u de ontdekking van de server moeilijker wilt maken, kunt u de poort wijzigen naar een andere.

Stap 1: Kopieer de configuratie naar de host:

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

Stap 2: Bewerk de configuratie:

nano mumble-server.ini

Zoek de regel port=64738 en wijzig deze naar de gewenste poort, bijvoorbeeld:

port=25000

Stap 3: Terug kopiëren:

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

Stap 4: Herstart de server:

docker restart <container_ID>

Stap 5: Gebruikers moeten nu de nieuwe poort opgeven bij het verbinden:

IP:new_port

Backup¶

Een backup is belangrijk als u Mumble niet alleen gebruikt voor communicatie met familie.

De Mumble-database met gebruikers- en kanaalinstellingen bevindt zich in /mumble/mumble-server.sqlite binnen de container.

Handmatige backup¶

Kopieer de database periodiek naar uzelf:

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

Dit commando maakt een bestand aan met de huidige datum, bijvoorbeeld: mumble-backup-20250112.sqlite

Herstellen van een backup¶

Als de server crasht, kunt u een nieuwe container implementeren en alle instellingen herstellen:

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

docker restart <new_container_ID>

Video tutorial¶

Een server bestellen met Mumble via de API¶

Om deze software te installeren via de API, volgt u deze instructies.