Como configurar trunk SIP Nvoip em PABX Linux automaticamente

Este artigo mostra como usar o provisionador automático da Nvoip para configurar um trunk SIP em PABX Linux, como Asterisk, FreePBX, Issabel, FreeSWITCH e FusionPBX.

Antes de começar: tenha em mãos o usuário e a senha do trunk SIP da Nvoip. Em servidores Linux, também será necessário acesso ao terminal com permissão de sudo.

O que o provisionador faz

O nvoip-pabx-provisioner detecta o PABX instalado, cria a configuração do trunk SIP da Nvoip e, se você autorizar, cria rotas simples de teste para validar chamadas de entrada e saída.

Por padrão, ele cria apenas o trunk. As rotas de teste só são adicionadas quando você escolhe essa opção durante a configuração.

Requisitos

Servidor Linux com PABX já instalado.
Usuário e senha do trunk SIP Nvoip.
Acesso SSH ou terminal local no servidor.
Permissão de administrador para aplicar configurações.
Opcional: SIPp, para testes SIP automatizados.

Instalação rápida

Opção recomendada: repositório assinado

Em servidores Debian ou Ubuntu, instale usando a chave pública da Nvoip:

curl -fsSL https://nvoip.github.io/nvoip-linux-repo/keys/nvoip-linux-repo.asc | sudo gpg --dearmor -o /usr/share/keyrings/nvoip-linux-repo.gpg
echo "deb [signed-by=/usr/share/keyrings/nvoip-linux-repo.gpg] https://nvoip.github.io/nvoip-linux-repo/apt stable main" | sudo tee /etc/apt/sources.list.d/nvoip.list
sudo apt update
sudo apt install nvoip-pabx-provisioner

Em servidores Fedora, CentOS, Rocky Linux, AlmaLinux, RHEL e similares, use YUM/DNF com verificação do repositório:

sudo rpm --import https://nvoip.github.io/nvoip-linux-repo/keys/nvoip-linux-repo.asc
sudo tee /etc/yum.repos.d/nvoip.repo >/dev/null <<'EOF'
[nvoip]
name=Nvoip Linux Repository
baseurl=https://nvoip.github.io/nvoip-linux-repo/yum
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://nvoip.github.io/nvoip-linux-repo/keys/nvoip-linux-repo.asc
EOF

sudo dnf install nvoip-pabx-provisioner

Opção rápida para teste

Em ambientes de teste, é possível adicionar o repositório sem validação GPG.

Debian ou Ubuntu:

echo "deb [trusted=yes] https://nvoip.github.io/nvoip-linux-repo/apt stable main" | sudo tee /etc/apt/sources.list.d/nvoip.list
sudo apt update
sudo apt install nvoip-pabx-provisioner

Fedora, CentOS, Rocky Linux, AlmaLinux, RHEL e similares:

sudo tee /etc/yum.repos.d/nvoip.repo >/dev/null <<'EOF'
[nvoip]
name=Nvoip Linux Repository
baseurl=https://nvoip.github.io/nvoip-linux-repo/yum
enabled=1
gpgcheck=0
repo_gpgcheck=0
EOF

sudo dnf install nvoip-pabx-provisioner

Se preferir, também é possível instalar manualmente pelo release do GitHub:

curl -fsSL https://github.com/Nvoip/nvoip-pabx-provisioner/releases/latest/download/nvoip-pabx-provisioner-0.1.5.tar.gz -o /tmp/nvoip-pabx-provisioner.tar.gz
sudo tar -xzf /tmp/nvoip-pabx-provisioner.tar.gz -C /opt
sudo ln -sf /opt/nvoip-pabx-provisioner/bin/nvoip-pabx-provisioner /usr/local/bin/nvoip-pabx-provisioner

Também é possível baixar os pacotes .deb e .rpm pela página de releases:

https://github.com/Nvoip/nvoip-pabx-provisioner/releases/latest

Configuração guiada

Depois de instalar, rode o assistente:

sudo nvoip-pabx-provisioner configure

O assistente perguntará:

qual PABX será configurado, ou se deve detectar automaticamente;
usuário do trunk SIP Nvoip;
senha do trunk SIP Nvoip;
se deseja criar rotas de teste;
se deseja aplicar a configuração ou apenas simular;
se deseja executar validação após aplicar.

Simular antes de aplicar

Se quiser revisar o que será alterado antes de gravar arquivos no PABX, execute em modo de simulação:

nvoip-pabx-provisioner provision \
  --trunk-user "SEU_USUARIO_NVOIP" \
  --trunk-password "SUA_SENHA_NVOIP"

Criar somente o trunk

Para aplicar somente a configuração do trunk SIP:

sudo nvoip-pabx-provisioner provision \
  --trunk-user "SEU_USUARIO_NVOIP" \
  --trunk-password "SUA_SENHA_NVOIP" \
  --apply

Criar trunk e rotas de teste

Para criar o trunk e também rotas simples de validação:

sudo nvoip-pabx-provisioner provision \
  --trunk-user "SEU_USUARIO_NVOIP" \
  --trunk-password "SUA_SENHA_NVOIP" \
  --apply-test-routing \
  --apply \
  --validate

Validação

Para validar Asterisk, FreePBX ou Issabel:

nvoip-pabx-provisioner validate --engine asterisk \
  --trunk-user "SEU_USUARIO_NVOIP" \
  --trunk-password "SUA_SENHA_NVOIP"

Para validar FreeSWITCH ou FusionPBX:

nvoip-pabx-provisioner validate --engine freeswitch \
  --trunk-user "SEU_USUARIO_NVOIP" \
  --trunk-password "SUA_SENHA_NVOIP"

Se o SIPp estiver instalado, adicione --validate-sipp para executar um teste SIP automatizado.

Compatibilidade

O provisionador foi criado para ambientes Linux que usam Asterisk ou FreeSWITCH como base. A compatibilidade cobre os principais PABXs open source e distribuições usadas em produção.

Base	Principais distribuições e painéis
Asterisk	Asterisk puro, FreePBX, Issabel clássico com chan_sip, Issabel com PJSIP, Elastix, VitalPBX, Incredible PBX e outras distribuições baseadas em Asterisk.
FreeSWITCH	FreeSWITCH puro, FusionPBX, Kazoo/2600Hz e outras distribuições baseadas em FreeSWITCH com configuração SIP XML.

Pontos de atenção

Em servidores atrás de NAT, o provisionador tenta detectar o IP público automaticamente para evitar erro de mídia ou sinalização.
Se o servidor usa firewall, libere as portas SIP e RTP usadas pelo PABX.
Não compartilhe usuário e senha do trunk em canais públicos.
Antes de aplicar em produção, faça backup da configuração atual do PABX.

Repositório oficial

O código, instaladores e documentação técnica ficam no GitHub da Nvoip:

https://github.com/Nvoip/nvoip-pabx-provisioner