ACLClouds
ACLClouds

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

  1. 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.

  2. 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.

  3. 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/.

  4. 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.

  5. 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.

  6. 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.