SIP Debug – Live SIP-Nachrichten im Browser

Wer eine VoIP-Anlage betreibt, kennt das Problem: Ein Anruf klingelt nicht, die Caller-ID stimmt nicht, oder ein Trunk registriert sich nicht. Um die Ursache zu finden, musste man bisher per SSH auf den Server, sich an der Asterisk-CLI anmelden und pjsip set logger on eintippen. Das ist umständlich – besonders wenn man unterwegs ist oder schnell mal einem Kunden helfen will.

Ab GonoPBX v1.7.0 gibt es dafür eine eigene Seite: SIP Debug. Direkt in der Web-Oberfläche, ohne SSH, ohne CLI.

So funktioniert es

Auf der neuen SIP-Debug-Seite (erreichbar über die Navigation, nur für Admins) gibt es einen Toggle-Schalter. Aktiviert man das Capture, passiert im Hintergrund Folgendes:

• Asterisks res_pjsip_history-Modul wird aktiviert
• Alle ein- und ausgehenden SIP-Nachrichten werden erfasst
• Das Backend pollt alle 3 Sekunden nach neuen Einträgen
• Die Nachrichten werden nach Call-ID gruppiert und im Browser angezeigt

Was man sieht

Die Seite zeigt eine Call-Liste mit allen erfassten SIP-Dialogen. Jede Zeile zeigt:

• Zeitstempel – wann der Dialog begonnen hat
• Call-ID – gekürzt, mit Tooltip für die volle ID
• Von / Nach – extrahiert aus den From/To-Headern
• Methode – INVITE, REGISTER, OPTIONS, BYE etc.
• Anzahl Nachrichten – wie viele SIP-Messages zu diesem Call gehören

Klickt man auf einen Call, öffnet sich eine Timeline mit allen SIP-Nachrichten dieses Dialogs:

• Richtungspfeil: → gesendet (blau) / ← empfangen (grün)
• Methode oder Status-Code – farblich codiert (200 = grün, 4xx/5xx = rot, 1xx = gelb)
• CSeq-Header für die Zuordnung
• Expandierbar: Klick zeigt den vollen SIP-Text als Monospace-Block

Speicher und Sicherheit

• Nachrichten werden max. 2 Stunden im RAM gehalten – danach automatisch gelöscht
• Hard-Cap bei 10.000 Nachrichten als Sicherheitsgrenze
• Capture kann jederzeit per Toggle deaktiviert werden – Asterisks History wird dann gestoppt
• Die Seite ist nur für Admins sichtbar – normale Benutzer sehen den Menüpunkt nicht

Typische Anwendungsfälle

• Trunk registriert sich nicht? → REGISTER-Nachrichten prüfen, 401/403 Antworten analysieren
• Eingehender Anruf klingelt nicht? → INVITE + 100 Trying/180 Ringing Sequenz nachvollziehen
• Audio nur in eine Richtung? → SDP-Body im INVITE/200 OK prüfen (Media-Adressen, Codecs)
• Caller-ID stimmt nicht? → From-Header und P-Asserted-Identity im ausgehenden INVITE checken

Update installieren

Automatisch (empfohlen)

Im GonoPBX-Webinterface unter Einstellungen → Server → Update auf „Update installieren“ klicken.

Manuell

cd /root/asterisk-pbx-gui
git pull origin main
docker compose up -d --build

Die vollständigen Release Notes findest du auf der Release Notes-Seite oder direkt auf GitHub.