ACLClouds
ACLClouds

Comment installer FreePBX 17 sur un VPS Debian 12 ?

Installer FreePBX 17 et Asterisk avec le script officiel, ouvrir les ports SIP et RTP, régler le NAT, créer un poste et un trunk SIP, puis protéger le

FreePBX est une interface web libre pour Asterisk, le logiciel de standard téléphonique (IPBX). Installé sur un VPS, il gère les postes de l’équipe, les lignes SIP de l’opérateur, la messagerie vocale, les files d’attente et les horaires d’ouverture, sans matériel sur place. La version 17 s’installe avec un script officiel de Sangoma, qui ne prend en charge que Debian 12.

Procédure étape par étape

  1. Préparer un VPS sous Debian 12

    Choisissez Debian 12 à la commande, ou réinstallez le VPS sur ce système : le script attend une installation propre, sans serveur web ni base de données déjà en place. Connectez-vous ensuite en SSH en root.

  2. Mettre à jour et nommer la machine

    Lancez apt update && apt upgrade -y, puis redémarrez si un nouveau noyau a été installé. Donnez au VPS un nom complet (FQDN) comme pbx.example.com avec hostnamectl set-hostname et une ligne dans /etc/hosts : le script s’arrête si hostname -f ne renvoie rien.

  3. Lancer le script officiel

    Téléchargez sng_freepbx_debian_install.sh depuis le dépôt GitHub FreePBX/sng_freepbx_debian_install et exécutez-le avec bash. Il installe Asterisk 22, FreePBX, Apache, PHP 8.2, MariaDB, Fail2ban et les modules de base ; comptez 15 à 30 minutes. Le journal détaillé est écrit dans /var/log/pbx/.

  4. Créer le compte administrateur

    Ouvrez http://VPS_IP/ dans le navigateur. FreePBX demande un nom d’utilisateur, un mot de passe et une adresse e-mail pour les notifications. L’activation auprès de Sangoma est facultative : elle sert aux modules commerciaux.

  5. Ouvrir les ports SIP et RTP

    Dans le « Pare-feu » du panel ACLClouds, autorisez 5060/UDP pour la signalisation SIP et la plage 10000-20000/UDP pour la voix (RTP). Limitez 80 et 443/TCP, l’interface d’administration, à votre adresse IP.

  6. Régler le NAT et créer un poste

    Dans « Settings » > « Asterisk SIP Settings », cliquez sur « Detect Network Settings » pour renseigner l’adresse externe et les réseaux locaux. Créez ensuite un poste PJSIP dans « Applications » > « Extensions », configurez-le sur un softphone, puis cliquez sur « Apply Config ».

Nommer la machine et installer FreePBX 17

apt update && apt upgrade -y
hostnamectl set-hostname pbx.example.com
echo "127.0.1.1 pbx.example.com pbx" >> /etc/hosts
hostname -f
wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh
bash /tmp/sng_freepbx_debian_install.sh

Commandes utiles après l’installation

fwconsole restart
fwconsole reload
fwconsole ma upgradeall
fwconsole chown
asterisk -rvvv

Dans la console Asterisk

pjsip show endpoints
pjsip show registrations
core show channels

Avant de commencer

Un standard FreePBX demande peu de ressources pour une petite équipe : la charge vient surtout du nombre d’appels simultanés, de l’enregistrement des conversations et du transcodage entre codecs. Il vous faut aussi un trunk SIP, c’est-à-dire une ligne fournie par un opérateur de téléphonie sur IP, pour appeler l’extérieur et recevoir les appels de vos numéros.

  • Debian 12 (bookworm) est le seul système accepté par le script de FreePBX 17 ; il refuse Debian 13 et bloque cette mise à niveau.
  • Le VPS doit garder la même adresse IP : l’opérateur et les téléphones s’y réfèrent.
  • Par défaut, le script installe aussi les modules commerciaux de Sangoma, dont System Admin et Firewall ; l’option --opensourceonly les retire, module Firewall compris.

Ajouter un trunk SIP

Dans « Connectivity » > « Trunks », ajoutez un trunk PJSIP avec les informations de l’opérateur : serveur SIP, identifiant, mot de passe et, selon l’offre, enregistrement ou authentification par adresse IP. Créez ensuite une route entrante (« Inbound Routes ») par numéro et une route sortante (« Outbound Routes ») avec les formats de numéros autorisés.

Si l’opérateur authentifie par adresse IP, donnez-lui l’IPv4 du VPS et n’ouvrez 5060/UDP qu’à ses adresses dans le pare-feu.

Protéger le standard

Un port SIP public reçoit des tentatives de connexion automatiques dans les heures qui suivent sa mise en ligne. Le risque principal est la fraude : des appels vers des numéros surtaxés ou internationaux passés par un poste piraté, et facturés sur votre compte opérateur.

  • Gardez Fail2ban, installé par le script : il bannit les adresses après plusieurs échecs d’authentification SIP.
  • Donnez à chaque poste un secret long et aléatoire, jamais le numéro du poste.
  • Refusez les appels anonymes : réglez « Allow Anonymous Inbound SIP Calls » et « Allow SIP Guests » sur « No » dans « Asterisk SIP Settings ».
  • Limitez les routes sortantes aux destinations utiles et demandez à l’opérateur un plafond de dépense ou un blocage des numéros surtaxés et internationaux.

Erreurs courantes et solutions

La plupart des problèmes de voix viennent du NAT ou des ports RTP. pjsip show endpoints et le journal /var/log/asterisk/full donnent la cause la plupart du temps.

  • Appel établi mais sans son, ou son dans un seul sens : la plage 10000-20000/UDP est fermée, ou l’adresse externe est vide dans « Asterisk SIP Settings ». Corrigez, puis cliquez sur « Apply Config ».
  • Le poste ne s’enregistre pas et reçoit 401 Unauthorized : identifiant ou secret faux. S’il ne reçoit plus aucune réponse après plusieurs essais, son adresse a été bannie par Fail2ban.
  • Le script s’arrête avec Unsupported OS version : le système n’est pas Debian 12. Réinstallez le VPS sur Debian 12 et relancez-le.
  • Le script s’arrête sur Fully qualified domain name (FQDN) is not set correctly : donnez un nom complet à la machine avec hostnamectl et /etc/hosts.
  • L’interface affiche une page blanche ou une erreur après une mise à jour : lancez fwconsole chown, puis fwconsole restart.

Quel VPS pour FreePBX ?

Chez ACLClouds, au 17 novembre 2026, le VPS Mini (2 vCPU, 8 Go de RAM, 40 Go de stockage) coûte 4,99 € par mois sans engagement, ou 3,99 € par mois avec un engagement d’un an : assez pour le standard d’une petite entreprise et ses messageries vocales. Le VPS Essentiel (4 vCPU, 16 Go de RAM, 80 Go), à 9,99 € par mois, laisse de la marge pour enregistrer les appels et tenir de nombreuses communications simultanées. Le réseau va jusqu’à 1 Gbit/s ; un appel en G.711 consomme environ 90 kbit/s dans chaque sens.

Vérification rapide

  • http://VPS_IP/ affiche la connexion FreePBX.
  • pjsip show endpoints montre le poste disponible.
  • Un appel entre deux postes passe avec le son dans les deux sens.
  • Le trunk apparaît comme enregistré dans pjsip show registrations.
  • L’interface d’administration n’est joignable que depuis vos adresses.

Questions fréquentes

FreePBX est-il gratuit ?

Oui. FreePBX et Asterisk sont des logiciels libres, sans licence par poste. Seuls certains modules commerciaux de Sangoma sont payants, comme EndPoint Manager ; un standard complet fonctionne sans eux. Les appels vers l’extérieur sont facturés par votre opérateur SIP.

Peut-on installer FreePBX 17 sur Debian 13 ou Ubuntu ?

Pas avec le script officiel, qui s’arrête sur tout autre système que Debian 12. Une installation manuelle reste possible, mais Sangoma ne la prend pas en charge : pour un standard en production, choisissez Debian 12.

Faut-il un certificat HTTPS pour l’interface ?

C’est recommandé dès que vous ouvrez l’interface ou l’accès des utilisateurs (UCP) depuis Internet. Faites pointer un nom de domaine vers le VPS et demandez un certificat Let’s Encrypt ; le module « Certificate Management » de FreePBX sait aussi le faire et le renouveler.

Combien d’appels simultanés un petit VPS supporte-t-il ?

Sans transcodage ni enregistrement, quelques dizaines d’appels tiennent sur 2 vCPU : Asterisk relaie surtout des paquets. Le transcodage (par exemple G.722 vers G.729) et l’enregistrement de chaque appel augmentent nettement la charge CPU et disque. Mesurez avec core show channels aux heures de pointe avant d’ajouter des postes.