Guia de instalação

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.
Antes da instalação

Preparar a rede

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

    NomeTipoValor
    pbx.yourdomain.com A Endereço IPv4 do seu servidorObrigatório
    pbx.yourdomain.com AAAA 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.

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

    PortaProtocoloServiçoPara que serve
    8443 Apenas durante a instalação TCP Assistente Assistente de instalação (passo 10). Volte a fechá-la depois de o PBX estar ativado
    80 TCP Nginx Aprovisionamento dos terminais por HTTP, renovação do certificado Let's Encrypt
    443 TCP Nginx Interface web, API, aplicações móveis e de computador, telefone web (WebRTC), aprovisionamento HTTPS
    5060 UDP + TCP Kamailio SIP: terminais, softphones, trunks de operadores
    5061 TCP Kamailio SIP cifrado (TLS), certificado ECDSA
    5062 TCP Kamailio SIP cifrado (TLS), certificado RSA para os terminais que não suportam ECDSA
    30000-40000 UDP rtpengine Voz (RTP) de todas as chamadas: sem estas portas, não há som
    3478-3479 UDP + TCP coturn STUN/TURN: som das aplicações e do telefone web atrás de NAT
    5349-5350 UDP + TCP coturn TURN cifrado (TLS), mesma função em redes restritivas
    389 TCP API MaxiPBX Diretório LDAP para os telefones
    10389 TCP API MaxiPBX Diretório LDAP numa porta alternativa, para determinados modelos
    22 TCP 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.

No Control Plane

Gerar a sua chave de instalação

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

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

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

No seu servidor

Iniciar a instalação

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

    DicaSe tiver iniciado sessão com outra conta, mude para root com o comando «su -» ou «sudo -i» antes de continuar.

  2. Passo 8 : Cole o script e confirme

    Cole no terminal o script de instalação copiado no passo 6 e prima Enter.

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

No seu navegador

Concluir a configuração

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

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