Asterisk est un PBX open source : il gère la téléphonie IP (SIP), les extensions, les files d'appel, les messageries vocales et les conférences. Ce guide installe Asterisk depuis les sources sur un VPS Linux, le seul type d'hébergement où vous avez l'accès root nécessaire à la compilation et à l'ouverture des ports audio.
Prérequis et choix de l'hébergement
Un PBX est léger tant que le nombre d'appels simultanés reste modeste, mais il est sensible à la latence et à la gigue du réseau. Un VPS Linux avec une IP publique fixe convient bien. Si vous préférez une distribution précise, regardez le VPS Ubuntu. Les commandes ci-dessous ciblent Debian et Ubuntu.
Ce qu'il vous faut :
- un VPS Linux à jour, avec un accès SSH par clé (voir sécuriser SSH) ;
- un utilisateur disposant de
sudo; - de l'espace disque pour la compilation (quelques centaines de Mo) ;
- un opérateur SIP (trunk) si vous voulez joindre le réseau téléphonique public.
Les serveurs de jeu (FiveM, Minecraft…) se gèrent depuis Pterodactyl, sans root : ils ne conviennent pas pour Asterisk.
Choisir la version d'Asterisk
La documentation officielle distingue deux types de versions : les LTS, qui reçoivent des correctifs pendant quatre ans puis des correctifs de sécurité pendant un an, et les versions standard, avec un an de correctifs puis un an de sécurité seule.
| Branche | Type | Publication | Fin de vie |
|---|---|---|---|
| 22 | LTS | 16 octobre 2024 | 16 octobre 2029 |
| 23 | Standard | 15 octobre 2025 | 15 octobre 2027 |
Pour un PBX de production, retenez Asterisk 22. Notez aussi que chan_sip a disparu depuis Asterisk 21 : seul PJSIP (chan_pjsip) existe dans les versions récentes. Vérifiez les dates sur la page officielle des versions avant de vous engager.
Installer les dépendances
Mettez le système à jour et installez les outils de compilation :
sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential wget curl subversion
Télécharger les sources
Asterisk publie, pour chaque branche, un lien « current » vers la dernière version. Utilisez un dossier de travail dédié :
mkdir -p ~/src/asterisk && cd ~/src/asterisk
wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-22-current.tar.gz
tar xzf asterisk-22-current.tar.gz
cd asterisk-22.*/
Le script fourni dans l'archive installe les paquets requis pour votre distribution :
sudo contrib/scripts/install_prereq install
Il peut aussi récupérer les sources de PJSIP lors de la configuration : c'est normal, Asterisk embarque sa propre copie de cette bibliothèque.
Configurer et compiler
./configure
make menuselect
menuselect ouvre une interface en mode texte où vous cochez les modules à compiler. Les choix par défaut conviennent pour démarrer. Sur certaines machines virtuelles, désactivez l'option BUILD_NATIVE pour éviter que le binaire dépende d'instructions CPU spécifiques, ce qui peut poser problème si vous migrez ensuite vers un autre hôte :
menuselect/menuselect --disable BUILD_NATIVE menuselect.makeopts
Compilez ensuite, en parallélisant sur les cœurs disponibles, puis installez :
make -j"$(nproc)"
sudo make install
sudo make samples
sudo ldconfig
Attention : make samples installe des fichiers d'exemple dans /etc/asterisk/ et écrase les fichiers existants. Ne l'exécutez qu'à la première installation, jamais lors d'une mise à jour.
Créer un utilisateur dédié
Ne faites pas tourner un PBX exposé à Internet en root. Créez un compte système sans shell et donnez-lui les répertoires d'Asterisk :
sudo groupadd --system asterisk
sudo useradd --system -g asterisk -d /var/lib/asterisk -s /usr/sbin/nologin asterisk
sudo chown -R asterisk:asterisk /etc/asterisk /var/lib/asterisk /var/log/asterisk /var/spool/asterisk /var/run/asterisk 2>/dev/null
sudo chmod -R 750 /etc/asterisk
Si un répertoire n'existe pas chez vous, la redirection d'erreur évite que la commande s'arrête. Contrôlez avec ls -ld /var/*/asterisk.
Lancer Asterisk avec systemd
Créez l'unité /etc/systemd/system/asterisk.service. Le principe est identique à celui décrit dans notre guide sur la création d'un service systemd :
[Unit]
Description=Asterisk PBX
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=/usr/sbin/asterisk -f -U asterisk -G asterisk
ExecReload=/usr/sbin/asterisk -rx "core reload"
Restart=on-failure
RestartSec=5
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
Vérifiez le chemin du binaire avec which asterisk, puis activez le service :
sudo systemctl daemon-reload
sudo systemctl enable --now asterisk
sudo systemctl status asterisk
Le raccourci make config installe aussi un script de démarrage, mais une unité systemd explicite reste plus lisible et plus facile à diagnostiquer avec journalctl.
Se connecter à la console Asterisk
Le processus tourne en arrière-plan, la console s'y rattache :
sudo asterisk -rvvv
Quelques commandes utiles : core show version, core reload, pjsip show endpoints, pjsip show transports. Pour quitter, tapez exit : cela ne coupe pas le service.
Configurer un premier poste SIP avec PJSIP
PJSIP sépare plusieurs objets : transport, endpoint, authentification et adresse d'enregistrement (AOR). Voici une configuration minimale. Sauvegardez d'abord l'exemple installé, puis remplacez le contenu de /etc/asterisk/pjsip.conf :
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0:5060
[1001]
type=endpoint
context=interne
disallow=all
allow=ulaw,alaw
auth=auth1001
aors=1001
[auth1001]
type=auth
auth_type=userpass
username=1001
password=UN_MOT_DE_PASSE_LONG_ET_UNIQUE
[1001]
type=aor
max_contacts=1
Ajoutez ensuite un plan de numérotation minimal dans /etc/asterisk/extensions.conf :
[interne]
exten => 1001,1,Dial(PJSIP/1001,20)
exten => 1001,n,Hangup()
exten => 600,1,Answer()
exten => 600,n,Playback(demo-congrats)
exten => 600,n,Hangup()
Rechargez : sudo asterisk -rx "core reload". Configurez un softphone avec l'adresse IP du VPS, l'identifiant 1001 et le mot de passe choisi. Si le poste s'enregistre, pjsip show endpoints affiche un contact. L'extension 600 sert de test audio.
Derrière un NAT (cas fréquent côté poste), ajoutez les paramètres de transport et d'endpoint adaptés (external_media_address, external_signaling_address, rtp_symmetric, force_rport) en vous référant à la documentation PJSIP d'Asterisk.
Régler la plage RTP
La signalisation SIP et l'audio RTP empruntent des ports différents. La plage RTP se définit dans /etc/asterisk/rtp.conf :
[general]
rtpstart=10000
rtpend=10100
Une centaine de ports suffit pour un petit PBX, puisqu'un appel consomme généralement deux ports (RTP et RTCP). Plus la plage est étroite, plus votre pare-feu est précis.
Ouvrir les ports avec un pare-feu
Autorisez SSH d'abord, sinon vous vous coupez l'accès. Avec UFW (détails dans ouvrir des ports avec UFW) :
sudo ufw allow 22/tcp
sudo ufw allow from ADRESSE_OPERATEUR to any port 5060 proto udp
sudo ufw allow 10000:10100/udp
sudo ufw enable
Remplacez ADRESSE_OPERATEUR par l'IP de votre trunk, ou par celle de votre bureau pour des postes fixes. Si vos utilisateurs sont mobiles, vous devrez ouvrir 5060 plus largement : compensez par des mots de passe robustes et du bannissement automatique.
Sécuriser le PBX
Un PBX SIP exposé est scanné en permanence : les bots essaient des identifiants courants pour passer des appels surtaxés. Quelques règles de base :
- Mots de passe longs et aléatoires pour chaque extension, jamais identiques à l'identifiant.
- Contexte restreint : un endpoint ne doit pouvoir appeler que ce que son contexte autorise. Aucun appel sortant sans authentification.
- Aucun accès anonyme : ne créez pas d'endpoint acceptant les appels de n'importe quelle IP, sauf cas maîtrisé.
- Bannissement : Fail2ban sait lire les journaux Asterisk et bloquer les IP qui échouent à s'authentifier.
- Mises à jour : suivez les avis de sécurité de votre branche et recompilez régulièrement.
Pour aller plus loin, lisez notre guide dédié : sécuriser FreeSWITCH et Asterisk sur un VPS. L'actualité montre aussi que les piles VoIP sont une cible réelle : voir la faille SIP de FreeSWITCH.
Journaux et diagnostic
Les messages d'Asterisk se trouvent dans /var/log/asterisk/, selon logger.conf. En cas d'échec d'enregistrement :
- activez le débogage SIP avec
pjsip set logger ondans la console ; - vérifiez que le port est bien en écoute :
ss -lunp | grep 5060; - testez la route réseau depuis le poste avec
nc -zuv IP 5060(le test UDP reste indicatif) ; - contrôlez le pare-feu et la plage RTP en cas d'audio à sens unique ou de silence.
Maintenance et sauvegardes
Pour passer à une nouvelle version de la même branche : téléchargez l'archive, relancez ./configure, vérifiez vos modules dans make menuselect, compilez, puis sudo make install et sudo systemctl restart asterisk. N'exécutez pas make samples à cette occasion.
Sauvegardez /etc/asterisk (configuration) et /var/lib/asterisk (base interne, sons), ainsi que /var/spool/asterisk si vous utilisez la messagerie vocale. Les sauvegardes sont une option ElypseCloud : prévoyez de toute façon une copie externe, par exemple avec rsync vers un serveur distant.
En résumé
Installer Asterisk tient en quelques étapes : choisir une LTS, compiler, créer un utilisateur dédié, lancer un service systemd, configurer PJSIP, puis verrouiller le pare-feu. La partie la plus importante reste la sécurité, car un PBX ouvert sur Internet attire vite les tentatives de fraude. Pour démarrer sur une base saine, un VPS Linux avec accès root suffit.
FiveM
Minecraft
Rust
RedM
Hytale