asterisk/asteriskLe dépôt officiel du projet Asterisk.
By Mark Spencer <[email protected]> and the Asterisk.org developer community.
Copyright (C) 2001-2025 Sangoma Technologies Corporation and other copyright holders.
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.
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.
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.
Asterisk a également été « porté » et fonctionnerait correctement sur d'autres systèmes d'exploitation, notamment Apple Mac OS X et les variantes BSD.
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 :
Si vous effectuez une mise à jour depuis une version précédente d'Asterisk, assurez-vous de lire les Journaux des modifications.
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 :
Lisez la documentation.
Le site web Documentation Asterisk contient toutes les
informations pour construire, installer, configurer et exécuter Asterisk.
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.
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.
Exécutez make
En supposant que la construction se termine avec succès :
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 :
Exécutez make samples
Cela écrasera tous les fichiers de configuration existants que vous avez installés.
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 :
Vous pouvez taper à tout moment pour obtenir de l'aide sur le système. Pour de l'aide
sur une commande spécifique, tapez .
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.
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.
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 :
Assurez-vous d'en installer et configurer un (et un seul).
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 :
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.
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.
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]
*CLI>core show helpcore show help <commande>