IllyVoIP-PJSIP-Trunk in FreePBX einrichten
FreePBX-Trunk konfigurieren, ausgehende Testroute beschränken und eingehende Anrufe an richtige Nebenstellen oder Gruppen senden.
Diese Anleitung gilt für FreePBX 17 mit PJSIP. Modulversionen können Bezeichnungen ändern; verwenden Sie die Felder Ihrer Version. Kopieren Sie keine alte chan_sip-Peerdefinition oder Registrierungszeichenfolge in PJSIP. Dies ist ein Trunk zu IllyVoIP, keine Nebenstelle für ein Tischtelefon.
Vorbereitung
Diese Anleitung verwendet eine IllyVoIP-Leitung mit Passwortauthentifizierung. Unter SIP Lines finden Sie SIP-Benutzername, SIP-Passwort, Server, Zielport und Transport. Verwenden Sie nicht Portal-E-Mail oder -Passwort. Ändern Sie eine bestehende IP-Authentifizierung erst nach Prüfung abhängiger Geräte.
Sie benötigen Administratorzugriff, eine private Konfigurationssicherung und eine funktionierende interne Nebenstelle zum Testen. Eine IllyVoIP-SIP-Leitung verbindet die Anlage mit IllyVoIP; eine Nebenstelle verbindet ein Mitarbeitertelefon mit der Anlage. Das sind unterschiedliche Konten.

Beginnen Sie mit einer Testnebenstelle und einem kontrollierten Ziel. Stellen Sie nicht sofort das gesamte Büro um. Bei laufendem Betrieb behalten Sie die bisherige Route bis zum erfolgreichen Test.
1. PJSIP-Trunk hinzufügen
Unter Connectivity → Trunks fügen Sie einen SIP/PJSIP-Trunk mit klarem Namen wie IllyVoIP hinzu. Tragen Sie die Leitungsdaten in PJSIP ein. Für Passwortregistrierung wählen Sie ausgehende Authentifizierung und send registration, soweit angeboten. Nutzen Sie kein IP-/Ohne-Registrierung-Rezept für eine Passwortleitung.
| Feld | Einzutragender Wert |
|---|---|
| Username / Auth Username | SIP-Benutzer und Authentifizierungsidentität der Leitung |
| Secret | SIP-Passwort |
| SIP Server / SIP Server Port | Vorgegebener Server und Zielport |
| Transport | Passender konfigurierter PJSIP-Transport |
| Context | Externe eingehende Behandlung, normalerweise from-trunk, nicht from-internal |
| Codecs | Nur beiderseits unterstützte Codecs; auch Medienverschlüsselung passend halten |
Speichern Sie das Formular und verwenden Sie Apply Config. Auf einer bestehenden Anlage im üblichen Änderungsfenster und mit Sicherung. Bearbeiten Sie generierte PJSIP-Dateien nicht manuell; spätere GUI-Änderungen überschreiben sie.
2. Kleine ausgehende Testroute
Öffnen Sie Connectivity → Outbound Routes, erstellen Sie eine klar benannte Testroute und wählen Sie IllyVoIP in der Trunkreihenfolge. Beginnen Sie mit dem Testziel, dann benötigten Mustern. Prüfen Sie die Reihenfolge: Eine früher passende Route kann einen anderen Trunk verwenden und den neuen scheinbar ignorieren.
Prüfen Sie jede Ziffernumwandlung. Entfernen Sie bei lokaler Amtskennziffer nur diese, nicht die Landesvorwahl. Bei schon internationalen Nummern fügen Sie nicht erneut dieselbe Landesvorwahl hinzu. Notieren Sie gewählt/gesendet und vergleichen Sie den Anrufdatensatz.
3. Zugriff auf die Route beschränken
Nutzen Sie verfügbare Nebenstellen-/Routenrechte. Manche Funktionen hängen von Modulen ab; der Name Test macht eine Route nicht privat. Externe Eingänge dürfen nicht in from-internal gelangen, wo interne Funktionen und Ausgangsrouten erreichbar sind. Caller-ID-Muster ersetzen keine Absicherung der Anrufquelle.
4. Eingehende Route hinzufügen
Routen Sie die aktive IllyVoIP-Nummer an die Trunk-SIP-Leitung. Unter Connectivity → Inbound Routes matchen Sie die tatsächlich eintreffende Zielkennung und wählen Nebenstelle oder Rufgruppe. DID und eingehende CallerID sind andere Filter: angerufene Nummer gegenüber Anrufer.
Keine uneingeschränkte Sammelregel als dauerhafte Lösung für unbekanntes Nummernformat. Funktioniert nur eine Nummer, vergleichen Sie empfangene Kennungen und Portalziele. Verschieben Sie nicht alle Nummern zum Test eines Trunks.
5. Fehlerphase eingrenzen
- Trunk nicht registriert: Daten, Authentifizierungs-/Registrierungsrichtung und Server/Transport prüfen.
- Registriert, aber ungenutzt: Ausgangsmuster, Umwandlungen, Rechte und Routenreihenfolge prüfen.
- Anruf kommt an, klingelt aber nicht: DID-Match und Nebenstellenstatus prüfen.
- Verbunden, aber einseitiges Audio: Netzwerk und Medien prüfen, nicht nur Registrierungspasswort.
Hat der Administrator CLI-Zugriff, ist pjsip show registrations eine hilfreiche reine Leseprüfung. FreePBX-CDR und Portalbericht zeigen die verwendete Route. Spielen Sie wegen einer fehlerhaften Route keine alte Gesamtsicherung über fremde neue Änderungen ein.
Audio, Rufnummernanzeige und Sicherheit
SIP-Transport und Medienverschlüsselung sind getrennt. Stimmen Sie den Audiomodus mit der Anlage ab; RTP, SDES-SRTP und DTLS-SRTP sind nicht austauschbar. Ändern Sie Transport, Codecs und Netzwerk nicht gleichzeitig, sonst verlieren Sie den Zusammenhang von Änderung und Ergebnis.
Verwenden Sie nur eine vom Konto erlaubte ausgehende Rufnummer. Eine im PBX eingegebene Nummer ist nicht verifiziert. Anonymer Eingang darf keine öffentlichen Ausgangsrouten erreichen; deaktivieren Sie keine Firewall. Erfragen Sie aktuelle zulässige Quellen beim Support, statt IP-Freigaben zu raten.
Abnahme vor Mitarbeiternutzung
- Trunkregistrierung getrennt von der Nebenstellenregistrierung prüfen.
- Von der Testnebenstelle anrufen und verwendeten Trunk prüfen. Erst Guthaben und Preise prüfen; der Test kann kostenpflichtig sein.
- Audio in beide Richtungen und angezeigte Nummer prüfen. Ziffern an einem zulässig genutzten Telefonmenü testen.
- Für eingehende Anrufe eine aktive IllyVoIP-Nummer an die SIP-Leitung routen, extern anrufen und internes Ziel prüfen.
- Bestätigen Sie, dass eine unberechtigte Nebenstelle die Route nicht nutzen kann. Erst dann Mitarbeitendenzugriff erweitern.
Notieren Sie Zeit, Zeitzone, Nebenstelle, Route und öffentliche Anrufreferenz. Bei Fehlern senden Sie dies und PBX-Modell/Version an den Support. Die SIP-Code-Anleitung hilft bei der Beschreibung. Keine Passwörter oder unbereinigten Logs öffentlich posten.
Diese Anleitung beruht auf offiziellen Dokumenten und Portalabläufen, nicht auf echten Anruftests jeder PBX-Version. Notrufe und Spezialgeräte benötigen separate Konfiguration und Prüfung.