Asterisk einrichten: eine Telefonanlage aus Textdateien

Asterisk ist die bekannteste Open-Source-Telefonanlage. Oberflächen wie FreePBX setzen auf Asterisk auf und schreiben dessen Konfiguration. Wer Asterisk direkt über Textdateien einrichtet, versteht dagegen, was bei einem Anruf wirklich passiert: Wer meldet sich an, wohin wird gewählt, welche Regel greift. Dieser Beitrag baut eine minimale Anlage mit zwei Nebenstellen auf. Die folgenden Beiträge der Reihe ergänzen Telefonbuch, Voicemail, Rufgruppe und deutsche Ansagen.

Begriffe

BegriffBedeutung
SIPSignalisierung: anmelden, klingeln, abnehmen, auflegen. Standardport UDP 5060.
RTPDie eigentliche Sprache, in einem eigenen Portbereich (bei Asterisk standardmäßig UDP 10000–20000).
PJSIPDer SIP-Treiber in aktuellen Asterisk-Versionen (pjsip.conf). Der alte Treiber chan_sip ist entfernt.
Endpoint / AOR / AuthEin Telefon in pjsip.conf: Einstellungen, Anmeldeadresse und Zugangsdaten.
Wählplan (Dialplan)Regeln in extensions.conf: Was passiert, wenn eine Nummer gewählt wird?
KontextEin benannter Abschnitt im Wählplan. Ein Telefon darf nur wählen, was in seinem Kontext steht.

Installation auf Debian

Debian liefert Asterisk seit einigen Versionen nicht mehr in den offiziellen Paketquellen aus. Der übliche Weg ist das Kompilieren der aktuellen LTS-Version aus dem Quellcode. Auf einer kleinen VM dauert das etwa 15–30 Minuten.

apt update && apt install -y build-essential wget
cd /usr/src
wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-22-current.tar.gz
tar -xzf asterisk-22-current.tar.gz
cd asterisk-22.*/
contrib/scripts/install_prereq install     # benötigte Bibliotheken
./configure --with-jansson-bundled
make menuselect                            # optional: Module und Sprachpakete wählen
make -j"$(nproc)"
make install
make config                                # Dienst einrichten
make install-logrotate

Asterisk sollte nicht als root laufen:

adduser --system --group --home /var/lib/asterisk --no-create-home asterisk
chown -R asterisk:asterisk /etc/asterisk /var/lib/asterisk /var/log/asterisk /var/spool/asterisk /var/run/asterisk
# in /etc/asterisk/asterisk.conf:  runuser = asterisk  und  rungroup = asterisk
systemctl enable --now asterisk
asterisk -rvvv                             # Konsole der laufenden Anlage

Zwei Nebenstellen anlegen (pjsip.conf)

Statt der umfangreichen Beispieldateien reicht eine schlanke /etc/asterisk/pjsip.conf. Wiederholte Einstellungen stehen in einer Vorlage ((!)), von der jede Nebenstelle erbt:

[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0:5060

; ---- Vorlagen ----
[telefon](!)
type=endpoint
context=intern
disallow=all
allow=alaw,ulaw
direct_media=no
rtp_symmetric=yes
rewrite_contact=yes
force_rport=yes

[aor-vorlage](!)
type=aor
max_contacts=1
remove_existing=yes
qualify_frequency=60

; ---- Nebenstelle 201 ----
[201](telefon)
auth=201-auth
aors=201
callerid=Empfang <201>
[201-auth]
type=auth
auth_type=userpass
username=201
password=HIER_LANGES_ZUFALLSPASSWORT
[201](aor-vorlage)

; ---- Nebenstelle 202 ----
[202](telefon)
auth=202-auth
aors=202
callerid=Buero <202>
[202-auth]
type=auth
auth_type=userpass
username=202
password=HIER_LANGES_ZUFALLSPASSWORT
[202](aor-vorlage)

Gute Passwörter erzeugt openssl rand -hex 16. SIP-Konten mit schwachen Passwörtern gehören zu den häufigsten Zielen im Internet, weil Angreifer damit teure Auslandsgespräche führen.

Der erste Wählplan (extensions.conf)

[intern]
; Nebenstellen 200-299 untereinander anrufen
exten => _2XX,1,NoOp(Anruf von ${CALLERID(num)} an ${EXTEN})
 same => n,Dial(PJSIP/${EXTEN},20)
 same => n,Hangup()

; Echo-Test: eigene Stimme hören (Latenz, Sprachqualität)
exten => 600,1,Answer()
 same => n,Echo()
 same => n,Hangup()
TeilBedeutung
_2XXMuster: _ leitet es ein, X steht für eine Ziffer 0–9. Passt auf 200–299.
1, nPriorität: erster Schritt, dann jeweils der nächste
${EXTEN}Die gewählte Nummer
Dial(PJSIP/201,20)Lässt 201 bis zu 20 Sekunden klingeln

Laden und prüfen

Nach Änderungen muss Asterisk nicht neu gestartet werden. Neu laden genügt, und laufende Gespräche bleiben bestehen:

asterisk -rx "module reload res_pjsip.so"   # nach Änderungen an pjsip.conf
asterisk -rx "dialplan reload"              # nach Änderungen an extensions.conf
asterisk -rx "pjsip show endpoints"         # alle Nebenstellen
asterisk -rx "pjsip show contacts"          # wer ist angemeldet? (Avail)
asterisk -rx "dialplan show intern"         # geladener Wählplan

Für den ersten Test eignet sich ein Softphone wie Linphone: SIP-Server ist die Adresse der Anlage (im Beispiel 192.0.2.10), Benutzer 201, Transport UDP. Ein zweites Softphone oder ein Tischtelefon als 202 anmelden und gegenseitig anrufen.

Fehlersuche

asterisk -rvvv
pjsip set logger on        # SIP-Nachrichten live mitlesen
pjsip set logger off
SymptomUrsache
401 Unauthorized, danach 200 OKKein Fehler: So läuft die Digest-Anmeldung immer ab.
Dauerhaft 401 / 403Benutzer oder Passwort falsch
Es klingelt, aber kein TonRTP kommt nicht durch: Firewall (UDP 10000–20000) oder NAT, siehe rtp_symmetric/direct_media
Nur 30 Sekunden Gespräch, dann AbbruchTypisch für NAT-Probleme, die Bestätigung erreicht ihr Ziel nicht

Nicht ins Internet stellen. Port 5060 offen ins Internet zieht innerhalb von Minuten automatisierte Anmeldeversuche an. Eine interne Anlage bleibt intern. Für Zugriffe von außen gehören VPN, Firewall-Regeln und fail2ban dazu.

pjsip.conf sagt, wer telefonieren darf, extensions.conf, was beim Wählen passiert. Alles Weitere sind Erweiterungen dieser beiden Dateien.