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
- Die Seite. Öffne
https://chat.example.comauf 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. - 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/wsden Status 101 haben. So behebst du es. - 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.
- 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).
- 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
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Die Seite lädt nicht | DNS, 443 nicht weitergeleitet, Zertifikat | Korrigiere 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 durch | WebSockets einschalten |
| 403 bei der Anmeldung oder bei jeder Anfrage | PUBLIC_URL passt nicht zur Adresse im Browser | Setze PUBLIC_URL genau auf diese Adresse, docker compose up -d |
| Alle teilen sich ein Rate-Limit oder werden gemeinsam ausgesperrt | Die App sieht die Adresse des Proxys statt die der Besucher | Trag die Adresse, die Status > Reverse proxy nennt, in TRUSTED_PROXY_CIDRS ein |
| Geht im LAN, nicht von außen | UDP 50000–50050 nicht weitergeleitet, Host-Firewall, falsche mitgeteilte Adresse | Leite den ganzen Bereich weiter, öffne die Host-Firewall, prüfe webrtc announce |
| Geht von außen, nicht im LAN | Der Router hat kein NAT-Loopback | Setze WEBRTC_LAN_IP auf die LAN-Adresse des Servers (Details) |
| Von außen verbindet sich nie jemand, obwohl Ports weitergeleitet sind | CGNAT oder DS-Lite: keine öffentliche IPv4 | Prüf deinen Anschluss; zieh auf einen VPS um |
| Verbindet sich, bricht nach Sekunden ab | Falsche mitgeteilte Adresse oder nur ein Teil des Bereichs weitergeleitet | Prüfe webrtc announce; leite den ganzen Bereich weiter |
| Eine Person kommt nicht rein, die anderen schon | Ihr Netz blockiert UDP | Leite 3479 über UDP und TCP weiter; probier ein anderes Netz |
| Ein Port bleibt zu, obwohl weitergeleitet | Host-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 announcebeim Start zeigt die öffentliche IP, die der Server den Browsern nennt. Steht dort nur eine172.x- oder10.x-Adresse, ist die Erkennung fehlgeschlagen: SetzeWEBRTC_NAT_1TO1_IP.sfu ice connectederscheint, wenn der Medienpfad eines Mitglieds steht;remote_typerelayheißt, dass das Mitglied über das TURN-Relay hereingekommen ist.sfu ice failedund eine Zeilewebrtc client diagmit"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.