asterisk/asteriskLe dépôt officiel du projet Asterisk.
# 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é](https://docs.asterisk.org/Deployment/Important-Security-Considerations) 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](https://www.asterisk.org) et la [Documentation officielle d'Asterisk](https://docs.asterisk.org). ## 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. <!-- CHANGELOGS (the URL will change based on the location of this README) --> [Journaux des modifications](https://downloads.asterisk.org/pub/telephony/asterisk) <!-- END-CHANGELOGS --> ### 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.<br> Le site web [Documentation Asterisk](https://docs.asterisk.org) contient toutes les informations pour construire, installer, configurer et exécuter Asterisk. 2. Exécutez `./configure`<br> 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`<br> 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`<br> En supposant que la construction se termine avec succès : 5. Exécutez `make install`<br> 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`<br> 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`<br> 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 :<br> `*CLI>`<br> 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 : ```text 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](https://docs.asterisk.org) 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](https://community.asterisk.org) 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](https://www.sangoma.com/)\] \[[Page d'accueil](https://www.asterisk.org)\] \[[Support](https://www.asterisk.org/support)\] \[[Documentation](https://docs.asterisk.org)\] \[[Forums communautaires](https://community.asterisk.org)\] \[[Notes de version](https://github.com/asterisk/asterisk/releases)\] \[[Sécurité](https://docs.asterisk.org/Deployment/Important-Security-Considerations/)\] \[[Archives de la liste de diffusion](https://lists.digium.com)\]
