Mumble¶

In dit artikel

• Mumble. Belangrijkste functies
• Implementatiefuncties
• Aan de slag na het implementeren van Mumble
• Clientconfiguratie
• Verbinding maken met de server
• Serverbeheer
• Beveiliging en onderhoud
• Videotutorial
• Een server met Mumble bestellen via de API

Mumble. Belangrijkste functies¶

• De client-applicaties voor dit platform zijn beschikbaar voor Windows, Linux, macOS, iOS en Android, waardoor het cross-platform compatibel is.
• De Opus-audiocodec 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 verwerken, wat het zeer schaalbaar maakt.
• 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¶

Aan de slag na het implementeren van Mumble¶

Nadat u voor de bestelling heeft betaald, wordt er een melding naar het e-mailadres gestuurd dat is opgegeven tijdens de registratie 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 de server- en API-beheerderspaneel — Invapi.

• Login en Password voor de serververbinding: wordt per e-mail naar uw e-mailadres 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 binnen 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 installatie 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 de spraakcommunicatie te activeren);

5. Quality & Notifications - voorkeuren instellen;

6. Positional Audio - instellingen aanpassen;

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

8. Klik op de Finish knop.

De taal van de interface wijzigen¶

De Mumble-interface is standaard in het 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 opgestart met de geselecteerde taal voor de interface.

Audio-uitvoer configureren¶

Nadat u verbinding heeft gemaakt met de server, wordt 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 gebruikt de Opus codec met aanpasbare doelkwaliteit voor de audiogransmissie.

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 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).

Audioverwerking¶

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 de beste resultaten.

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.

Audio-invoer 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 voor de audio-uitvoer;
• Wanneer te verhogen: als u snel haperingen of artefacten hoort op sommige audiodrivers.

Volume en Attenuatie¶

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

Instellingen testen¶

Gebruik de Loopback Test voor verificatie:

• Local mode - test de audio-invoer en -uitvoer;
• Server mode - test de netwerkverbinding.

Meldingen en Chat¶

Sectie: Messages

In deze sectie kunt u flexibel configureren welke gebeurtenissen:

• 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.

Verbinding maken 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: het 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.

Verbinding maken voor gewone gebruikers¶

Om verbinding te maken met de server, moeten gewone gebruikers het volgende doen:

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

Serverbeheer¶

Het 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 kanaal)
├── 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 kanaal > Edit;
2. Tabblad ACL:

Wat geconfigureerd kan worden:

• Stel een wachtwoord in voor het kanaal;
• Beperk de toegang tot specifieke gebruikersgroepen;
• Sta het spreken in het kanaal toe/weiger het;
• 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;
• 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¶

Het poortnummer 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¶

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

De Mumble-database met gebruikers- en kanaalinstellingen bevindt zich op /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 vastloopt, 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>

Videotutorial¶

Een server met Mumble bestellen via de API¶

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