Servidor VoIP próprio com Asterisk e FreePBX
Configure Asterisk ou FreePBX no seu VPS com tronco SIP, portas RTP e firewall contra scanners. Veja como o toll fraud começa e como reduzir esse risco.
O que é um servidor VoIP auto-hospedado
Um servidor VoIP auto-hospedado é um servidor SIP executado num VPS que controla, para que as suas chamadas sejam encaminhadas pela sua própria máquina em vez de por um serviço telefónico alojado. VoIP (voz sobre IP) transporta a voz como pacotes UDP. SIP (protocolo de iniciação de sessão) é a sinalização que inicia e termina uma chamada. O áudio não passa pelo SIP, e esse facto é responsável pela maioria dos problemas descritos abaixo.
São necessárias quatro partes para ter um sistema funcional.
- O software PBX (central telefónica privada). Asterisk é a escolha habitual. Gere as extensões e o dialplan.
- Os endpoints. São telefones de secretária ou softphones que se registam no PBX com um nome de utilizador e um segredo.
- O SIP trunk. É uma conta paga num fornecedor que liga o seu sistema à rede telefónica pública e fornece números de telefone reais.
- O caminho de media. Os fluxos RTP (protocolo de transporte em tempo real) transportam o áudio através das suas próprias portas UDP.
Auto-hospedar o PBX não significa auto-hospedar números de telefone. Os números são fornecidos por uma operadora, e continua a pagar por número e por minuto. O que controla é o encaminhamento das chamadas, o voicemail, as gravações e a lista de extensões. Também fica responsável pela segurança de um serviço que é atacado para obter dinheiro.
Quais portas são necessárias para um servidor VoIP autoalojado?
A sinalização SIP usa a porta 5060 para UDP e TCP e a porta 5061 para SIP sobre TLS (segurança da camada de transporte). Essas portas transportam apenas a configuração das chamadas. O áudio de cada chamada usa um fluxo UDP separado, enviado para uma porta retirada do intervalo RTP. O Asterisk inclui um exemplo de rtp.conf que define rtpstart=10000 e rtpend=20000, e os valores predefinidos compilados são 5000 e 31000. Cada chamada usa duas portas desse intervalo: uma para RTP e outra para RTCP (protocolo de controlo RTP).
Esta separação é a causa da maioria das primeiras tentativas falhadas. A chamada liga-se, os dois telefones mostram-na como atendida e nenhum dos lados ouve áudio, porque a firewall permite a porta 5060 e descarta todos os pacotes RTP. A sinalização e os meios usam fluxos separados, por isso precisam de regras de firewall separadas. Se esta distinção for nova, vale a pena ler como funcionam as portas e os sockets de escuta no Linux antes de abrir qualquer porta.
Reduza o intervalo antes de o abrir. Vinte mil portas são muito mais do que um sistema pequeno precisa. Como cada chamada usa duas portas, um intervalo de duzentas portas suporta cem chamadas em simultâneo.
[general]
rtpstart=10000
rtpend=10200Aplique a alteração com sudo asterisk -rx "core reload".
Você deve instalar Asterisk ou FreePBX?
Asterisk é o mecanismo. Você o configura com arquivos de texto em /etc/asterisk e escreve o dialplan por conta própria. FreePBX é uma interface web escrita em PHP e JavaScript que funciona sobre o Asterisk, gera esses arquivos para você e adiciona módulos para correio de voz e filas de chamadas.
A diferença importante em um VPS é quem controla a máquina. Em outubro de 2026, o instalador oficial do FreePBX 17 espera um sistema Debian 12 sem alterações e instala Asterisk, um servidor web, um servidor de banco de dados e PHP. Aponte-o para uma máquina que já executa outros serviços e o resultado será problemático. Dê ao FreePBX seu próprio VPS.
wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh
sudo bash /tmp/sng_freepbx_debian_install.shO log da instalação é gravado em /var/log/pbx/ com um nome baseado no formato freepbx17-install-YYYY.MM.DD-HH.MM.SS.log e inclui um timestamp. Assim, cada execução recebe seu próprio arquivo. Esse é o primeiro lugar a consultar quando o script é interrompido antes do fim, e ls -t /var/log/pbx/freepbx17-install-*.log | head -1 encontra o arquivo mais recente.
O FreePBX controla os arquivos de configuração que gera. Edite pjsip.conf manualmente em um servidor FreePBX e sua alteração desaparecerá na próxima vez que a interface web gravar esse arquivo. O FreePBX lê arquivos separados que contêm _custom no nome para configurações escritas manualmente e não altera esses arquivos.
A troca é clara. O FreePBX fornece uma interface web e expõe uma página de login do seu sistema telefônico à internet pública. O Asterisk puro não tem nenhuma superfície web, e cada configuração é uma diretiva documentada que você pode ler em um arquivo e manter no git. Se instalar o FreePBX, restrinja a porta web ao seu próprio endereço ou acesse-a por uma VPN, porque uma interface de administração de um PBX é um alvo com acesso direto a dinheiro.
Nota sobre versões, correta em outubro de 2026: Asterisk 22 é a versão atual de suporte de longo prazo, publicada em outubro de 2024. Ela tem suporte completo até outubro de 2028 e depois recebe apenas correções de segurança até o fim da vida útil, em outubro de 2029. Asterisk 23 é a versão padrão. Asterisk 24, a próxima versão de suporte de longo prazo, estava programada para 15 de outubro de 2026, mas em 27 de outubro a página de versões do Asterisk ainda a listava como pré-lançamento, e o servidor de download continha apenas 24.0.0-rc3. Ubuntu 24.04 inclui Asterisk 20.6.0 no repositório universe. O projeto upstream passou o Asterisk 20 para o regime de apenas correções de segurança em 19 de outubro de 2026, e o fim da vida útil será em outubro de 2027. Ubuntu 26.04 inclui Asterisk 22.5.2.
Instalar o Asterisk no Ubuntu 24.04
O pacote da distribuição é o caminho mais rápido. O Ubuntu aplica as suas correções e inicia o serviço automaticamente através do systemd.
sudo apt update
sudo apt install -y asterisk
sudo asterisk -rx "core show version"Compilar a partir do código-fonte fornece, em vez disso, a versão atual com suporte de longo prazo.
sudo apt update
sudo apt install -y build-essential wget
cd /usr/local/src
sudo wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-22-current.tar.gz
sudo tar -xzf asterisk-22-current.tar.gz
cd asterisk-22.*
sudo contrib/scripts/install_prereq install
sudo ./configure
sudo make menuselect
sudo make -j"$(nproc)"
sudo make install
sudo make samples
sudo make config
sudo ldconfiginstall_prereq install instala as dependências de compilação da sua distribuição, e install_prereq test mostra os comandos que executaria sem alterar nada. make menuselect abre o seletor de módulos, onde ativa codec_opus em Codec Translators. Execute make samples apenas numa instalação nova, porque o comando grava a configuração de exemplo em /etc/asterisk. make config instala o script de inicialização em /etc/init.d/asterisk, e o systemd executa esse script através da sua camada de compatibilidade SysV, pelo que sudo systemctl enable --now asterisk funciona depois.
Independentemente do caminho escolhido, sudo asterisk -rvvv liga-se ao daemon em execução e fornece a CLI. Executar core show version nesse contexto mostra o que foi efetivamente instalado.
Configurar um SIP trunk e uma extensão
PJSIP é o controlador de canal SIP do Asterisk atual. A configuração fica em /etc/asterisk/pjsip.conf e é composta por pequenas secções tipadas que fazem referência umas às outras pelo nome. Secções de tipos diferentes podem partilhar o mesmo nome, por isso todos os blocos abaixo se chamam mytrunk.
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0
[mytrunk]
type=registration
outbound_auth=mytrunk
server_uri=sip:sip.example.com
client_uri=sip:1234567890@sip.example.com
retry_interval=60
[mytrunk]
type=auth
auth_type=userpass
username=1234567890
password=REPLACE_WITH_A_LONG_RANDOM_SECRET
[mytrunk]
type=aor
contact=sip:sip.example.com:5060
[mytrunk]
type=endpoint
context=from-trunk
disallow=all
allow=ulaw
outbound_auth=mytrunk
aors=mytrunk
[mytrunk]
type=identify
endpoint=mytrunk
match=sip.example.comO objeto registration envia o REGISTER que informa o seu fornecedor sobre onde deve entregar as suas chamadas. O objeto identify determina como uma chamada recebida do fornecedor é associada a este endpoint com base no endereço de origem; normalmente, o fornecedor publica vários endereços para incluir aí. O registo de saída e o endpoint são objetos separados de propósito: um informa o fornecedor sobre onde está, e o outro determina o que acontece às chamadas.
Um telefone de secretária precisa de mais três objetos.
[6001]
type=endpoint
context=internal
disallow=all
allow=ulaw
auth=auth6001
aors=6001
direct_media=no
[auth6001]
type=auth
auth_type=userpass
username=6001
password=REPLACE_WITH_A_LONG_RANDOM_SECRET
[6001]
type=aor
max_contacts=1direct_media=no mantém o Asterisk no caminho da comunicação multimédia. Se o omitir, o Asterisk tentará fazer com que os dois endpoints enviem RTP diretamente um para o outro. Isto falha quando um telefone está atrás de NAT (tradução de endereços de rede) num router doméstico. Nunca use um segredo igual ao número da extensão. O exemplo do fornecedor usa password=6001 para a extensão 6001, para manter o exemplo legível, e os scanners tentam exatamente esse padrão primeiro.
O dialplan em /etc/asterisk/extensions.conf determina o que cada contexto pode fazer.
[internal]
exten => 6001,1,Dial(PJSIP/6001,20)
exten => _9X.,1,Dial(PJSIP/${EXTEN:1}@mytrunk,60)
[from-trunk]
exten => 1234567890,1,Dial(PJSIP/6001,20)
same => n,Hangup()Esses dois contextos formam uma fronteira de segurança. from-trunk trata as chamadas recebidas do fornecedor e só pode fazer tocar a extensão 6001. Não pode alcançar o padrão _9X., por isso uma chamada externa não pode voltar a fazer chamadas através do seu trunk. Se juntar os contextos, terá criado o caminho clássico para fraude de chamadas: um desconhecido liga para o seu número, o seu dialplan faz uma chamada de saída através da sua conta e você paga por ela.
Aplique a configuração e verifique-a.
sudo asterisk -rx "pjsip reload"
sudo asterisk -rx "pjsip show registrations"
sudo asterisk -rx "pjsip show endpoints"pjsip show registrations deve listar mytrunk com o estado Registered. Rejected significa que o fornecedor recusou as suas credenciais. Unregistered significa que o seu REGISTER não está a obter resposta, por isso verifique primeiro a firewall.
Regras de firewall para SIP e RTP
A sinalização e os meios exigem tratamentos diferentes porque envolvem riscos diferentes. Restrinja a porta 5060 aos endereços que o seu fornecedor realmente utiliza e às redes onde estão os seus telefones.
sudo ufw allow proto udp from 203.0.113.10 to any port 5060
sudo ufw allow proto tcp from 203.0.113.10 to any port 5060
sudo ufw allow 10000:10200/udp
sudo ufw status verboseO intervalo RTP é a parte que não pode restringir tanto, porque os meios chegam frequentemente de um endereço diferente do utilizado pela sinalização. Peça ao seu fornecedor as sub-redes de meios e restrinja o acesso a essas sub-redes, se forem disponibilizadas. Mantenha o intervalo apenas com o tamanho necessário para a hora de maior utilização. As políticas predefinidas, a ordem das regras e o restante modelo do ufw são abordados no guia básico do firewall ufw para um VPS.
Verifique também o IPv6. O ufw permite IPv6 por predefinição, e uma regra sem endereço de origem, como a regra RTP acima, aplica-se às duas famílias. As regras para 5060 especificam uma origem IPv4, por isso correspondem apenas a IPv4; um fornecedor que faça sinalização por IPv6 precisa de regras próprias. Definir IPV6=no em /etc/default/ufw e recarregar o ufw não deixa o IPv6 sem filtragem: restringe o tráfego IPv6 à interface de loopback. Abrir portas para IPv6 com ufw explica as diferenças entre as duas famílias. A maioria dos fornecedores também disponibiliza um firewall de rede separado no painel de controlo. Esse firewall é aplicado antes de os pacotes chegarem ao VPS, por isso a porta tem de estar aberta nos dois locais.
Força bruta no SIP e fraude tarifária não são problemas opcionais
Exponha a porta 5060 num endereço público e os scans começam. O padrão é constante: pedidos REGISTER e INVITE provenientes de muitos endereços de origem, tentando números de extensão comuns com segredos comuns. O Asterisk regista cada falha, e a linha tem este formato.
Request 'REGISTER' from '<sip:1000@198.51.100.20>' failed for '198.51.100.20:5060' (callid: 5f1a5c0d) - No matching endpoint foundA razão para este problema exigir atenção real é financeira. Uma extensão roubada é usada para fazer chamadas internacionais dispendiosas, muitas vezes para números de tarifa premium que pagam uma parte ao atacante. A fatura fica do seu lado porque as chamadas usaram as suas credenciais. O processo funciona à velocidade de uma máquina e normalmente ocorre durante a noite.
Seis controlos são obrigatórios, e não apenas medidas opcionais de reforço.
- Nunca crie uma extensão cujo segredo seja o próprio número ou uma palavra curta. Gere um com
openssl rand -base64 24e cole-o no campo. - Mantenha as chamadas recebidas anónimas desativadas. O PJSIP recusa chamadas não identificadas por predefinição e só as aceita se criar um endpoint chamado
anonymous. Não crie esse endpoint. - Mantenha o contexto do trunk separado de qualquer contexto que possa fazer chamadas externas, como mostrado acima.
- Restrinja a sinalização pelo endereço de origem, tanto no ufw como na firewall de rede do seu fornecedor.
- Defina um limite de gastos com o fornecedor do trunk SIP e desative os destinos internacionais para os quais nunca liga. Este é o único controlo que limita a perda quando os outros falham.
- Execute fail2ban sobre o log do Asterisk.
O Asterisk também gera um evento de segurança quando um pedido não corresponde a nenhum endpoint, e o fail2ban pode atuar sobre esses eventos. A secção [global] de pjsip.conf aceita unidentified_request_count, que por predefinição é 5, e unidentified_request_period, que por predefinição é 5 segundos, mas estes valores só são usados quando auth_username está listado em endpoint_identifier_order. Esse método tem de adiar o evento até chegar um pedido com credenciais. Depois, as duas definições determinam quantos pedidos sem correspondência provenientes de um endereço, dentro do período, geram o evento. Com a ordem predefinida de ip,username,anonymous, os pedidos sem correspondência geram eventos de segurança sem esse adiamento.
Bloqueie os scanners com fail2ban
O fail2ban já inclui um jail asterisk. Esse jail abrange as portas 5060 e 5061, lê /var/log/asterisk/messages e usa maxretry = 10 por predefinição. O jail permanece desativado até o ativar em /etc/fail2ban/jail.local.
[asterisk]
enabled = true
maxretry = 5
findtime = 600
bantime = 86400sudo systemctl restart fail2ban
sudo fail2ban-client status asteriskUm resultado correto apresenta o ficheiro de log do jail e o número de endereços atualmente banidos. Num serviço 5060 público, esse número deixa de ser zero no prazo de um dia. O filtro incluído deteta os avisos No matching endpoint found acima e também as linhas SecurityEvent estruturadas do Asterisk. Esses eventos são enviados para um canal de log separado, que está comentado em /etc/asterisk/logger.conf. Ative-o nesse ficheiro e adicione o ficheiro ao logpath do jail se quiser detetar esses eventos.
[logfiles]
console => notice,warning,error
messages.log => notice,warning,error
security.log => securityRecarregue o logger com sudo asterisk -rx "logger reload". O filtro também inclui um journalmatch para asterisk.service, por isso pode usar um backend de journal se preferir não manter ficheiros de log. A instalação, a estrutura de jail.local e a remoção do banimento de um endereço que tenha bloqueado estão descritas em no guia do fail2ban para Ubuntu 24.04.
Latência e escolha do codec numa VPS distante
A latência é determinada pela geografia e não pode ser eliminada pela configuração. A ITU-T G.114 recomenda manter a latência de ida abaixo de 150 ms para uma conversa normal e considera que até cerca de 400 ms ainda é utilizável. O áudio de um telefone vai para a sua VPS e depois para o seu fornecedor de trunk, por isso uma VPS na região errada faz esse percurso duas vezes. Coloque-a perto dos telefones ou do fornecedor. Quando essas opções forem incompatíveis, prefira a proximidade dos telefones, porque esse percurso normalmente usa a Internet de acesso do cliente, onde o jitter é pior.
A escolha do codec define a largura de banda por chamada. Cada codec nesta secção envia um pacote a cada 20 ms, ou seja, 50 pacotes por segundo. Cada pacote transporta 40 bytes de cabeçalhos IP, UDP e RTP, além do payload de áudio.
Os dados por trás deste gráfico
[
{
"label": "G.711 ulaw",
"payload_kbps": 64,
"ip_kbps": 80
},
{
"label": "G.722",
"payload_kbps": 64,
"ip_kbps": 80
},
{
"label": "Opus at 24 kbps",
"payload_kbps": 24,
"ip_kbps": 40
},
{
"label": "G.729",
"payload_kbps": 8,
"ip_kbps": 24
}
]G.711 ulaw é o codec predefinido na maioria dos trunks. O payload utiliza 64 kbps. Com os cabeçalhos, uma chamada em curso consome 80 kbps em cada direção. Opus a 24 kbps utiliza 40 kbps, enquanto G.729 reduz o consumo para 24 kbps, com perda de qualidade de áudio e maior utilização de CPU. Estes valores resultam de cálculos dos cabeçalhos, não de medições: taxa do payload mais 40 bytes por pacote a 50 pacotes por segundo. O enquadramento Ethernet ou VLAN acrescenta um pouco mais ao tráfego na rede.
A transcodificação consome CPU. Se os seus telefones e o seu trunk suportarem ulaw, permita apenas ulaw e o Asterisk encaminhará o áudio sem o alterar. Opus funciona bem em ligações com perdas, mas a transcodificação entre Opus e G.711 requer o módulo externo codec_opus. Esse módulo é selecionado em make menuselect e não é compilado por predefinição.
Problemas mais comuns e mensagens apresentadas
A chamada é estabelecida, mas ninguém ouve nada. O RTP não está a chegar. Confirme se o intervalo em rtp.conf é o intervalo que abriu na firewall. Depois, monitorize os pacotes com sudo tcpdump -ni any udp portrange 10000-10200 enquanto faz uma chamada. Uma captura vazia apenas indica que não foi encontrado nenhum pacote correspondente ao filtro. Os pacotes podem ser bloqueados antes de chegarem ao servidor, por exemplo pela firewall de rede do seu fornecedor. O outro lado também pode estar a enviá-los para outro endereço ou para uma porta fora deste filtro. Compare, por isso, com o endereço e a porta de media indicados no SDP apresentado por pjsip set logger on.
Áudio apenas numa direção. Um dos lados está a enviar RTP para um endereço que não consegue recebê-lo. Trata-se de um problema de endereço, não de porta. Se o seu VPS tiver o endereço público diretamente na interface, não é necessária qualquer configuração de NAT. Se o fornecedor atribuir ao VPS um endereço privado com um mapeamento público um para um, defina o endereço público no transporte e indique o seu intervalo privado em local_net.
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0
local_net=10.0.0.0/8
external_media_address=198.51.100.5
external_signaling_address=198.51.100.5No matching endpoint found no log. O pedido não correspondeu a nenhum endpoint por endereço IP nem por nome de utilizador. Quando vem de um scanner, este comportamento é normal e o fail2ban irá tratá-lo. Quando vem do seu próprio fornecedor, significa que a secção identify não inclui o endereço a partir do qual o fornecedor faz as chamadas.
O estado do registo é Rejected. O fornecedor recusou as credenciais da sua secção auth. Execute pjsip set logger on na CLI, monitorize um REGISTER e a respetiva resposta e compare client_uri e username com os valores fornecidos pelo fornecedor.
Não há nada útil no log. Por predefinição, o Asterisk escreve no log o nível notice e os níveis superiores em messages.log. Aumente os níveis com core set verbose 4 e pjsip set logger on enquanto reproduz o problema. Depois, desative ambos, porque o logger SIP escreve todos os pacotes.
Antes de o expor
Uma PBX não é como as outras aplicações que aloja. Uma aplicação Web avariada deixa uma página indisponível. Uma PBX avariada pode gerar uma fatura telefónica em poucas horas, enquanto dorme. Execute-a numa VPS dedicada, restrinja a porta 5060 a endereços conhecidos, defina um segredo aleatório para cada extensão e estabeleça um limite de gastos na conta do trunk. O resto do servidor precisa da mesma configuração base que qualquer servidor exposto. esta análise sobre o nível de segurança real do alojamento em VPS explica essa configuração.
FAQ
Que portas preciso de abrir para um servidor VoIP autoalojado?
A porta 5060 para sinalização SIP sobre UDP e TCP, a porta 5061 se utilizar SIP sobre TLS e um intervalo de portas UDP para os meios RTP. O exemplo de rtp.conf do Asterisk utiliza 10000 a 20000, e os valores predefinidos incorporados na compilação são 5000 a 31000. Cada chamada consome duas portas do intervalo, pelo que um intervalo de duzentas portas suporta cem chamadas simultâneas. Abra o intervalo RTP como UDP e restrinja a porta 5060 aos endereços do seu fornecedor e às suas próprias redes, em vez de a deixar aberta a todos.
Devo instalar o Asterisk sozinho ou utilizar o FreePBX?
Instale o Asterisk sem uma camada adicional quando quiser uma superfície de ataque reduzida, ficheiros de configuração que possa manter no git e estiver disposto a escrever o dialplan. Instale o FreePBX quando quiser uma GUI para extensões, voicemail e filas de chamadas. Em outubro de 2026, o instalador do FreePBX 17 espera uma máquina Debian 12 sem alterações e instala o Asterisk, um servidor web, um servidor de base de dados e PHP. Por isso, atribua-lhe um VPS próprio. O FreePBX regenera os ficheiros de configuração que gere, pelo que as edições manuais devem ser feitas nos ficheiros _custom.
Porque não há áudio depois de a chamada ser estabelecida?
A sinalização funcionou, mas os meios não. O SIP estabeleceu a chamada na porta 5060, e o áudio é um fluxo UDP separado para uma porta do intervalo RTP que está a ser bloqueada. Confirme se o intervalo em rtp.conf corresponde ao intervalo aberto na firewall e verifique também a firewall de rede do fornecedor, além da firewall do servidor. Execute sudo tcpdump -ni any udp portrange 10000-10200 durante uma chamada. Uma captura vazia apenas significa que não foram vistos pacotes correspondentes: podem estar a ser bloqueados antes de chegarem ou ser enviados para um endereço ou porta fora do filtro.
Como impeço ataques de brute force contra SIP e fraude de tarifação?
Defina um segredo aleatório e longo para cada extensão. Nunca utilize um segredo que corresponda ao número da extensão. Mantenha o contexto utilizado pelo seu trunk separado de qualquer contexto que possa efetuar chamadas de saída, para que uma chamada recebida não possa efetuar outra chamada através da sua conta. Restrinja a porta 5060 aos endereços do seu fornecedor. Ative a jail asterisk no fail2ban. Esta jail lê /var/log/asterisk/messages e bloqueia os endereços que produzem No matching endpoint found falhas. Depois, defina um limite de gastos e bloqueie os destinos internacionais não utilizados junto do seu fornecedor, porque esse é o único controlo que limita a perda caso os restantes mecanismos falhem.
Um VPS numa região distante prejudica a qualidade das chamadas?
Sim, porque o áudio percorre dois troços: do telefone até ao VPS e depois do VPS até ao fornecedor do trunk. A recomendação ITU-T G.114 é manter o atraso num sentido abaixo de 150 ms, e um VPS mal localizado pode consumir a maior parte desse orçamento apenas devido à distância. Escolha uma região próxima dos telefones, porque esse troço normalmente utiliza internet de consumidor, onde o jitter é maior. A escolha do codec não elimina o atraso da rede. Altera a largura de banda e acrescenta algum atraso próprio de codificação e empacotamento (o RFC 6716 indica atrasos algorítmicos de 5 ms a 65.2 ms para o Opus). Por isso, o G.729 poupa bytes, mas não resolve um percurso de 200 ms.