Come installare FreePBX 17 su un VPS Debian 12?
Installare FreePBX 17 e Asterisk con lo script ufficiale, aprire le porte SIP e RTP, regolare il NAT, creare un interno e un trunk SIP, poi proteggere il
FreePBX è un’interfaccia web libera per Asterisk, il software di centralino telefonico (IP PBX). Installato su un VPS, gestisce gli interni del team, le linee SIP dell’operatore, la segreteria, le code di chiamata e gli orari di apertura, senza hardware in sede. La versione 17 si installa con uno script ufficiale di Sangoma che supporta solo Debian 12.
Procedura passo passo
-
Preparare un VPS con Debian 12
Scegli Debian 12 all’ordine, oppure reinstalla il VPS con questo sistema: lo script si aspetta un’installazione pulita, senza server web né database già presenti. Poi connettiti in SSH come root.
-
Aggiornare e dare un nome alla macchina
Esegui apt update && apt upgrade -y, poi riavvia se è stato installato un nuovo kernel. Dai al VPS un nome completo (FQDN) come pbx.example.com con hostnamectl set-hostname e una riga in /etc/hosts: lo script si ferma se hostname -f non restituisce nulla.
-
Eseguire lo script ufficiale
Scarica sng_freepbx_debian_install.sh dal repository GitHub FreePBX/sng_freepbx_debian_install ed eseguilo con bash. Installa Asterisk 22, FreePBX, Apache, PHP 8.2, MariaDB, Fail2ban e i moduli di base; calcola da 15 a 30 minuti. Il log dettagliato viene scritto in /var/log/pbx/.
-
Creare l’account amministratore
Apri http://VPS_IP/ nel browser. FreePBX chiede un nome utente, una password e un indirizzo e-mail per le notifiche. L’attivazione presso Sangoma è facoltativa: serve per i moduli commerciali.
-
Aprire le porte SIP e RTP
Nel «Firewall» del pannello ACLClouds, autorizza 5060/UDP per la segnalazione SIP e l’intervallo 10000-20000/UDP per la voce (RTP). Limita 80 e 443/TCP, l’interfaccia di amministrazione, al tuo indirizzo IP.
-
Regolare il NAT e creare un interno
In «Settings» > «Asterisk SIP Settings», fai clic su «Detect Network Settings» per compilare l’indirizzo esterno e le reti locali. Poi crea un interno PJSIP in «Applications» > «Extensions», configuralo su un softphone e fai clic su «Apply Config».
Dare un nome alla macchina e installare 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
Comandi utili dopo l’installazione
fwconsole restart
fwconsole reload
fwconsole ma upgradeall
fwconsole chown
asterisk -rvvv
Nella console di Asterisk
pjsip show endpoints
pjsip show registrations
core show channels
Prima di iniziare
Un centralino FreePBX richiede poche risorse per un piccolo team: il carico dipende soprattutto dal numero di chiamate simultanee, dalla registrazione delle conversazioni e dalla transcodifica tra codec. Ti serve anche un trunk SIP, cioè una linea fornita da un operatore VoIP, per chiamare l’esterno e ricevere le chiamate sui tuoi numeri.
- Debian 12 (bookworm) è l’unico sistema accettato dallo script di FreePBX 17; rifiuta Debian 13 e blocca questo aggiornamento.
- Il VPS deve mantenere lo stesso indirizzo IP: l’operatore e i telefoni vi fanno riferimento.
- Per impostazione predefinita, lo script installa anche i moduli commerciali di Sangoma, tra cui System Admin e Firewall; l’opzione --opensourceonly li rimuove, modulo Firewall compreso.
Aggiungere un trunk SIP
In «Connectivity» > «Trunks», aggiungi un trunk PJSIP con i dati dell’operatore: server SIP, nome utente, password e, a seconda dell’offerta, registrazione o autenticazione tramite indirizzo IP. Poi crea una rotta in entrata («Inbound Routes») per numero e una rotta in uscita («Outbound Routes») con i formati di numero consentiti.
Se l’operatore autentica tramite indirizzo IP, comunicagli l’IPv4 del VPS e apri 5060/UDP nel firewall solo ai suoi indirizzi.
Proteggere il centralino
Una porta SIP pubblica riceve tentativi di connessione automatici nelle ore successive alla messa online. Il rischio principale è la frode: chiamate verso numeri a tariffa maggiorata o internazionali fatte da un interno violato e addebitate sul tuo conto operatore.
- Mantieni Fail2ban, installato dallo script: banna gli indirizzi dopo diversi tentativi di autenticazione SIP falliti.
- Dai a ogni interno una password lunga e casuale, mai il numero dell’interno.
- Rifiuta le chiamate anonime: imposta «Allow Anonymous Inbound SIP Calls» e «Allow SIP Guests» su «No» in «Asterisk SIP Settings».
- Limita le rotte in uscita alle destinazioni utili e chiedi all’operatore un tetto di spesa o il blocco dei numeri a tariffa maggiorata e internazionali.
Errori comuni e soluzioni
La maggior parte dei problemi audio deriva dal NAT o dalle porte RTP. pjsip show endpoints e il log /var/log/asterisk/full indicano la causa quasi sempre.
- Chiamata stabilita ma senza audio, o con audio in un solo senso: l’intervallo 10000-20000/UDP è chiuso o l’indirizzo esterno è vuoto in «Asterisk SIP Settings». Correggi, poi fai clic su «Apply Config».
- L’interno non si registra e riceve 401 Unauthorized: nome utente o password sbagliati. Se dopo diversi tentativi non riceve più alcuna risposta, il suo indirizzo è stato bannato da Fail2ban.
- Lo script si ferma con Unsupported OS version: il sistema non è Debian 12. Reinstalla il VPS con Debian 12 e rilancialo.
- Lo script si ferma su Fully qualified domain name (FQDN) is not set correctly: dai alla macchina un nome completo con hostnamectl e /etc/hosts.
- L’interfaccia mostra una pagina bianca o un errore dopo un aggiornamento: esegui fwconsole chown, poi fwconsole restart.
Quale VPS per FreePBX?
Su ACLClouds, al 17 novembre 2026, il VPS Mini (2 vCPU, 8 GB di RAM, 40 GB di spazio) costa 4,99 € al mese senza vincolo, oppure 3,99 € al mese con vincolo di un anno: abbastanza per il centralino di una piccola azienda e le sue segreterie. Il VPS Essentiel (4 vCPU, 16 GB di RAM, 80 GB), a 9,99 € al mese, lascia margine per registrare le chiamate e gestire molte comunicazioni simultanee. La rete arriva fino a 1 Gbit/s; una chiamata in G.711 consuma circa 90 kbit/s in ogni direzione.
Verifica rapida
- http://VPS_IP/ mostra l’accesso a FreePBX.
- pjsip show endpoints mostra l’interno disponibile.
- Una chiamata tra due interni passa con l’audio in entrambi i sensi.
- Il trunk risulta registrato in pjsip show registrations.
- L’interfaccia di amministrazione è raggiungibile solo dai tuoi indirizzi.
Domande frequenti
FreePBX è gratuito?
Sì. FreePBX e Asterisk sono software libero, senza licenza per interno. Solo alcuni moduli commerciali di Sangoma sono a pagamento, come EndPoint Manager; un centralino completo funziona senza di essi. Le chiamate verso l’esterno sono fatturate dal tuo operatore SIP.
Si può installare FreePBX 17 su Debian 13 o Ubuntu?
Non con lo script ufficiale, che si ferma su qualsiasi sistema diverso da Debian 12. Un’installazione manuale resta possibile, ma Sangoma non la supporta: per un centralino in produzione scegli Debian 12.
Serve un certificato HTTPS per l’interfaccia?
È consigliato non appena apri l’interfaccia o il portale utenti (UCP) a Internet. Punta un nome di dominio verso il VPS e richiedi un certificato Let’s Encrypt; anche il modulo «Certificate Management» di FreePBX sa ottenerlo e rinnovarlo.
Quante chiamate simultanee regge un piccolo VPS?
Senza transcodifica né registrazione, qualche decina di chiamate sta su 2 vCPU: Asterisk inoltra soprattutto pacchetti. La transcodifica (per esempio da G.722 a G.729) e la registrazione di ogni chiamata aumentano nettamente il carico di CPU e disco. Misura con core show channels nelle ore di punta prima di aggiungere interni.