Mit der SIP-Debug-Seite siehst du alle ein- und ausgehenden SIP-Nachrichten
direkt in der Web-Oberfläche – ohne SSH, ohne Asterisk-CLI, ohne externe Tools wie
sngrep oder Wireshark.
Funktionen
- Toggle Capture – Aufzeichnung per Schalter ein- und ausschalten
- Call-Liste – Alle SIP-Dialoge nach Call-ID gruppiert mit Zeitstempel, Absender, Empfänger und SIP-Methode
- SIP-Timeline – Klick auf einen Call zeigt alle Nachrichten chronologisch
- Richtungspfeile – → Gesendet (blau) und ← Empfangen (grün)
- Farbcodierung – Methoden blau, 2xx-Antworten grün, 4xx/5xx rot, 1xx gelb
- Expandierbarer Roh-SIP-Text – Voller SIP-Header und Body als Monospace-Block
- Auto-Refresh – Aktualisiert sich alle 10 Sekunden bei aktivem Capture
Screenshots
SIP-Nachrichten nach Call-ID gruppiert mit expandierbarem Roh-SIP-Text
Wie funktioniert es technisch?
SIP Debug nutzt Asterisks eingebautes res_pjsip_history-Modul.
Beim Aktivieren wird die SIP-History in Asterisk eingeschaltet.
Das Backend pollt alle 3 Sekunden über den AMI (Asterisk Manager Interface)
nach neuen Einträgen und lädt für jeden neuen Eintrag den vollständigen SIP-Text.
Die Nachrichten werden im Arbeitsspeicher gehalten – keine Datenbank, keine Logdateien:
- Max. 2 Stunden Aufbewahrung – ältere Nachrichten werden automatisch gelöscht
- Hard-Cap: 10.000 Nachrichten – verhindert Speicherüberlauf bei hohem Traffic
- Kein Festplatten-I/O – alles im RAM, kein Performance-Impact auf die Anlage
Typische Anwendungsfälle
| Problem | Was prüfen? |
|---|---|
| Trunk registriert sich nicht | REGISTER → 401/403 Antworten, Credentials prüfen |
| Eingehender Anruf klingelt nicht | INVITE → 100 Trying / 180 Ringing Sequenz |
| Audio nur in eine Richtung | SDP-Body im INVITE/200 OK (Media-Adressen, NAT) |
| Falsche Caller-ID | From-Header und P-Asserted-Identity im ausgehenden INVITE |
| Anruf bricht nach 30s ab | Fehlende ACK oder Session-Timer-Header |
Zugriff
Die SIP-Debug-Seite ist über die Navigation im GonoPBX-Webinterface erreichbar (Bug-Icon zwischen FAQ und Einstellungen). Sie ist nur für Admins sichtbar – Benutzer mit der Rolle „User“ sehen den Menüpunkt nicht.
Verfügbar ab Version 1.7.0.
Update über Einstellungen → Server → Update oder manuell mit
git pull && docker compose up -d --build.