Le PBX Open Source Asterisk(R)

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

SÉCURITÉ

Il est impératif que vous lisiez et compreniez parfaitement le contenu du document d'informations de sécurité avant de tenter de configurer et d'exécuter un serveur Asterisk.

Voir Considérations importantes de sécurité pour plus d'informations.

QU'EST-CE QU'ASTERISK ?

Asterisk est un PBX Open Source et une boîte à outils de téléphonie. C'est, en quelque sorte, un middleware entre les canaux Internet et de téléphonie en bas, et les applications Internet et de téléphonie en haut. Cependant, Asterisk prend en charge plus d'interfaces de téléphonie que la seule téléphonie Internet. Asterisk offre également un très large support pour la téléphonie PSTN traditionnelle.

Pour plus d'informations sur le projet lui-même, veuillez visiter la Page d'accueil d'Asterisk et la Documentation officielle d'Asterisk.

SYSTÈMES D'EXPLOITATION SUPPORTÉS

Linux

Le PBX Open Source Asterisk est développé et testé principalement sur le système d'exploitation GNU/Linux, et est supporté sur chaque distribution GNU/Linux majeure.

Autres

Asterisk a également été « porté » et fonctionnerait correctement sur d'autres systèmes d'exploitation, notamment Apple Mac OS X et les variantes BSD.

POUR COMMENCER

La plupart des utilisateurs utilisent aujourd'hui exclusivement la VoIP/SIP, mais si vous devez vous interfacer avec des services ou périphériques TDM ou analogiques, assurez-vous de disposer d'un matériel supporté.

Le matériel de téléphonie supporté comprend :

• Toutes les cartes d'interface analogiques et numériques de Sangoma
• Toute carte son full duplex supportée par PortAudio
• Le banc de canaux Xorcom Astribank

MISE À JOUR DEPUIS UNE VERSION ANTÉRIEURE

Si vous effectuez une mise à jour depuis une version précédente d'Asterisk, assurez-vous de lire les Journaux des modifications.

Journaux des modifications

NOUVELLES INSTALLATIONS

Assurez-vous que votre système contient un compilateur compatible et des bibliothèques de développement. Asterisk nécessite soit la GNU Compiler Collection (GCC) version 4.1 ou supérieure, soit un compilateur supportant la spécification C99 et certaines extensions du langage gcc. De plus, votre système doit avoir les en-têtes de la bibliothèque C disponibles, ainsi que les en-têtes et bibliothèques pour ncurses.

De nombreux modules ont des dépendances supplémentaires. Pour voir quelles bibliothèques sont recherchées, consultez ./configure --help, ou exécutez make menuselect pour afficher les dépendances pour des modules spécifiques.

Sur de nombreuses distributions, ces dépendances sont installées par des paquets nommés 'glibc-devel', 'ncurses-devel', 'openssl-devel' et 'zlib-devel' ou similaires. Le script contrib/scripts/install_prereq peut être utilisé pour installer les dépendances pour la plupart des distributions Linux basées sur Debian et Redhat. Le script gère également SUSE, Arch, Gentoo, FreeBSD, NetBSD et OpenBSD mais ces distributions pourraient ne pas avoir un support complet ou être obsolètes.

Passons donc à l'action :

1. Lisez la documentation.
   Le site web Documentation Asterisk contient toutes les informations pour construire, installer, configurer et exécuter Asterisk.

2. Exécutez ./configure
   Exécutez le script de configuration pour deviner les valeurs des variables dépendantes du système utilisées pendant la compilation. Si le script indique que certains composants requis sont manquants, vous pouvez exécuter ./contrib/scripts/install_prereq install pour installer les composants nécessaires. Notez que cela installera toutes les dépendances pour chaque fonctionnalité d'Asterisk. Après avoir exécuté le script, vous devrez relancer ./configure.

3. Exécutez make menuselect
   Ceci est nécessaire si vous souhaitez sélectionner les modules qui seront compilés et vérifier les dépendances pour divers modules optionnels.

4. Exécutez make
   En supposant que la construction se termine avec succès :

5. Exécutez make install
   Si c'est votre première expérience avec Asterisk, vous souhaiterez peut-être installer l'exemple de PBX, avec des extensions de démonstration, etc. Dans ce cas, exécutez :

6. Exécutez make samples
   Cela écrasera tous les fichiers de configuration existants que vous avez installés.

7. Enfin, vous pouvez lancer Asterisk en mode avant-plan (pas un démon) avec asterisk -vvvc
   Vous verrez un tas de messages verbeux défiler sur votre écran pendant qu'Asterisk s'initialise (c'est le mode « très très verbeux »). Quand il est prêt, si vous avez spécifié le « c », vous obtiendrez une console en ligne de commande, qui ressemble à ceci :
   *CLI>
   Vous pouvez taper core show help à tout moment pour obtenir de l'aide sur le système. Pour de l'aide sur une commande spécifique, tapez core show help <commande>.

man asterisk à l'invite de commande Unix/Linux vous donnera des informations détaillées sur la façon de démarrer et d'arrêter Asterisk, ainsi que toutes les options de ligne de commande pour démarrer Asterisk.

À PROPOS DES FICHIERS DE CONFIGURATION

Tous les fichiers de configuration d'Asterisk partagent un format commun. Les commentaires sont délimités par ; (car #, étant un chiffre DTMF, peut apparaître à de nombreux endroits). Un fichier de configuration est divisé en sections dont les noms apparaissent entre []. Chaque section contient généralement des déclarations sous la forme variable = valeur bien que vous puissiez voir variable => valeur dans des exemples plus anciens.

NOTE SPÉCIALE SUR LE TEMPS

Ceux qui utilisent des téléphones SIP doivent savoir qu'Asterisk est sensible aux grands sauts de temps. Modifier manuellement l'heure système avec date(1) (ou d'autres commandes similaires) peut entraîner l'échec des enregistrements SIP et d'autres processus internes. Pour cette raison, vous devez toujours utiliser un paquet de synchronisation temporelle pour maintenir l'heure système précise. Tous les OS/distributions proposent un ou plusieurs des paquets suivants :

• ntpd/ntpsec
• chronyd
• systemd-timesyncd

Assurez-vous d'en installer et configurer un (et un seul).

DESCRIPTEURS DE FICHIERS

Selon la taille de votre système et votre configuration, Asterisk peut consommer un grand nombre de descripteurs de fichiers. Sous UNIX, les descripteurs de fichiers sont utilisés pour plus que simplement les fichiers sur disque. Les descripteurs de fichiers sont également utilisés pour la gestion des communications réseau (par exemple, les appels SIP, IAX2 ou H.323) et l'accès au matériel (par exemple, le matériel de jonction analogique et numérique). Asterisk accède à de nombreux fichiers sur disque pour tout, des informations de configuration au stockage de la messagerie vocale.

La plupart des systèmes limitent le nombre de descripteurs de fichiers qu'Asterisk peut avoir ouverts à la fois. Cela peut limiter le nombre d'appels simultanés que votre système peut gérer. Par exemple, si la limite est fixée à 1024 (une valeur par défaut courante), Asterisk peut gérer environ 150 appels SIP simultanément. Pour modifier le nombre de descripteurs de fichiers, suivez les instructions correspondant à votre système ci-dessous :

SYSTÈME LINUX BASÉ SUR PAM

Si votre système utilise PAM (Pluggable Authentication Modules), modifiez /etc/security/limits.conf. Ajoutez ces lignes à la fin du fichier :

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

(ajustez les nombres selon vos besoins). Vous devrez peut-être redémarrer le système pour que ces modifications prennent effet.

SYSTÈME UNIX GÉNÉRIQUE

S'il n'y a pas d'instructions spécifiquement adaptées à votre système ci-dessus, vous pouvez essayer d'ajouter la commande ulimit -n 8192 au script qui démarre Asterisk.

PLUS D'INFORMATIONS

Visitez le site web Documentation Asterisk pour plus de documentation sur diverses fonctionnalités et veuillez lire tous les exemples de configuration qui incluent de la documentation sur les options de configuration.

Enfin, vous pouvez rejoindre les Forums communautaires Asterisk

Bienvenue dans la communauté mondiale grandissante des utilisateurs d'Asterisk !

        Mark Spencer, and the Asterisk.org development community

Asterisk est une marque déposée de Sangoma Technologies Corporation

[Sangoma] [Page d'accueil] [Support] [Documentation] [Forums communautaires] [Notes de version] [Sécurité] [Archives de la liste de diffusion]