Asterisk

Projet : Mettre en place un serveur VOIP Asterisk local sur ma machine Fedora 44 — extensions SIP, appels audio et vidéo.

Début / fin : 2026-09-02.


0. La configuration initiale

  • Hôte : Fedora 44, hostname Zelus, utilisateur sambasene, btrfs.

1. Phase 1 — Installer Asterisk (avec deux erreurs en cours de route)

Étape 1.1 — Mise à jour du système (✅)

sudo dnf update -y
  • 157 paquets mis à jour, kernel 7.0.12 → 7.1.12 (nécessite un redémarrage à appliquer plus tard).

Étape 1.2 — Première tentative d’installation : ❌ MAUVAIS noms de paquets

sudo dnf install -y asterisk asterisk-sounds asterisk-sounds-wav

Résultat :

Failed to resolve the transaction:
Package "asterisk-18.26.4-1.fc44.x86_64" is already installed.
No match for argument: asterisk-sounds
No match for argument: asterisk-sounds-wav
  • ✅ asterisk-18.26.4 était déjà installé.
  • ❌ Erreur : les noms des paquets de sons sous Fedora n’étaient pas asterisk-sounds / asterisk-sounds-wav.

Étape 1.3 — Correction : les bons noms de paquets de sons (✅)

J’ai cherché les vrais noms Fedora puis j’ai installé :

sudo dnf install -y asterisk-sounds-core-en-gsm asterisk-sounds-core-en-ulaw
  • Installation de asterisk-sounds-core-en / -en-gsm / -en-ulaw v1.6.1-22.fc44 (11 Mio, 20 s).

Étape 1.4 — Démarrer et activer le service (✅)

sudo systemctl enable --now asterisk
sudo systemctl status asterisk
  • Service actif (en cours d’exécution) depuis le 2026-09-02 10:18:31, PID 896.
  • Dernière ligne du journal : « Asterisk Ready. »

Étape 1.5 — Avertissements au démarrage : diagnostiqués comme inoffensifs (✅)

journalctl montrait plusieurs modules qui échouaient à se charger. Tous se sont avérés optionnels / non essentiels :

ModulePourquoi il a échouéUniquement nécessaire si…
res_ari_mailboxessymbole non définiAPI REST ARI de la messagerie vocale (ignorer)
res_prometheussymbole non définimétriques Prometheus (ignorer)
res_stir_shakendépendances non résoluesappelant STIR/SHAKEN pour les trunks (ignorer)
cdr_sysloga refuséCDR syslog (ignorer)
res_http_media_cachedépendances non résoluescache média HTTP (ignorer)
pjproject.confconfig manquanterien — PJSIP fonctionne avec les valeurs par défaut

Conclusion : Asterisk est pleinement fonctionnel pour un PBX de base.


2. Phase 2 — Configurer les extensions 1001 & 1002 + le plan de numérotation

Étape 2.1 — Rédaction d’un guide de configuration (la première config)

Asterisk - SIP Extension Setup :

  • Endpoints PJSIP 1001, 1002 avec des codecs audio uniquement (ulaw, alaw, gsm).
  • Plan de numérotation dans le contexte [internal] : 1001 ↔ 1002, plus le test d’écho 8500, plus la mise en attente 8.
  • Les configurations ont été effectuées dans /etc/asterisk/pjsip.conf et extensions.conf.

Les mots de passe provisoires StrongPass1001 / StrongPass1002 ont été remplacées par 246pass / 246test.)

Étape 2.2 — J’ai appliqué la config, puis le rechargement a échoué (❌ indice n°1)

J’ai exécuté les étapes de rechargement et collé le résultat :

sudo asterisk -rx "module reload chan_pjsip.so"
No such module 'chan_pjsip.so'
sudo asterisk -rx "dialplan reload"
Dialplan reloaded.
sudo asterisk -rx "pjsip show endpoints"
No such command 'pjsip show endpoints'
sudo asterisk -rx "pjsip show transports"
No such command 'pjsip show transports'
  • dialplan reload a fonctionné → les fichiers de configuration sont lisibles.
  • Mais chan_pjsip.so n’existe pas et il n’y a pas de commande pjsip show ....

Étape 2.3 — Diagnostic + CAUSE RACINE (❌→✅)

Vérification du pilote :

sudo asterisk -rx "module show like sip"
# seulement app_adsiprog.so -> ni chan_sip ni chan_pjsip
ls /usr/lib64/asterisk/modules/ | grep -iE "sip|pjsip"
# seulement app_adsiprog.so -> aucun pilote de canal SIP sur le disque

Cause racine trouvée : sous Fedora, les pilotes de canaux SIP sont des sous-paquets distincts d’asterisk. Le paquet de base installé plus tôt exclut le pilote de canal, si bien qu’Asterisk ne peut accepter aucun appel SIP tant qu’on n’en a pas ajouté un. Les deux options :

  • asterisk-sip — ancien chan_sip.so
  • asterisk-pjsip — moderne chan_pjsip.so + res_pjsip* (recommandé)

Étape 2.4 — Correction : installer le pilote PJSIP (✅)

sudo dnf install -y asterisk-pjsip
# Installing: asterisk-pjsip-18.26.4-1.fc44.x86_64 (2.1 MiB) Complete!
# >>> [RPM] /etc/asterisk/pjsip.conf created as /etc/asterisk/pjsip.conf.rpmnew
  • ⚠️ Remarque : le RPM a enregistré sa configuration par défaut sous pjsip.conf.rpmnew et a laissé mon pjsip.conf personnalisé intact donc mes modifications ont été préservées.
sudo systemctl restart asterisk

Après le redémarrage, 50 modules PJSIP chargés, dont chan_pjsip.so (Running, noyau) et res_pjsip.so (Running, noyau). Seul res_pjsip_stir_shaken n’était pas en cours d’exécution (optionnel).

Étape 2.5 — Vérification des endpoints (✅)

sudo asterisk -rx "pjsip show endpoints"
# Endpoint: 1001 ... Endpoint: 1002 ... Objects found: 2
  • Les deux 1001 et 1002 sont apparus. Le statut « Unavailable » était attendu — aucun softphone ne s’était encore enregistré.

3. Phase 3 — Premier appel réel + identification confirmée

Étape 3.1 — IP LAN et mots de passe extraits de la machine

  • IP LAN : 192.168.1.150 (adresse de serveur SIP pour les softphones = 192.168.1.150:5060, UDP).
  • Mots de passe depuis sudo grep -E "^password" /etc/asterisk/pjsip.conf :
    • 1001 → 246pass
    • 1002 → 246test

Étape 3.2 — Premier appel audio réussi (✅)

Mon téléphone Android a été enregistré après avoir installé Zoiper et Linphone avec l’utilisateur 1002 et il en est de meme pour l’autre téléphone Android que j’ai emprunté avec l’utilisateur 1001. Ensuite un appel audio a fonctionné. Le PBX était en service.

Étape 3.3 — Tentatives de client sur l’ordinateur portable (mélange ❌/✅)

  • Zoiper 5.6.15 → ✅ installé sur le bureau via le RPM officiel (sudo dnf install -y ./Zoiper5_5.6.15_x86_64.rpm après l’avoir téléchargé depuis leur site officiel Download Zoiper 5, a free VoIP softphone :: Zoiper
  • Linphone (COPR) → ❌ échec. Le COPR spot/linphone ne fournit que linphone-3.12.0 compilé pour Fedora 32, avec des bibliothèques manquantes (libmediastreamer_base.so.10, libGLEW.so.2.1, libvpx.so.6) sous Fedora 44. Le dépôt n’est plus maintenu.
  • Plus tard, j’ai téléchargé l’AppImage officielle de Linphone → elle s’est exécutée sur le bureau.

4. Phase 4 — La vidéo ne fonctionnait pas → cause racine → correction

Étape 4.1 — Symptôme (❌)

J’ai testé un appel vidéo et il a échoué.

Étape 4.2 — Cause racine trouvée (❌→💡)

Le pjsip.conf d’origine (issu du guide SIP Extension Setup) n’autorisait que des codecs audio (ulaw|alaw|gsm). Sans codec vidéo dans allow=, Asterisk négocie un SDP audio uniquement — la vidéo n’est donc jamais mise en place, même si les deux téléphones la prennent en charge.

Étape 4.3 — Correction conçue (une deuxième demande : ajouter aussi l’extension 1003)

J’ai mis dans Asterisk - Video Config + 1003 un pjsip.conf de remplacement qui :

  1. Ajoute des codecs vidéo (h264, vp8, vp9, h263) à chaque endpoint.
  2. Ajoute une troisième extension 1003 (password=246test3, provisoire — je devrai la changer).

J’ai fourni la configuration de remplacement complète, plus l’ajout au plan de numérotationa au niveau de [internal] :

exten => 1003,1,NoOp(Call to 1003)
    same => n,Dial(PJSIP/1003,30)
    same => n,Hangup()

Il y avait aussi des ajouts au niveau de [interne] mais je ne l’ai pas noté.

Étape 4.4 — Application partielle (❌ repéré à temps)

J’ai ouvert pjsip.conf et extensions.conf, puis redémarré et vérifié :

sudo systemctl restart asterisk
sudo asterisk -rx "pjsip show endpoints"
# Endpoint: 1001, 1002, 1003  -> 3 trouvés ✅
sudo asterisk -rx "dialplan show internal"
# 1001, 1002, 1003, 8, 8500 -> 5 extensions ✅
  • ✅ Les 3 endpoints existaient.
  • ✅ Le plan de numérotation contenait 1003.
  • ℹ️ J’avais ajouté 1003 dans les deux contextes [interne] et [internal]. Les endpoints utilisent [internal].

Mais je voyais encore quelque chose à vérifier : pjsip show endpoints n’affiche pas les codecs, j’ai regardé si les lignes allow= vidéo étaient bien présentes dans les sections 1001/1002 (elles ne pouvaient être que dans le bloc 1003 que j’avais collé).

Étape 4.5 — Vérification de l’endpoint 1001 : les codecs vidéo étaient MANQUANTS (❌ repéré à temps)

sudo asterisk -rx "pjsip show endpoint 1001"
# allow : (ulaw|alaw|gsm)             <-- AUCUN codec vidéo !
  • ❌ Confirmé : je n’avais ajouté que le bloc 1003 mais pas mis à jour 1001/1002 avec les codecs vidéo. La vidéo aurait quand même échoué.
  • ✅ Tout le reste de l’endpoint paraissait correct (direct_media=false, max_video_streams=1).

Étape 4.6 — Correction en ajoutant les codecs vidéo (✅)

J’ai ajouté, après allow=gsm dans chacun de [1001], [1002], [1003] :

allow=h264
allow=vp8
allow=vp9
allow=h263

Puis j’ai redémarré et vérifié à nouveau 1001 :

sudo asterisk -rx "pjsip show endpoint 1001"
# allow : (ulaw|alaw|gsm|h264|vp8|vp9|h263)   <-- vidéo désormais activée ✅

À ce moment, les contacts affichaient NonQual, ce qui est apparemment normal juste après un redémarrage jusqu’à ce que le ping de contrôle de 30 s se déclenche.

Étape 4.7 — Vérification que les TROIS endpoints ont les codecs vidéo (✅)

sudo asterisk -rx "pjsip show endpoint 1002"
sudo asterisk -rx "pjsip show endpoint 1003"

Les trois affichaient désormais :

allow : (ulaw|alaw|gsm|h264|vp8|vp9|h263)
  • ✅ 1002 avait un contact Avail (192.168.1.72, 13 ms).
  • ✅ 1003 avait un contact Avail depuis 192.168.1.150 (le Zoiper de l’ordinateur portable tournant sur Zelus lui-même, ~100 ms).
  • Tous les prérequis techniques pour la vidéo étaient réunis côté serveur.

5. Phase 5 — Vérification de la réalité du client de bureau & décision

Étape 5.1 — La vidéo de Zoiper est PAYANTE (❌ pour la vidéo gratuite)

J’ai découvert que l’appel vidéo de Zoiper est une fonctionnalité payante/premium (la version gratuite = audio uniquement). Donc Zoiper sur le bureau ne fera pas de vidéo gratuite.

Étape 5.2 — La tentative de connexion de Linphone a échoué (❌)

J’ai saisi les détails dans la page de connexion de Linphone et cela n’a pas connecté. Causes inconnue. Donc j’ai décidé de ne pas poursuivre. I give up!

Étape 5.3 — Dernier instantané d’enregistrement (depuis pjsip show contacts)

sudo asterisk -rx "pjsip show contacts"
# 1001 @ 192.168.1.80:52354  Avail  (17.6ms)
# 1002 @ 192.168.1.72:51277  Avail  (19.2ms)
# (aucun contact 1003 à ce stade — le softphone de l'ordinateur portable n'est pas enregistré)
  • Les contacts Unavail en double par endpoint ne sont que d’anciennes inscriptions expirées, donc inoffensives.

Étape 5.4 — Give up

J’ai just décidé d’en finir avec le bureau, que ça marche ou pas. Sachant que le serveur n’a besoin d’aucune modification pour qu’un futur client s’enregistre comme 1003 puisque c’est déjà configuré.


6. Statut final et identifiants (source de vérité unique)

Résultat : la configuration côté serveur d’Asterisk est TERMINÉE et FONCTIONNELLE.

ExtensionMot de passeAppareilÉtat
1001246passTéléphone @ 192.168.1.80✅
1002246testTéléphone @ 192.168.1.72✅
1003246blueOrdinateur (non configuré)non enregistré
  • Serveur / SIP : 192.168.1.150:5060, transport UDP.
  • Appels audio : ✅ fonctionnels.
  • Vidéo : ✅ activée côté serveur sur les 3 endpoints ; prête pour tout client qui fait de la vidéo.
  • Plan de numérotation : 1001, 1002, 1003, 8 (mise en attente), 8500 (test d’écho).

Il se peut que l’addresse du serveur change lors de la prochaine connexion puisque les addresse ip ne sont pas fixe.

Bloc de codecs d’endpoint (appliqué à 1001, 1002, 1003)

type=endpoint
context=internal
disallow=all
allow=ulaw
allow=alaw
allow=gsm
allow=h264
allow=vp8
allow=vp9
allow=h263
aors=<ext>
auth=<ext>-auth
direct_media=no

Travail optionnel / à venir

  • Confirmer la vidéo de bout en bout : enregistrer un client vidéo sur 1003 et appeler 1001 ou 1002.
  • Pare-feu / accès hors LAN : sudo firewall-cmd --permanent --add-service=sip --add-port=5060/udp --add-port=10000-20000/udp.
  • Redémarrer pour activer le kernel 7.1.12.

7. Leçons apprises

  1. Fedora découpe les fonctionnalités en sous-paquets. Le pilote SIP d’Asterisk n’est pas dans le paquet de base — installez asterisk-pjsip (ou asterisk-sip). Symptôme : pjsip show endpoints → No such command ; aucun module de canal sur le disque.
  2. Les noms des paquets de sons varient selon les distributions. asterisk-sounds / asterisk-sounds-wav n’existent pas sous Fedora ; utilisez asterisk-sounds-core-en-gsm / -en-ulaw.
  3. pjsip show endpoints n’affiche pas les codecs. Utilisez pjsip show endpoint <ext> et lisez la ligne allow.
  4. La vidéo nécessite des codecs sur le serveur. Si les appels sont audio uniquement, vérifiez que allow= contient un codec vidéo (h264/vp8/vp9/h263) ; sinon le SDP est audio uniquement.
  5. Les dépôts COPR peuvent être périmés/dangereux. Le COPR Linphone cible Fedora 32 ; utilisez l’AppImage officielle sous Fedora 44.
  6. La vidéo de Zoiper est une fonctionnalité payante. Pour une vidéo de bureau gratuite sous Linux, utilisez Linphone.
  7. Vérifiez les configurations appliquées partiellement. J’avais ajouté seulement le bloc 1003 la première fois — confirmez toujours que les endpoints préexistants ont été mis à jour.