UniFi AP não adota? Siga este diagnóstico antes de resetar tudo.

Quando um access point UniFi não adota, o problema normalmente está entre descoberta, endereçamento IP, comunicação com a controladora e porta TCP 8080. A sequência abaixo ajuda a isolar a causa sem sair alterando várias configurações ao mesmo tempo.

1. Confirme se o AP está realmente conectado à rede

Antes de olhar a controladora, valide a camada física. Confirme se o LED do AP está aceso, se a porta do switch apresenta link e se o PoE utilizado é compatível. Se possível, teste outro cabo e outra porta do switch. Um cabo com defeito pode alimentar o equipamento e ainda assim causar instabilidade ou ausência de comunicação de dados.

2. Descubra qual IP o access point recebeu

Localize o AP na tabela DHCP do roteador, firewall ou servidor DHCP. Se o equipamento não recebeu endereço válido, investigue VLAN da porta, DHCP e tagging. Em alguns cenários, um UniFi sem DHCP pode utilizar o endereço de fallback 192.168.1.20; isso é um forte sinal de que o AP não conseguiu obter um IP normalmente.

3. Teste se o AP alcança a controladora

Se a controladora UniFi Network está em outro servidor, VLAN ou localidade, o AP precisa alcançar o endereço dela. Teste ping quando aplicável e, principalmente, confirme o caminho de rede entre o AP e o host da controladora. Em adoção Layer 3, roteamento entre redes precisa estar funcionando.

4. Verifique a comunicação pela TCP 8080

A Ubiquiti documenta a TCP 8080 como porta necessária para a comunicação de adoção com controladoras self-hosted e cenários Layer 3. Firewall do Windows, firewall de borda, ACLs ou regras inter-VLAN podem bloquear essa comunicação. Se AP e controladora estão em redes diferentes, valide explicitamente esse tráfego.

5. Use set-inform se a descoberta automática não funcionar

Acesse o AP por SSH e execute o comando set-inform apontando para o host UniFi, por exemplo: set-inform http://IP-DA-CONTROLADORA:8080/inform. Em alguns fluxos de adoção, pode ser necessário executar o comando novamente depois que o dispositivo aparecer como pronto para adoção.

6. Factory reset deve ser a última etapa, não a primeira

Se o equipamento já pertenceu a outra controladora, está com credenciais desconhecidas ou ficou em estado inconsistente, o reset pode ser necessário. Porém, faça isso somente depois de validar rede, DHCP e comunicação com a controladora, pois o reset não corrige bloqueio de firewall, VLAN incorreta ou rota ausente.