Fehlersuche

Sprache hängt an der Seite, die Seite am Proxy, und jede Schicht kann in Ordnung aussehen, während die darüber kaputt ist. Geh die Leiter der Reihe nach hoch und halte bei der ersten Sprosse an, die nicht geht. Teste nie nur aus deinem eigenen Netz.

Der Container startet nicht

Zeigt docker compose ps, dass die App ständig neu startet, lies das Log:

docker compose logs app

Eine fehlende oder noch als Platzhalter stehende Pflichteinstellung wird auf einmal gemeldet, unter Mnema Talk cannot start - fix these settings in .env:. Behebe jede aufgelistete Zeile und führ docker compose up -d aus. Vor einem Start gibt setup --check dieselbe Liste aus:

docker run --rm -v "$PWD:/out" ghcr.io/mnema-xyz/mnema-talk setup --check

Die Leiter

  1. Die Seite. Öffne https://chat.example.com auf einem Handy mit ausgeschaltetem WLAN. Kein Schloss und keine Anmeldeseite? Dann liegt es am DNS-Eintrag, an der Weiterleitung von 443 oder am Zertifikat. Vom Rechner aus: curl -I https://chat.example.com.
  2. Live-Updates. Melde dich an. „Connection lost – reconnecting…“ heißt, dass der Proxy den WebSocket nicht durchlässt: In den Entwicklertools (F12 > Network, Filter „WS“) muss /api/ws den Status 101 haben. So behebst du es.
  3. Admin > Status. Warte nach einem Start etwa zwanzig Sekunden. Jeder gelbe oder rote Punkt sagt, was du ändern musst. Grün beweist nicht, dass dein Router UDP weiterleitet; das kann der Server von innen nicht testen.
  4. Test my connection. In Admin > Status, geöffnet auf einem Handy im Mobilfunknetz: Direktes UDP klappt, nur das Relay klappt (Gespräche gehen, aber behebe die UDP-Weiterleitung) oder nichts klappt (prüfe Router, Firewall und CGNAT).
  5. Ein echtes Gespräch zwischen zwei Netzen. Ein Rechner im WLAN und ein Handy im Mobilfunknetz treten einem Talk bei. Ton in beide Richtungen innerhalb von etwa zwei Sekunden.

Symptome, Ursachen, Lösungen

SymptomWahrscheinliche UrsacheLösung
Die Seite lädt nichtDNS, 443 nicht weitergeleitet, ZertifikatKorrigiere den A-Eintrag, leite 443 und 80 weiter, prüfe das Zertifikat
Seite lädt, Chat tot, „Connection lost“Der Proxy lässt WebSockets nicht durchWebSockets einschalten
403 bei der Anmeldung oder bei jeder AnfragePUBLIC_URL passt nicht zur Adresse im BrowserSetze PUBLIC_URL genau auf diese Adresse, docker compose up -d
Alle teilen sich ein Rate-Limit oder werden gemeinsam ausgesperrtDie App sieht die Adresse des Proxys statt die der BesucherTrag die Adresse, die Status > Reverse proxy nennt, in TRUSTED_PROXY_CIDRS ein
Geht im LAN, nicht von außenUDP 50000–50050 nicht weitergeleitet, Host-Firewall, falsche mitgeteilte AdresseLeite den ganzen Bereich weiter, öffne die Host-Firewall, prüfe webrtc announce
Geht von außen, nicht im LANDer Router hat kein NAT-LoopbackSetze WEBRTC_LAN_IP auf die LAN-Adresse des Servers (Details)
Von außen verbindet sich nie jemand, obwohl Ports weitergeleitet sindCGNAT oder DS-Lite: keine öffentliche IPv4Prüf deinen Anschluss; zieh auf einen VPS um
Verbindet sich, bricht nach Sekunden abFalsche mitgeteilte Adresse oder nur ein Teil des Bereichs weitergeleitetPrüfe webrtc announce; leite den ganzen Bereich weiter
Eine Person kommt nicht rein, die anderen schonIhr Netz blockiert UDPLeite 3479 über UDP und TCP weiter; probier ein anderes Netz
Ein Port bleibt zu, obwohl weitergeleitetHost-Firewall oder Cloud-Security-GroupÖffne ihn an beiden Stellen

Die Sprach-Logs

docker compose logs --since 10m app | grep -E 'webrtc announce|setup check|sfu ice|webrtc client diag'
  • webrtc announce beim Start zeigt die öffentliche IP, die der Server den Browsern nennt. Steht dort nur eine 172.x- oder 10.x-Adresse, ist die Erkennung fehlgeschlagen: Setze WEBRTC_NAT_1TO1_IP.
  • sfu ice connected erscheint, wenn der Medienpfad eines Mitglieds steht; remote_type relay heißt, dass das Mitglied über das TURN-Relay hereingekommen ist.
  • sfu ice failed und eine Zeile webrtc client diag mit "ice":"failed" heißen, dass Pakete dieses Mitglieds nicht ankommen.

Im Browser zeigt chrome://webrtc-internals (Firefox: about:webrtc), geöffnet bevor du beitrittst, das Kandidatenpaar, das die Medien trägt: relay heißt, das Relay trägt sie, srflx oder host heißt, direktes UDP klappt.

Das Relay von außen testen

scripts/turn-probe.py (nur Standardbibliothek) prüft aus einem anderen Netz, dass das Relay auf UDP und TCP antwortet. Kopiere es aus dem Repository und führe es außerhalb deines Netzes aus:

TURN_PROBE_HOST=chat.example.com python3 turn-probe.py

Es endet mit RESULT udp: PASS und RESULT tcp: PASS oder mit FAIL. FAIL nur bei einem Protokoll heißt, dass du nur das andere weitergeleitet hast.

Der Owner kommt nicht rein

Mehrere falsche Passwörter sperren eine Client-Adresse für eine Weile. Heb die Sperre vom Host aus auf, auch wenn sich niemand anmelden kann:

docker exec mnema-talk /usr/local/bin/mnema-talk unlock USERNAME

unlock --all entsperrt alle. Der Owner kann die Sperre eines Mitglieds auch unter Admin > Members aufheben. Ein verlorener Authenticator: mnema-talk reset-2fa OWNER_NAME, siehe Sicherheit und Härtung.

Immer noch hängen?

Lies die Anleitung zur Fehlersuche bei Sprache und die FAQ im Repository (beide auf Englisch), frag dann in den Discussions nach, mit der Ausgabe von mnema-talk doctor. Fehler gehören in die Issues.

Stimmt etwas auf dieser Seite nicht? Sag es uns.