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
| Begriff | Bedeutung |
| SIP | Signalisierung: anmelden, klingeln, abnehmen, auflegen. Standardport UDP 5060. |
| RTP | Die eigentliche Sprache, in einem eigenen Portbereich (bei Asterisk standardmäßig UDP 10000–20000). |
| PJSIP | Der SIP-Treiber in aktuellen Asterisk-Versionen (pjsip.conf). Der alte Treiber chan_sip ist entfernt. |
| Endpoint / AOR / Auth | Ein Telefon in pjsip.conf: Einstellungen, Anmeldeadresse und Zugangsdaten. |
| Wählplan (Dialplan) | Regeln in extensions.conf: Was passiert, wenn eine Nummer gewählt wird? |
| Kontext | Ein 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()
| Teil | Bedeutung |
_2XX | Muster: _ leitet es ein, X steht für eine Ziffer 0–9. Passt auf 200–299. |
1, n | Prioritä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
| Symptom | Ursache |
401 Unauthorized, danach 200 OK | Kein Fehler: So läuft die Digest-Anmeldung immer ab. |
Dauerhaft 401 / 403 | Benutzer oder Passwort falsch |
| Es klingelt, aber kein Ton | RTP kommt nicht durch: Firewall (UDP 10000–20000) oder NAT, siehe rtp_symmetric/direct_media |
| Nur 30 Sekunden Gespräch, dann Abbruch | Typisch 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.