Pré-requisitos
Sistema operacional:
Windows 10 ou superior
Windows Server 2016 ou superior
Arquiteturas: x64, x86, ARM64
Permissões:
Administrador local (para instalação)
Acesso à internet (para validação do token)
Requisitos de rede (destino/porta/protocolo/finalidade):
Servidores DNS: 53/UDP e TCP (consultas DNS)
app.edgedns.com.br: 443/HTTPS (API e validação)
Token do cliente (obtido no painel EdgeDNS):
Acesso ao painel: https://app.edgedns.com.br
Passo a Passo
1. Obter o Token do Cliente
Acesse o painel de administração: https://app.edgedns.com.br
Faça login com suas credenciais de parceiro.
Navegue até Clientes e selecione o cliente desejado.
Copie o Token de API exibido.
Importante: cada cliente possui um token único. Use o token correto em cada instalação.
2. Instalação Manual (Windows)
Baixe o instalador em Baixar Agente > Baixar para Windows.
2. Execute o instalador com duplo clique ou via comando:
Execute:
msiexec /i EdgeDNSAgent.msi
3. Siga o assistente de instalação.
4. Após a instalação, abra o EdgeDNS Agent pelo menu Iniciar.
5. Na interface do Agent, insira o Token do Cliente e clique em Salvar.
6. Aguarde a confirmação de conexão com o servidor.
3. Verificação da Instalação
A) Verificar se o serviço está rodando
Via Prompt de Comando:
sc query EdgeDNSAgentService
Via PowerShell:
Get-Service -Name "EdgeDNSAgentService"
Resultado esperado: Status = RUNNING
B) Verificar se o produto está instalado
wmic product where "name like '%%EdgeDNS%%'" get Name,Version
C) Testar conectividade com a API
curl -I https://app.edgedns.com.br/api
4. Gerenciamento do Serviço
O Agent roda como serviço Windows: EdgeDNSAgentService.
Iniciar/parar/reiniciar/status via executável:
# REM Iniciar o serviço
edgedns-agent-service.exe start
# REM Parar o serviço
edgedns-agent-service.exe stop
# REM Reiniciar o serviço
edgedns-agent-service.exe restart
# REM Verificar status
edgedns-agent-service.exe status
Comandos SC (Service Control)
# REM Verificar status
sc query EdgeDNSAgentService
# REM Iniciar
sc start EdgeDNSAgentService
# REM Parar
sc stop EdgeDNSAgentService
# REM Reiniciar (parar + iniciar)
sc stop EdgeDNSAgentService && sc start EdgeDNSAgentService
Comandos PowerShell
# Verificar status
Get-Service EdgeDNSAgentService
# Iniciar
Start-Service EdgeDNSAgentService
# Parar
Stop-Service EdgeDNSAgentService
# Reiniciar
Restart-Service EdgeDNSAgentService
Referência de Campos
Campo/Item | Onde aparece | Função | Valores aceitos |
Token do Cliente (Token de API) | Painel EdgeDNS > Clientes | Vincular o Agent ao cliente correto | Token |
Baixar Agente > Baixar para Windows | Tela do EdgeDNS | Obter instalador do Agent para Windows | Download (arquivo .msi citado como |
Nome do serviço | Windows Services/Comandos | Identificar/gerenciar o serviço do Agent |
|
Destino/Porta/Protocolo (DNS) | Requisitos de rede | Permitir consultas DNS | 53 / UDP e TCP |
Destino/Porta/Protocolo (API) | Requisitos de rede | Validação e API |
|
Troubleshooting
Sintoma | Causa provável (com base no rascunho) | Ação corretiva |
| Serviço não iniciou | Verificar com |
Serviço não encontrado ( | Agent não instalado corretamente | Validar instalação com |
Agent não valida/vincula o cliente | Token incorreto | Obter novamente o Token de API do cliente correto e inserir no Agent, clicando em Salvar |
| Sem acesso à internet ou bloqueio de saída para | Validar conectividade/saída HTTPS (porta 443) para |
Problemas com DNS/filtragem | Bloqueio de consultas DNS | Validar liberação de 53/UDP e TCP para servidores DNS |
Avisos e Boas Práticas
Use token por cliente (não reutilize token entre clientes).
Execute a instalação com Administrador local.
Garanta saída para:
443/HTTPS (
app.edgedns.com.br) para API/validação53/UDP e TCP para consultas DNS
Após instalar, valide sempre:
Serviço RUNNING
Instalação via
wmicConectividade via
curl -I