Die Asterisk(R) Open Source PBX

By Mark Spencer <[email protected]> and the Asterisk.org developer community.
Copyright (C) 2001-2025 Sangoma Technologies Corporation and other copyright holders.

SICHERHEIT

Es ist unbedingt erforderlich, dass Sie den Inhalt des Dokuments mit den Sicherheitsinformationen lesen und vollständig verstehen, bevor Sie versuchen, einen Asterisk-Server zu konfigurieren und zu betreiben.

Weitere Informationen finden Sie unter Wichtige Sicherheitshinweise.

WAS IST ASTERISK ?

Asterisk ist eine Open-Source-PBX und ein Telefonie-Toolkit. Es ist gewissermaßen Middleware zwischen Internet- und Telefoniekanälen auf der unteren Ebene und Internet- und Telefonieanwendungen auf der oberen Ebene. Allerdings unterstützt Asterisk mehr Telefonie-Schnittstellen als nur Internet-Telefonie. Asterisk bietet außerdem eine umfangreiche Unterstützung für herkömmliche PSTN-Telefonie.

Weitere Informationen zum Projekt selbst finden Sie auf der Asterisk-Homepage und in der offiziellen Asterisk-Dokumentation.

UNTERSTÜTZTE BETRIEBSSYSTEME

Linux

Die Asterisk-Open-Source-PBX wird in erster Linie auf dem Betriebssystem GNU/Linux entwickelt und getestet und wird auf allen wichtigen GNU/Linux-Distributionen unterstützt.

Andere

Asterisk wurde außerdem 'portiert' und läuft Berichten zufolge auch auf anderen Betriebssystemen ordnungsgemäß, darunter Apples Mac OS X und die BSD-Varianten.

ERSTE SCHRITTE

Die meisten Benutzer nutzen heutzutage ausschließlich VoIP/SIP, aber wenn Sie eine Anbindung an TDM- oder analoge Dienste oder Geräte benötigen, stellen Sie sicher, dass Sie unterstützte Hardware besitzen.

Unterstützte Telefonie-Hardware umfasst:

• Alle analogen und digitalen Interface-Karten von Sangoma
• Jede Voll-Duplex-Soundkarte, die von PortAudio unterstützt wird
• Die Xorcom-Astribank-Kanalbank

UPGRADE VON EINER FRÜHEREN VERSION

Wenn Sie von einer früheren Version von Asterisk aktualisieren, lesen Sie unbedingt die Änderungsprotokolle.

Änderungsprotokolle

NEUE INSTALLATIONEN

Stellen Sie sicher, dass Ihr System einen kompatiblen Compiler und Entwicklungsbibliotheken enthält. Asterisk benötigt entweder die GNU Compiler Collection (GCC) Version 4.1 oder höher oder einen Compiler, der die C99-Spezifikation und einige der GCC-Spracherweiterungen unterstützt. Darüber hinaus muss Ihr System über die Header der C-Bibliothek sowie die Header und Bibliotheken für ncurses verfügen.

Es gibt viele Module, die zusätzliche Abhängigkeiten haben. Um zu sehen, nach welchen Bibliotheken gesucht wird, schauen Sie in ./configure --help, oder führen Sie make menuselect aus, um die Abhängigkeiten für bestimmte Module anzuzeigen.

Auf vielen Distributionen werden diese Abhängigkeiten durch Pakete mit Namen wie 'glibc-devel', 'ncurses-devel', 'openssl-devel' und 'zlib-devel' oder ähnliche installiert. Das Skript contrib/scripts/install_prereq kann verwendet werden, um die Abhängigkeiten für die meisten Debian- und Redhat-basierten Linux-Distributionen zu installieren. Das Skript unterstützt auch SUSE, Arch, Gentoo, FreeBSD, NetBSD und OpenBSD, aber diese Distributionen haben möglicherweise keine vollständige Unterstützung oder sie sind möglicherweise veraltet.

Also, legen wir los:

1. Lesen Sie die Dokumentation.
   Die Website Asterisk-Dokumentation enthält vollständige Informationen zum Erstellen, Installieren, Konfigurieren und Betreiben von Asterisk.

2. Führen Sie ./configure aus
   Führen Sie das Configure-Skript aus, um Werte für systemabhängige Variablen zu ermitteln, die während der Kompilierung verwendet werden. Wenn das Skript meldet, dass einige erforderliche Komponenten fehlen, können Sie ./contrib/scripts/install_prereq install ausführen, um die erforderlichen Komponenten zu installieren. Beachten Sie, dass dadurch alle Abhängigkeiten für jede Funktion von Asterisk installiert werden. Nach der Ausführung des Skripts müssen Sie ./configure erneut ausführen.

3. Führen Sie make menuselect aus
   Dies ist erforderlich, wenn Sie die Module auswählen möchten, die kompiliert werden, und die Abhängigkeiten für verschiedene optionale Module überprüfen möchten.

4. Führen Sie make aus
   Vorausgesetzt, die Kompilierung wird erfolgreich abgeschlossen:

5. Führen Sie make install aus
   Wenn Sie zum ersten Mal mit Asterisk arbeiten, möchten Sie möglicherweise die Beispiel-PBX mit Demonstrations-Nebenstellen usw. installieren. Falls ja, führen Sie Folgendes aus:

6. Führen Sie make samples aus
   Dadurch werden alle vorhandenen Konfigurationsdateien überschrieben, die Sie installiert haben.

7. Schließlich können Sie Asterisk im Vordergrundmodus (nicht als Daemon) mit asterisk -vvvc starten
   Sie werden eine Menge ausführlicher Meldungen über Ihren Bildschirm fliegen sehen, während Asterisk initialisiert (das ist der "sehr, sehr ausführliche" Modus). Wenn es fertig ist und Sie das "c" angegeben haben, erhalten Sie eine Kommandozeilenkonsole, die so aussieht:
   *CLI>
   Sie können jederzeit core show help eingeben, um Hilfe zum System zu erhalten. Für Hilfe zu einem bestimmten Befehl geben Sie core show help <command> ein.

man asterisk an der Unix/Linux-Eingabeaufforderung liefert Ihnen detaillierte Informationen zum Starten und Stoppen von Asterisk sowie alle Befehlszeilenoptionen zum Starten von Asterisk.

ÜBER KONFIGURATIONSDATEIEN

Alle Asterisk-Konfigurationsdateien haben ein gemeinsames Format. Kommentare werden durch ; begrenzt (da # natürlich als DTMF-Ziffer an vielen Stellen vorkommen kann). Eine Konfigurationsdatei ist in Abschnitte unterteilt, deren Namen in [] erscheinen. Jeder Abschnitt enthält typischerweise Anweisungen in der Form variable = value, obwohl Sie in älteren Beispielen auch variable => value sehen können.

BESONDERER HINWEIS ZUR ZEIT

Benutzer von SIP-Telefonen sollten sich darüber im Klaren sein, dass Asterisk empfindlich auf große Zeitsprünge reagiert. Das manuelle Ändern der Systemzeit mit date(1) (oder anderen ähnlichen Befehlen) kann dazu führen, dass SIP-Registrierungen und andere interne Prozesse fehlschlagen. Aus diesem Grund sollten Sie immer ein Zeitsynchronisationspaket verwenden, um Ihre Systemzeit genau zu halten. Alle Betriebssysteme/Distributionen stellen eines oder mehrere der folgenden Pakete bereit:

• ntpd/ntpsec
• chronyd
• systemd-timesyncd

Stellen Sie sicher, dass Sie eines (und nur eines) davon installieren und konfigurieren.

DATEIDESKRIPTOREN

Abhängig von der Größe Ihres Systems und Ihrer Konfiguration kann Asterisk eine große Anzahl von Dateideskriptoren verbrauchen. In UNIX werden Dateideskriptoren nicht nur für Dateien auf der Festplatte verwendet. Dateideskriptoren werden auch für die Netzwerkkommunikation (z. B. SIP-, IAX2- oder H.323-Anrufe) und den Hardwarezugriff (z. B. analoge und digitale Amtsleitungs-Hardware) verwendet. Asterisk greift für alles, von Konfigurationsinformationen bis zur Voicemail-Speicherung, auf viele Dateien auf der Festplatte zu.

Die meisten Systeme begrenzen die Anzahl der Dateideskriptoren, die Asterisk gleichzeitig geöffnet haben kann. Dies kann die Anzahl der gleichzeitigen Anrufe begrenzen, die Ihr System verarbeiten kann. Wenn das Limit beispielsweise auf 1024 gesetzt ist (ein üblicher Standardwert), kann Asterisk etwa 150 SIP-Anrufe gleichzeitig verarbeiten. Um die Anzahl der Dateideskriptoren zu ändern, befolgen Sie die folgenden Anweisungen für Ihr System:

PAM-BASIERTES LINUX-SYSTEM

Wenn Ihr System PAM (Pluggable Authentication Modules) verwendet, bearbeiten Sie /etc/security/limits.conf. Fügen Sie diese Zeilen am Ende der Datei hinzu:

root            soft    nofile          4096
root            hard    nofile          8196
asterisk        soft    nofile          4096
asterisk        hard    nofile          8196

(passen Sie die Zahlen nach Belieben an). Möglicherweise müssen Sie das System neu starten, damit diese Änderungen wirksam werden.

ALLGEMEINES UNIX-SYSTEM

Wenn es oben keine speziell auf Ihr System zugeschnittenen Anweisungen gibt, können Sie versuchen, den Befehl ulimit -n 8192 zum Skript hinzuzufügen, das Asterisk startet.

WEITERE INFORMATIONEN

Besuchen Sie die Website Asterisk-Dokumentation für weitere Dokumentation zu verschiedenen Funktionen und lesen Sie bitte alle Konfigurationsbeispiele, die Dokumentation zu den Konfigurationsoptionen enthalten.

Schließlich möchten Sie vielleicht den Asterisk-Community-Foren beitreten.

Willkommen in der weltweit wachsenden Community der Asterisk-Benutzer!

        Mark Spencer, and the Asterisk.org development community

Asterisk ist eine Marke der Sangoma Technologies Corporation

[Sangoma] [Homepage] [Support] [Dokumentation] [Community-Foren] [Versionshinweise] [Sicherheit] [Mailinglisten-Archiv]