No description
Find a file
2026-11-04 20:31:22 +01:00
landing Aktualisiere .body-Stil in index.html.template mit verbessertem Padding für eine bessere Benutzererfahrung. 2026-11-04 20:31:22 +01:00
.env.example Aktualisiere Traefik-Zertifikatsresolver auf 'le', passe Berechtigungen für Schlüsseldateien an und füge Mumble-Diagnose-Playbook hinzu. 2026-11-04 17:52:16 +01:00
.gitignore inital commit 2026-02-21 17:24:43 +01:00
config.sh Verbessere die Nutzungshinweise in config.sh und füge Fehlerbehandlung für die .env-Datei hinzu 2026-11-04 03:42:07 +01:00
crontab.example inital commit 2026-02-21 17:24:43 +01:00
docker-compose.yml Füge Schriftarten für IBM Plex Mono und Inter hinzu und aktualisiere das Layout der index.html.template mit Animationen und verbesserten Benutzerführungselementen. 2026-11-04 19:05:19 +01:00
MUMBLE-PLAYBOOK.md Aktualisiere Traefik-Zertifikatsresolver auf 'le', passe Berechtigungen für Schlüsseldateien an und füge Mumble-Diagnose-Playbook hinzu. 2026-11-04 17:52:16 +01:00
README.md Füge MUMBLE_BIND_ADDRESS hinzu und aktualisiere Konfiguration; verbessere Validierung und Docker-Compose-Einstellungen 2026-11-04 03:38:01 +01:00
renew-certs.sh Aktualisiere Traefik-Zertifikatsresolver auf 'le', passe Berechtigungen für Schlüsseldateien an und füge Mumble-Diagnose-Playbook hinzu. 2026-11-04 17:52:16 +01:00
setup.sh Aktualisiere Traefik-Zertifikatsresolver auf 'le', passe Berechtigungen für Schlüsseldateien an und füge Mumble-Diagnose-Playbook hinzu. 2026-11-04 17:52:16 +01:00

Mumble Server

Ressourcenschonender Mumble-Server für eine private Gruppe auf einem Docker-Host.

Voraussetzungen

  • Docker mit Docker Compose v2
  • OpenSSL für Zertifikate und Passwortgenerierung
  • DNS-Eintrag zur öffentlichen IP des Routers
  • Router- und Firewallfreigabe für den konfigurierten Mumble-Port über UDP und TCP
  • Optional: Traefik und ein externes Docker-Netzwerk für die Landingpage

Schnellstart

Erstelle die Konfiguration und beschränke den Dateizugriff. Die Datei enthält das Serverpasswort.

cp .env.example .env
chmod 600 .env
openssl rand -hex 32

Trage die Ausgabe des letzten Befehls als MUMBLE_PASSWORD in .env ein. Die .env ist die Laufzeitquelle für Server, Zertifikate, Ressourcen und Landingpage. Nicht committen oder weitergeben.

Die Datei nutzt einfache KEY=value-Zeilen. Der Parser führt keine Shell-Befehle aus und unterstützt keine Variablenexpansion. Verwende für Passwörter den oben gezeigten hexadezimalen Generator.

Prüfe die Konfiguration und starte den Server:

bash config.sh .env
./setup.sh

setup.sh kann aus jedem Arbeitsverzeichnis gestartet werden. Es prüft die Werte und Compose-Konfiguration, bevor Zertifikate erstellt werden.

Die Landingpage ist optional. Sie benötigt das in TRAEFIK_NETWORK angegebene, bereits vorhandene externe Docker-Netzwerk:

docker compose --profile landing up -d

Konfiguration

Alle Laufzeitwerte stehen in .env. .env.example enthält die vollständige Vorlage.

  • DOMAIN: DNS-Name des Mumble-Servers und der Landingpage
  • PORT: interner und externer Mumble-Port für UDP und TCP
  • MUMBLE_BIND_ADDRESS: private IPv4-Adresse des Docker-Hosts; diese Adresse in .env eintragen und im Router als internes Ziel verwenden
  • MUMBLE_PASSWORD: eindeutiges Passwort mit mindestens 20 Zeichen
  • WELCOME_TEXT: Begrüßungstext
  • MAX_USERS: maximale gleichzeitige Nutzerzahl
  • MUMBLE_CPUS, MUMBLE_MEMORY: Obergrenzen für Mumble
  • LANDING_CPUS, LANDING_MEMORY: Obergrenzen für Nginx
  • CERT_MODE: self_signed oder internal_ca
  • CERT_DAYS: Laufzeit des Serverzertifikats, 1 bis 825 Tage
  • CA_CERT_DAYS: Laufzeit des internen CA-Zertifikats, 1 bis 8250 Tage
  • CERT_RENEWAL_THRESHOLD_DAYS: Erneuerungsschwelle, 1 bis 3650 Tage
  • TRAEFIK_NETWORK, TRAEFIK_ENTRYPOINT, TRAEFIK_CERT_RESOLVER: Landingpage-Routing

Die Ressourcenlimits in der Vorlage passen zu einer kleinen Gruppe mit ungefähr bis zu 100 Nutzern. Größere Gruppen brauchen Limits, die zur tatsächlichen Auslastung passen.

Netzwerk

Mumble bindet nur an MUMBLE_BIND_ADDRESS, nicht an alle Host-Schnittstellen (0.0.0.0). Weise dem Docker-Host dafür eine feste private IPv4-Adresse zu, zum Beispiel per DHCP-Reservierung. Leite den Wert aus PORT im Router an genau diese Adresse weiter:

Protokoll Externer Port Interner Port Zweck
UDP PORT PORT Sprachdaten
TCP PORT PORT Verbindung und Steuerung

Die Domain aus DOMAIN muss auf die öffentliche IP zeigen. DynDNS kann diese Zuordnung aktuell halten. Die WAN-Portweiterleitung bleibt nötig, wenn Clients von außerhalb verbinden sollen.

Zertifikate

self_signed erstellt ein selbstsigniertes Serverzertifikat. Clients können beim ersten Verbinden eine Warnung zeigen.

internal_ca erstellt eine lokale Certificate Authority. Verteile certs/ca.crt sicher an die Clients. Verteile niemals certs/ca.key.

setup.sh installiert für den ausführenden Benutzer automatisch einen täglichen Cronjob um 03:00 Uhr. Er liest CERT_RENEWAL_THRESHOLD_DAYS aus .env:

./renew-certs.sh
crontab -l

Der Eintrag trägt einen eindeutigen Projektmarker. Fehlt das Projektverzeichnis beim nächsten Lauf, entfernt der Job nur seinen eigenen Crontab-Eintrag. Andere Cronjobs bleiben unverändert.

Das Skript protokolliert nach cert-renewal.log und bewahrt die letzten fünf Zertifikats-Backups.

Verwaltung

docker compose logs -f mumble
docker compose ps
docker compose restart mumble
docker compose pull && docker compose up -d
docker compose down

Die Landingpage-Logs lassen sich mit docker compose --profile landing logs -f voice-landing anzeigen.

Sicherheit und Fehlerbehebung

  • Halte .env auf Dateimodus 600; Setup und Erneuerung setzen diesen Modus ebenfalls.
  • Docker-Zugriff entspricht in der Regel administrativem Zugriff auf den Host.
  • Private Schlüssel liegen in certs/ und sind von Git ausgeschlossen.
  • Prüfe Containerfehler mit docker compose logs und den Status mit docker compose ps.
  • Prüfe die Router- und Firewallfreigabe für PORT über UDP und TCP.
  • Prüfe die DNS-Auflösung von DOMAIN und den Zertifikatstatus in certs/.

Projektdateien

docker-compose.yml       Container und Netzwerk
config.sh                Sichere Env-Auswertung und Validierung
.env.example             Konfigurationsvorlage
setup.sh                 Erstinstallation
renew-certs.sh           Zertifikatserneuerung
landing/index.html.template  Dynamische Landingpage
data/                    Persistente Mumble-Daten
certs/                   Zertifikate und Backups

Alle Services werden mit Docker Compose verwaltet.