- Shell 100%
| landing | ||
| .env.example | ||
| .gitignore | ||
| config.sh | ||
| crontab.example | ||
| docker-compose.yml | ||
| MUMBLE-PLAYBOOK.md | ||
| README.md | ||
| renew-certs.sh | ||
| setup.sh | ||
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 LandingpagePORT: interner und externer Mumble-Port für UDP und TCPMUMBLE_BIND_ADDRESS: private IPv4-Adresse des Docker-Hosts; diese Adresse in.enveintragen und im Router als internes Ziel verwendenMUMBLE_PASSWORD: eindeutiges Passwort mit mindestens 20 ZeichenWELCOME_TEXT: BegrüßungstextMAX_USERS: maximale gleichzeitige NutzerzahlMUMBLE_CPUS,MUMBLE_MEMORY: Obergrenzen für MumbleLANDING_CPUS,LANDING_MEMORY: Obergrenzen für NginxCERT_MODE:self_signedoderinternal_caCERT_DAYS: Laufzeit des Serverzertifikats, 1 bis 825 TageCA_CERT_DAYS: Laufzeit des internen CA-Zertifikats, 1 bis 8250 TageCERT_RENEWAL_THRESHOLD_DAYS: Erneuerungsschwelle, 1 bis 3650 TageTRAEFIK_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
.envauf Dateimodus600; 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 logsund den Status mitdocker compose ps. - Prüfe die Router- und Firewallfreigabe für
PORTüber UDP und TCP. - Prüfe die DNS-Auflösung von
DOMAINund den Zertifikatstatus incerts/.
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.