Como instalar o FreePBX 17 num VPS Debian 12?
Instalar o FreePBX 17 e o Asterisk com o script oficial, abrir as portas SIP e RTP, ajustar o NAT, criar uma extensão e um trunk SIP e proteger a central
O FreePBX é uma interface web livre para o Asterisk, o software de central telefónica (IP PBX). Instalado num VPS, gere as extensões da equipa, as linhas SIP do operador, o correio de voz, as filas de chamadas e os horários, sem equipamento no local. A versão 17 instala-se com um script oficial da Sangoma que só suporta Debian 12.
Procedimento passo a passo
-
Preparar um VPS com Debian 12
Escolha Debian 12 na encomenda ou reinstale o VPS com este sistema: o script espera uma instalação limpa, sem servidor web nem base de dados já instalados. Depois ligue-se por SSH como root.
-
Atualizar e dar nome à máquina
Execute apt update && apt upgrade -y e reinicie se foi instalado um kernel novo. Dê ao VPS um nome completo (FQDN) como pbx.example.com com hostnamectl set-hostname e uma linha em /etc/hosts: o script para se hostname -f não devolver nada.
-
Executar o script oficial
Descarregue sng_freepbx_debian_install.sh do repositório GitHub FreePBX/sng_freepbx_debian_install e execute-o com bash. Instala o Asterisk 22, o FreePBX, o Apache, o PHP 8.2, o MariaDB, o Fail2ban e os módulos base; conte com 15 a 30 minutos. O registo detalhado é escrito em /var/log/pbx/.
-
Criar a conta de administrador
Abra http://VPS_IP/ no navegador. O FreePBX pede um nome de utilizador, uma palavra-passe e um endereço de e-mail para as notificações. A ativação junto da Sangoma é opcional: serve para os módulos comerciais.
-
Abrir as portas SIP e RTP
Na «Firewall» do painel ACLClouds, autorize 5060/UDP para a sinalização SIP e o intervalo 10000-20000/UDP para a voz (RTP). Limite 80 e 443/TCP, a interface de administração, ao seu endereço IP.
-
Ajustar o NAT e criar uma extensão
Em «Settings» > «Asterisk SIP Settings», clique em «Detect Network Settings» para preencher o endereço externo e as redes locais. Depois crie uma extensão PJSIP em «Applications» > «Extensions», configure-a num softphone e clique em «Apply Config».
Dar nome à máquina e instalar o 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
Comandos úteis depois da instalação
fwconsole restart
fwconsole reload
fwconsole ma upgradeall
fwconsole chown
asterisk -rvvv
Na consola do Asterisk
pjsip show endpoints
pjsip show registrations
core show channels
Antes de começar
Uma central FreePBX precisa de poucos recursos para uma equipa pequena: a carga vem sobretudo do número de chamadas simultâneas, da gravação das conversas e da transcodificação entre codecs. Precisa também de um trunk SIP, ou seja, uma linha fornecida por um operador de VoIP, para ligar para o exterior e receber as chamadas dos seus números.
- O Debian 12 (bookworm) é o único sistema aceite pelo script do FreePBX 17; recusa o Debian 13 e bloqueia essa atualização.
- O VPS deve manter o mesmo endereço IP: o operador e os telefones dependem dele.
- Por predefinição, o script instala também os módulos comerciais da Sangoma, entre eles System Admin e Firewall; a opção --opensourceonly remove-os, incluindo o módulo Firewall.
Adicionar um trunk SIP
Em «Connectivity» > «Trunks», adicione um trunk PJSIP com os dados do operador: servidor SIP, utilizador, palavra-passe e, conforme o plano, registo ou autenticação por endereço IP. Depois crie uma rota de entrada («Inbound Routes») por número e uma rota de saída («Outbound Routes») com os formatos de número permitidos.
Se o operador autenticar por endereço IP, indique-lhe o IPv4 do VPS e abra 5060/UDP na firewall apenas aos endereços dele.
Proteger a central
Uma porta SIP pública recebe tentativas de ligação automáticas nas horas seguintes à entrada em funcionamento. O risco principal é a fraude: chamadas para números de valor acrescentado ou internacionais feitas a partir de uma extensão pirateada e faturadas na sua conta do operador.
- Mantenha o Fail2ban, instalado pelo script: bane os endereços após várias falhas de autenticação SIP.
- Dê a cada extensão uma palavra-passe longa e aleatória, nunca o número da extensão.
- Recuse as chamadas anónimas: defina «Allow Anonymous Inbound SIP Calls» e «Allow SIP Guests» como «No» em «Asterisk SIP Settings».
- Limite as rotas de saída aos destinos úteis e peça ao operador um limite de gastos ou o bloqueio dos números de valor acrescentado e internacionais.
Erros comuns e soluções
A maioria dos problemas de voz vem do NAT ou das portas RTP. pjsip show endpoints e o registo /var/log/asterisk/full indicam a causa quase sempre.
- Chamada estabelecida mas sem som, ou com som num só sentido: o intervalo 10000-20000/UDP está fechado ou o endereço externo está vazio em «Asterisk SIP Settings». Corrija e clique em «Apply Config».
- A extensão não se regista e recebe 401 Unauthorized: utilizador ou palavra-passe errados. Se deixar de receber qualquer resposta após várias tentativas, o endereço foi banido pelo Fail2ban.
- O script para com Unsupported OS version: o sistema não é Debian 12. Reinstale o VPS com Debian 12 e execute-o de novo.
- O script para em Fully qualified domain name (FQDN) is not set correctly: dê à máquina um nome completo com hostnamectl e /etc/hosts.
- A interface mostra uma página em branco ou um erro depois de uma atualização: execute fwconsole chown e depois fwconsole restart.
Que VPS para o FreePBX?
Na ACLClouds, a 17 de novembro de 2026, o VPS Mini (2 vCPU, 8 GB de RAM, 40 GB de armazenamento) custa 4,99 € por mês sem fidelização, ou 3,99 € por mês com fidelização de um ano: suficiente para a central de uma pequena empresa e o seu correio de voz. O VPS Essentiel (4 vCPU, 16 GB de RAM, 80 GB), a 9,99 € por mês, deixa margem para gravar chamadas e manter muitas comunicações simultâneas. A rede vai até 1 Gbit/s; uma chamada em G.711 consome cerca de 90 kbit/s em cada sentido.
Verificação rápida
- http://VPS_IP/ mostra o início de sessão do FreePBX.
- pjsip show endpoints mostra a extensão disponível.
- Uma chamada entre duas extensões passa com som nos dois sentidos.
- O trunk aparece como registado em pjsip show registrations.
- A interface de administração só é acessível a partir dos seus endereços.
Perguntas frequentes
O FreePBX é gratuito?
Sim. O FreePBX e o Asterisk são software livre, sem licença por extensão. Só alguns módulos comerciais da Sangoma são pagos, como o EndPoint Manager; uma central completa funciona sem eles. As chamadas para o exterior são faturadas pelo seu operador SIP.
É possível instalar o FreePBX 17 no Debian 13 ou no Ubuntu?
Não com o script oficial, que para em qualquer sistema que não seja o Debian 12. Uma instalação manual continua possível, mas a Sangoma não lhe dá suporte: para uma central em produção, escolha o Debian 12.
É preciso um certificado HTTPS para a interface?
É recomendado assim que abrir a interface ou o portal de utilizadores (UCP) à Internet. Aponte um nome de domínio para o VPS e peça um certificado Let’s Encrypt; o módulo «Certificate Management» do FreePBX também o sabe obter e renovar.
Quantas chamadas simultâneas aguenta um VPS pequeno?
Sem transcodificação nem gravação, algumas dezenas de chamadas cabem em 2 vCPU: o Asterisk sobretudo reencaminha pacotes. A transcodificação (por exemplo de G.722 para G.729) e a gravação de cada chamada aumentam claramente a carga de CPU e de disco. Meça com core show channels nas horas de ponta antes de acrescentar extensões.