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
• Video-tutorial
• Een server met Mumble bestellen via de API

Mumble. Belangrijkste functies¶

• De clienttoepassingen voor dit platform zijn beschikbaar voor Windows, Linux, macOS, iOS en Android, waardoor het cross-platform compatibel is.
• De Opus-audiocodec wordt gebruikt om lage latentie en hoge geluidskwaliteit te waarborgen.
• Spraakverkeer wordt versleuteld met het TLS-protocol om de vertrouwelijkheid van gesprekken te behouden.
• De server kan duizenden gelijktijdige gebruikers aan, waardoor deze zeer schaalbaar is.
• Ruimtelijk geluid en gerichte spraak worden ondersteund, wat realistisch geluid biedt in games en virtual reality.
• De plug-inarchitectuur 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¶

Er wordt een melding verzonden naar het e-mailadres dat tijdens de registratie is opgegeven dat de server klaar is voor gebruik nadat de bestelling is betaald. Deze bevat het IP-adres van de VPS, evenals de login en het wachtwoord voor de verbinding. Klanten van ons bedrijf beheren de hardware in de server- en API-beheerpanelen — Invapi.

• Login en Wachtwoord voor serververbinding: worden per e-mail naar uw e-mailadres verzonden wanneer de server klaar is na het implementeren van de software.

Het administratorwachtwoord ophalen¶

Stap 1: Maak verbinding met de server via SSH:

ssh root@YOUR_IP_ADDRESS

Stap 2: Zoek het Docker-container-ID voor Mumble:

docker ps

De uitvoer toont een regel die er ongeveer zo uitziet:

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 het CONTAINER ID (eerste kolom): a1f296c17976

Stap 3: Ga naar de container en bekijk het logboek:

docker exec -it <container_ID> /bin/bash


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

De uitvoer toont iets als:

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

Bewaar dit wachtwoord!

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 gebruiken, moet u de Mumble-client downloaden op uw lokale apparaat en installeren.

Bij het eerste 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):

   • Echo-onderdrukking gebruiken;
   • Positioneel geluid inschakelen;
   • Applicaties dempen terwijl andere gebruikers praten.

2. Device Tuning - stel in op de minimale waarde met behulp van de schuifregelaar;

3. Volume Tuning - pas het niveau aan;

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

5. Quality & Notifications - stel voorkeuren in;

6. Positional Audio - pas instellingen aan;

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

8. Klik op de knop Finish.

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 taal uit de vervolgkeuzelijst;
4. Klik op de knoppen Apply en OK:

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

Audio-uitvoer configureren¶

Na het verbinden met de server wordt 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 instelbare doelkwaliteit voor audio-overdracht.

Sectie: Audio Input > Compression > Quality

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

Audio-overdrachtsmodi¶

Sectie: Audio Input > Transmission

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

Gevoeligheidsaanpassing:

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

Alternatieve modi:

• Push-to-Talk - microfoon wordt alleen geactiveerd bij het indrukken van een knop (aanbevolen voor lawaaierige omgevingen);
• Continuous - microfoon werkt continu (niet aanbevolen).

Audioverwerking¶

Sectie: Audio Input > Audio Processing

De client ondersteunt algoritmen voor risonderdrukking:

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

U kunt beide algoritmen samen gebruiken voor maximaal effect.

Risonderdrukking:

• Pas de schuifregelaar voor de sterkte van de Speex-risonderdrukking aan;
• Schakel RNNoise in voor extra filtering;
• Combineer beide methoden voor de beste resultaten.

Echo-annulering¶

Parameters voor echo-annulering moeten worden geselecteerd afhankelijk van het gebruikte materiaal:

• Bij werken met luidsprekers - agressievere modus voor echo-annulering;
• Bij gebruik van koptelefoon - echo-annulering kan worden uitgeschakeld.

Audio-invoer configureren¶

Buffering¶

Sectie: Audio Output

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

1. Default Jitter Buffer

• Verzamelt inkomend geluid voordat het wordt afgespeeld;
• Compenseert netwerkinstabiliteit;
• Standaard: 10 ms;
• Wanneer te verhogen: als spraak haperend klinkt wanneer mensen beginnen te praten.

2. Output Delay

• Voegt buffering toe voordat het geluid wordt uitgegeven;
• Wanneer te verhogen: als u snelle haperingen of artefacten hoort op sommige audiodrivers.

Volume en Demping¶

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

Instellingen testen¶

Gebruik Loopback Test voor verificatie:

• Lokale modus - test audio-invoer en -uitvoer;
• Servermodus - test netwerkverbinding.

Meldingen en Chat¶

Sectie: Messages

In deze sectie kunt u flexibel configureren welke gebeurtenissen:

• Worden weergegeven in het berichtvenster;
• Worden begeleid door een geluidssignaal;
• Worden aangekondigd met behulp van Text-to-Speech.

Standaard zijn de belangrijkste meldingen ingeschakeld:

• Gebruikersverbinding en -verbinding verbreken;
• Kritieke berichten en waarschuwingen.

Verbinding maken met de server¶

Gebruik de volgende inloggegevens om verbinding te maken met de Mumble-server:

• Login - SuperUser;
• Wachtwoord - automatisch gegenereerd wachtwoord (verkregen uit logboeken).

Verbindingsproces¶

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

Stap 2: Vul het verbindingsformulier in:

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

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

Gewone gebruikers verbinden¶

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

1. Een nieuwe server toevoegen in de Mumble-client;
2. Het server-IP-adres opgeven;
3. Poort 64738 opgeven;
4. Een gebruikersnaam kiezen;
5. Wachtwoord is niet vereist voor gewone gebruikers.

Serverbeheer¶

Kanaalstructuur maken¶

Standaard is er alleen het rootkanaal. Voor het gemak maken we enkele subkanalen.

Een kanaal maken:

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

Voorbeeldstructuur:

Root (Rootkanaal)
├── General Room
├── Games
│   ├── Counter-Strike
│   └── Dota 2
├── Work
│   ├── Meetings
│   └── Communication
└── AFK (voor afwezigheid)

Kanaaltoegangrechten¶

Toegangrechten worden geconfigureerd via het contextmenu van het kanaal:

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

Wat kan worden geconfigureerd:

• Een wachtwoord voor het kanaal instellen;
• Toegang beperken tot specifieke gebruikersgroepen;
• Spreken in het kanaal toestaan/verbieden;
• Rechten configureren 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;
• Toegangrechten kunnen worden toegewezen.

Handmatig account maken¶

De administrator kan accounts handmatig maken:

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

Beveiliging en onderhoud¶

De poort wijzigen¶

De standaardpoort 64738 wordt gemakkelijk gevonden door scanners. Als u het vinden van de server moeilijker wilt maken, kunt u de poort wijzigen naar een andere.

Stap 1: Kopieer configuratie naar 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 verander deze naar de gewenste poort, bijvoorbeeld:

port=25000

Stap 3: Kopieer terug:

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

Back-up¶

Back-up is belangrijk als u Mumble niet alleen gebruikt voor familiecommunicatie.

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

Handmatige back-up¶

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 uit back-up¶

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 met Mumble bestellen via de API¶