Ich habe grommunio Meet inzwischen auf meiner Appliance hinter einer Sophos XGS mit WAF/Reverse Proxy erfolgreich zum Laufen gebracht. Es waren mehrere Konfigurationsprobleme, die zusammengekommen sind.
Vielleicht hilft meine Zusammenfassung jemandem mit einer ähnlichen Installation.
1. Falschen Hostnamen korrigieren
Bei mir wurde teilweise der interne Hostname der Appliance (hugro01.domain.local) anstelle des öffentlichen FQDN (mail.domain.ch) verwendet.
Den aktuellen System-Hostnamen kann man mit folgendem Befehl kontrollieren:
hostname -f
Das Meet-Setup sollte deshalb ausdrücklich mit dem öffentlichen FQDN ausgeführt werden:
grommunio-meet-setup mail.domain.ch
Wichtig: Der System-Hostname selbst muss dafür nicht geändert werden.
2. Client-Konfiguration korrigieren
In /srv/jitsi-meet/config.js waren nach dem Setup teilweise weiterhin falsche Hostnamen hinterlegt.
Zuerst die Datei sichern:
cp -a /srv/jitsi-meet/config.js /srv/jitsi-meet/config.js.bak
Anschliessend habe ich den internen Hostnamen durch den öffentlichen FQDN ersetzt:
sed -i 's/hugro01\.domain\.local/mail.domain.ch/g' /srv/jitsi-meet/config.js
Damit werden alle entsprechenden Vorkommen ersetzt, unter anderem in den Einstellungen für XMPP, BOSH und WebSocket.
Zur Kontrolle:
grep -nE 'domain|bosh|websocket' /srv/jitsi-meet/config.js
Die interne Adresse sollte danach nicht mehr vorkommen.
3. Videobridge-Konfiguration korrigieren
Ein weiteres Problem befand sich in /etc/jitsi/videobridge/jvb.conf.
Dort standen bei mehreren XMPP-Einstellungen noch nicht ersetzte ${FQDN}-Platzhalter. Dadurch konnte sich die Videobridge nicht korrekt bei Prosody registrieren.
Zunächst prüfen:
grep -nF '${FQDN}' /etc/jitsi/videobridge/jvb.conf
Falls entsprechende Einträge vorhanden sind, die Konfigurationsdatei sichern:
cp -a /etc/jitsi/videobridge/jvb.conf /etc/jitsi/videobridge/jvb.conf.bak
Danach die Platzhalter ersetzen:
sed -i 's/\${FQDN}/mail.domain.ch/g' /etc/jitsi/videobridge/jvb.conf
Zur Kontrolle nochmals:
grep -nF '${FQDN}' /etc/jitsi/videobridge/jvb.conf
Der Befehl sollte jetzt keine Treffer mehr liefern.
4. Sophos WAF anpassen
Die Sophos WAF blockierte verschiedene Meet-Anfragen mit HTTP 403 aufgrund von Form Hardening.
Ich musste entsprechende WAF-Ausnahmen für folgende URL-Pfade einrichten:
Zusätzlich habe ich auf der Sophos WebSocket-Passthrough für /colibri-ws/ aktiviert.
Die nginx-Konfiguration lässt sich mit folgendem Befehl kontrollieren:
nginx -T 2>/dev/null | grep -n -B 5 -A 10 'location.*colibri-ws'
Bei mir wird /colibri-ws/ über nginx an die lokale Videobridge auf Port 9090 weitergeleitet. Die entsprechenden WebSocket-Upgrade-Header sind dabei ebenfalls konfiguriert.
Die Ausnahmen sollten möglichst gezielt auf die notwendigen Pfade und Sicherheitsprüfungen beschränkt bleiben.
5. NAT-Konfiguration korrigieren
Ein weiteres Problem war die ausgehende NAT-Konfiguration.
Meine Appliance verwendete ausgehend eine andere öffentliche IP-Adresse als diejenige, unter der die Videobridge von aussen erreichbar sein sollte.
Ich habe deshalb auf der Sophos die entsprechende ausgehende SNAT-Regel korrigiert, damit die Appliance über die gewünschte öffentliche IP-Adresse ins Internet kommuniziert.
Ausserdem muss der Medienport UDP 10000 von aussen auf die interne IP-Adresse der Videobridge weitergeleitet und durch die Firewall erlaubt werden.
Wichtig: Dieser UDP-Medienverkehr wird nicht über die HTTPS-WAF abgewickelt. Dafür benötigt es eine entsprechende Firewall-/DNAT-Konfiguration.
6. Meet-Setup mit der korrekten öffentlichen IP erneut ausführen
Nach der NAT-Korrektur habe ich das Meet-Setup nochmals ausgeführt und dabei die öffentliche IP-Adresse explizit angegeben:
JVB_PUBLIC_ADDRESS=203.0.113.10 grommunio-meet-setup mail.domain.ch
203.0.113.10 ist hier nur eine Beispieladresse und muss durch die eigene öffentliche IP ersetzt werden.
Die NAT-Zuordnung kann anschliessend kontrolliert werden:
cat /etc/jitsi/videobridge/sip-communicator.properties
Dort sollten sinngemäss folgende Einträge stehen:
org.ice4j.ice.harvest.NAT_HARVESTER_LOCAL_ADDRESS=192.168.1.32
org.ice4j.ice.harvest.NAT_HARVESTER_PUBLIC_ADDRESS=203.0.113.10
Auch diese IP-Adressen sind Beispiele.
Hinweis: Da das Setup Konfigurationsdateien neu erzeugen beziehungsweise verändern kann, sollten danach die manuellen Anpassungen aus den Schritten 2 und 3 nochmals kontrolliert und bei Bedarf erneut vorgenommen werden.
7. Videobridge unbedingt neu starten!
Das war bei mir am Schluss der entscheidende Punkt. :-)
Obwohl die korrekte öffentliche IP-Adresse bereits in der Konfigurationsdatei hinterlegt war, veröffentlichte die Videobridge weiterhin die alte IP-Adresse als ICE-Kandidaten.
Erst nach einem erneuten Neustart funktionierte die Medienübertragung:
systemctl restart jitsi-videobridge
Anschliessend kann man den Dienststatus überprüfen:
systemctl status jitsi-videobridge
Die tatsächlich veröffentlichten öffentlichen ICE-Kandidaten lassen sich während eines Meetings beispielsweise so kontrollieren:
journalctl -u jitsi-videobridge \
--since "5 minutes ago" --no-pager |
grep -oE "type='srflx' ip='[0-9.]+'" |
sort -u
Wenn die entsprechenden Meldungen protokolliert werden, sollte die korrekte öffentliche IP-Adresse erscheinen.
Wichtig: Nur weil die richtige IP-Adresse in sip-communicator.properties steht, muss sie nicht zwingend bereits vom laufenden JVB-Prozess verwendet werden. Nach Änderungen an NAT oder JVB-Konfiguration deshalb unbedingt die Videobridge neu starten und die tatsächlich veröffentlichten ICE-Kandidaten kontrollieren.
8. Medienübertragung testen
Bei mir funktionierten zunächst Meetings mit zwei Teilnehmern problemlos. Sobald ein dritter Teilnehmer beitrat, gab es jedoch weder Bild noch Ton.
Der Grund für dieses unterschiedliche Verhalten: Bei zwei Teilnehmern kann Jitsi die Medien direkt über P2P übertragen. Bei drei oder mehr Teilnehmern wird normalerweise die Videobridge verwendet.
Durch das Deaktivieren von P2P auf den Testgeräten konnte ich das Problem gezielt eingrenzen.
Den Medienverkehr der Videobridge kann man während eines laufenden Meetings mit folgendem Befehl kontrollieren:
curl -fsS -H 'Accept: application/json' \
http://127.0.0.1:8081/metrics |
jq '{
current_endpoints,
ice_succeeded_total,
ice_failed_total,
endpoints_sending_video,
incoming_bitrate,
outgoing_bitrate
}'
Die ICE-Zähler sind kumulativ. Relevant ist deshalb insbesondere, wie sich die Werte während des Verbindungsaufbaus verändern.
Wenn die Kameras eingeschaltet sind und die Videobridge tatsächlich verwendet wird, sollte normalerweise ein- und ausgehender Medienverkehr erkennbar sein.
Fazit
Bei mir waren letztlich mehrere Korrekturen notwendig:
- Öffentlichen Hostnamen beim Meet-Setup verwenden
- Falsche Hostnamen in
config.js korrigieren
- Nicht ersetzte
${FQDN}-Platzhalter in jvb.conf korrigieren
- WAF-Ausnahmen und WebSocket-Passthrough konfigurieren
- Ausgehende SNAT-Regel sowie UDP-10000-Erreichbarkeit sicherstellen
- Meet-Setup mit expliziter öffentlicher IP erneut ausführen
- Videobridge nach der NAT-Korrektur nochmals neu starten
Einen eigenen coturn-Server musste ich dafür nicht installieren. Das grommunio-Meet-Setup hat den zentralen TURN-Dienst turn.grommun.io konfiguriert.
Ich hoffe, diese Hinweise helfen bei vergleichbaren Problemen. Die aktuelle grommunio-Dokumentation enthält ebenfalls hilfreiche Informationen zur Konfiguration und Fehlersuche:
https://docs.grommunio.com/guides/meet/