Instalar o MaxiPBX no seu servidor
Dez passos, desde o nome de domínio do seu PBX até ao primeiro acesso à interface. Primeiro prepara o FQDN e a firewall, depois o Control Plane gera um script único que executa via SSH e, por fim, um assistente web assume a configuração.
Antes de começar
- Um servidor Debian 13 acabado de instalar, sem qualquer outro serviço ou aplicação.
- Um acesso SSH com a conta root (ou com uma conta que possa tornar-se root).
- Um nome de domínio cuja zona DNS gere, para criar o FQDN do seu PBX (por exemplo pbx.yourdomain.com).
- Uma conta no Control Plane MaxiPBX, no endereço my.maxipbx.com.
- Acesso à firewall ou ao router colocado à frente do servidor, para abrir as portas necessárias.
Preparar a rede
-
Passo 1 : Crie o FQDN do seu servidor
Antes de mais, atribua ao seu PBX um nome de domínio completo (FQDN), por exemplo pbx.yourdomain.com. Na zona DNS do seu domínio, faça com que este nome aponte para o endereço IP do seu servidor:
AtençãoO FQDN já deve apontar para o seu servidor no momento em que iniciar a instalação (passo 8). Crie-o em primeiro lugar.
Nome Tipo Valor pbx.yourdomain.comA Endereço IPv4 do seu servidorObrigatório pbx.yourdomain.comAAAA Endereço IPv6 do seu servidorSe o seu servidor tiver um endereço IPv6 DicaUma alteração de DNS pode demorar alguns minutos a propagar-se. Para verificar se o nome responde com o IP do seu servidor, execute «ping pbx.yourdomain.com» a partir do seu computador.
-
Passo 2 : Abra as portas da firewall
O PBX tem a sua própria firewall, que abre exatamente as portas de que necessita. Se existir uma firewall ou um router à sua frente (firewall do fornecedor de alojamento, router empresarial, router de internet), abra nele todas as portas abaixo, do exterior para o PBX.
AtençãoA porta 8443 TCP só é necessária durante a instalação: é a do assistente de instalação (passo 10). Abra-a antes de iniciar a instalação e volte a fechá-la depois de o PBX estar ativado: deixa de ser necessária.
Porta Protocolo Serviço Para que serve 8443Apenas durante a instalaçãoTCP Assistente Assistente de instalação (passo 10). Volte a fechá-la depois de o PBX estar ativado 80TCP Nginx Aprovisionamento dos terminais por HTTP, renovação do certificado Let's Encrypt 443TCP Nginx Interface web, API, aplicações móveis e de computador, telefone web (WebRTC), aprovisionamento HTTPS 5060UDP + TCP Kamailio SIP: terminais, softphones, trunks de operadores 5061TCP Kamailio SIP cifrado (TLS), certificado ECDSA 5062TCP Kamailio SIP cifrado (TLS), certificado RSA para os terminais que não suportam ECDSA 30000-40000UDP rtpengine Voz (RTP) de todas as chamadas: sem estas portas, não há som 3478-3479UDP + TCP coturn STUN/TURN: som das aplicações e do telefone web atrás de NAT 5349-5350UDP + TCP coturn TURN cifrado (TLS), mesma função em redes restritivas 389TCP API MaxiPBX Diretório LDAP para os telefones 10389TCP API MaxiPBX Diretório LDAP numa porta alternativa, para determinados modelos 22TCP SSH Administração e manutenção remotas pela MaxiPBX. Pode ser limitado aos nossos endereços IP DicaSe o PBX estiver atrás de NAT (endereço IP privado), configure um reencaminhamento de portas de toda esta lista para o seu IP interno, com o mesmo intervalo RTP 30000-40000 UDP.
Gerar a sua chave de instalação
-
Passo 3 : Inicie sessão no Control Plane
Abra my.maxipbx.com no seu navegador e inicie sessão com a sua conta. É a partir do Control Plane que gere todo o seu parque de PBX.
Abrir o Control Plane -
Passo 4 : Abra a lista dos seus PBX
No menu, aceda a «Parque PBX» e clique em «PBX». Aí vê todos os PBX já associados à sua conta.
-
Passo 5 : Gere uma chave de instalação
Clique em «Gerar uma chave de instalação». Esta chave associa o futuro servidor à sua conta: depois de instalado, aparecerá diretamente no seu parque.
-
Passo 6 : Apresente e copie o script de instalação
Apresente o script de instalação e copie-o na íntegra. Já contém a sua chave: não precisa de alterar nada.
AtençãoO script contém uma chave própria da sua conta. Não o partilhe nem o publique em lado nenhum.
Iniciar a instalação
-
Passo 7 : Ligue-se via SSH com a conta root
A partir de um terminal (ou de um cliente como o PuTTY no Windows), ligue-se ao seu novo servidor Debian 13 com a conta root. Substitua YOUR_IP pelo endereço IP do seu servidor.
ssh root@YOUR_IPDicaSe tiver iniciado sessão com outra conta, mude para root com o comando «su -» ou «sudo -i» antes de continuar.
-
Passo 8 : Cole o script e confirme
Cole no terminal o script de instalação copiado no passo 6 e prima Enter.
-
Passo 9 : Deixe a instalação decorrer
O progresso da instalação é apresentado no ecrã à medida que avança. Deixe-a chegar ao fim sem mexer em nada.
AtençãoNão feche o terminal nem interrompa a ligação SSH durante a instalação.
Concluir a configuração
-
Passo 10 : Abra o assistente de instalação
No final da instalação, o terminal apresenta o endereço do seu PBX no formato indicado abaixo. Abra-o no seu navegador e siga o assistente de instalação: este orienta-o na configuração inicial.
https://YOUR_IP:8443DicaSe o seu navegador apresentar um aviso de segurança sobre o certificado neste primeiro acesso, pode prosseguir para o site para iniciar o assistente.
Precisa de ajuda?Em caso de dúvida durante o assistente, não hesite em contactar o seu parceiro revendedor MaxiPBX: está ao seu dispor para o acompanhar.
O seu PBX está instalado
Depois de concluído o assistente, o seu PBX está pronto e associado ao seu parque no Control Plane. Pode criar os seus utilizadores, terminais e linhas.
Precisa de uma ajuda?
A nossa equipa pode acompanhá-lo durante a instalação ou tratar dela por si.

