Onsite Proxy

Visão geral

O Onsite Proxy é um software de proxy de linha de comando que cria uma conexão segura entre o seu Cloud PABX e os telefones IP implantados em locais remotos. Ele supera problemas comuns de firewall e rede, atuando como um intermediário local entre os telefones e o PABX em nuvem.

Para gerenciar instâncias do Onsite Proxy, faça login no portal de administração do PABX e navegue até Sistema > Onsite Proxy.

Cenário de uso

Quando vários telefones IP são implantados em uma sub-rede remota (por exemplo, uma filial), você pode instalar o Onsite Proxy em um host na mesma sub-rede desses telefones. Apenas o proxy precisa de uma conexão com o Cloud PABX — os telefones individuais não precisam de acesso direto à nuvem.

O Onsite Proxy então encaminha links de provisionamento, sinalização SIP e pacotes RTP entre os telefones e o PABX, fazendo com que funcionem como se estivessem na mesma rede do PABX. Isso elimina a necessidade de configurar encaminhamento de portas ou regras de firewall para cada telefone individualmente e reduz a latência em comparação com soluções de acesso remoto tradicionais.

Principais recursos

Descoberta automática de telefones IP

O Onsite Proxy descobre automaticamente telefones IP disponíveis na mesma sub-rede via PnP (Plug and Play) e reporta suas informações (incluindo endereço MAC, endereço IP, fabricante e modelo) ao PABX.

Provisionamento automático zero-touch

Quando você atribui extensões (ramais) a telefones IP descobertos pelo Onsite Proxy, o proxy envia automaticamente o link de provisionamento do PABX para os telefones. Os telefones então baixam sua configuração e completam o registro da extensão sem intervenção manual.

Proxy de sinalização SIP

O Onsite Proxy encaminha solicitações de registro SIP dos telefones para o PABX e mantém um registro estável. Ele retransmite toda a sinalização SIP (como REGISTER, INVITE e BYE) entre os telefones e o PABX através de uma única porta UDP 5060 no host do proxy.

Passthrough de áudio RTP

O Onsite Proxy suporta Passthrough de áudio RTP. Quando ativado, se os telefones IP estão registrados via o mesmo Onsite Proxy, os fluxos de áudio RTP entre eles são transmitidos diretamente (ponto a ponto), ignorando tanto o PABX quanto o proxy. Isso reduz a latência, economiza largura de banda e melhora a qualidade da chamada.

Requisitos

Host do Onsite Proxy

Especificações recomendadas

A capacidade suportada pelo Onsite Proxy depende dos recursos de sistema alocados ao host.

Etapa 1: Adicionar uma instância do Onsite Proxy no PABX

Antes de instalar o software Onsite Proxy, você precisa criar uma instância do Onsite Proxy no PABX. Isso gera as credenciais de conexão (endereço de conexão, UUID e chave secreta) que você precisará durante a instalação do proxy.

1. Faça login no portal de administração do PABX e vá para Sistema > Onsite Proxy. Clique em Adicionar.

2. Na seção Básico, configure as seguintes definições:

   Configuração	Descrição
   Nome	Insira um nome para identificar esta instância do Onsite Proxy (por exemplo, o local da filial).
   Plataforma	Selecione Linux.

   

3. Na seção Passthrough de áudio RTP, ative ou desative a opção conforme necessário.
   • Se ativado, os fluxos de áudio RTP entre telefones registrados via o mesmo Onsite Proxy são transmitidos diretamente (ponto a ponto).
   • Se desativado, os fluxos de áudio RTP são retransmitidos pelo PABX.
4. Clique em Salvar e Aplicar.

A instância do Onsite Proxy aparece na lista com as informações de conexão geradas automaticamente (endereço de conexão, UUID e chave secreta).

Etapa 2: Instalar o software Onsite Proxy

Instale o Onsite Proxy em um host Linux na mesma sub-rede dos telefones IP. Durante a instalação, um assistente de configuração orienta você na conexão do proxy com o Cloud PABX.

Pré-requisitos

• Você adicionou uma instância do Onsite Proxy no PABX (Etapa 1) e obteve as credenciais de conexão (endereço de conexão, UUID, chave secreta).
• O host Linux atende aos requisitos listados acima (sistema operacional, porta, endereço IP).
• HTTPS deve estar habilitado para o endereço de conexão do PABX.

Baixar e extrair o pacote de instalação

1. Acesse a linha de comando no host do Onsite Proxy.
2. Execute sudo -i para alternar para o usuário root.
3. Baixe o pacote de instalação mais recente do Onsite Proxy:
   • x86_64:
     wget https://www.virtual-call.net/hubfs/download/onsite-proxy/onsiteproxy-x86_64.tar.gz -O /tmp/onsiteproxy.tar.gz
   • ARM64:
     wget https://www.virtual-call.net/hubfs/download/onsite-proxy/onsiteproxy-aarch64.tar.gz -O /tmp/onsiteproxy.tar.gz
4. Extraia o pacote para o diretório raiz:
   tar -xzf /tmp/onsiteproxy.tar.gz -C /

Executar o instalador e configurar a conexão

1. Execute onsite-proxy-install para iniciar a instalação.

2. Na janela Onsite Proxy Installation, verifique a versão e os detalhes do sistema, selecione Yes e pressione Enter.

   

3. Na janela Important Requirements, confirme que a porta UDP 5060 está disponível e o HTTPS está habilitado, e pressione Enter.

   

4. Na janela de boas-vindas do Configuration Wizard, pressione Enter para começar.

   

5. Configure as informações de conexão do PABX:

   Configuração	Descrição
   PBX Connection Address	Cole o endereço de conexão obtido do PABX. Pode ser um endereço IP ou um nome de domínio.
   UUID	Cole o UUID obtido do PABX.
   Secret Key	Cole a chave secreta obtida do PABX. Mantenha esta chave em segurança.
   PBX External Web Server Port	A porta HTTPS do PABX. Para o Cloud PABX, o padrão é 443.
   PBX External Tunnel Porta	A porta de túnel utilizada para a conexão do proxy. Padrão: 1090.
   Local IP	Selecione o endereço IP estático atribuído ao host do proxy ou escolha manual para inseri-lo manualmente.

   

6. Na janela Configuration Summary, verifique todas as configurações e selecione Yes para confirmar.

   

7. Aguarde a conclusão da verificação. Nas janelas Verification Successful e Configuration Complete, pressione Enter para continuar.

   

8. Na janela Installation Complete, pressione Enter para finalizar.

   

O Onsite Proxy está agora instalado e conectado ao Cloud PABX. No PABX, o status da instância muda para uma marca de verificação verde, mostrando a versão do proxy, endereço IP interno e endereço IP público.

Gerenciar o Onsite Proxy

Visualizar status e informações

Vá para Sistema > Onsite Proxy para visualizar o status de todas as instâncias do Onsite Proxy. A lista mostra o nome, plataforma, versão, UUID e chave secreta de cada instância. Você também pode utilizar o campo de pesquisa e o filtro de colunas para encontrar instâncias específicas.

Editar uma instância do Onsite Proxy

Clique no ícone de edição ao lado de uma instância para alterar o nome, a plataforma ou a configuração de Passthrough de áudio RTP. A seção Informações de conexão também exibe o endereço de conexão, UUID e chave secreta.

Consultar status e informações do proxy

Após a conexão do Onsite Proxy, você pode visualizar informações detalhadas de status clicando no ícone de status ao lado da instância. Isso inclui a versão do proxy, endereços IP internos e públicos e utilização de recursos do sistema.

Reconfigurar ou desinstalar o proxy

Após a instalação, você pode utilizar os seguintes comandos no host do proxy: