Ligar um equipamento UniFi ao UniFi Cloud Controller
Neste artigo fica a saber como ligar um equipamento UniFi, por exemplo um Access Point ou switch, ao UniFi Cloud Controller. O foco está nas portas externas necessárias para a operação e em como integrar o controller de forma mais cómoda na rede através de uma entrada DNS.
Clientes com uma subscrição de firewall podem contactar-nos e usar gratuitamente o Cloud Controller para até 5 equipamentos.
Requisitos
Para que os seus equipamentos UniFi consigam alcançar o UniFi Cloud Controller, as seguintes portas têm de estar abertas na firewall para comunicação de saída:
- TCP Port 8080: para tarefas de gestão e adoption (definir o parâmetro do controller através do comando set-inform).
- UDP Port 3478: para o protocolo STUN, usado para recolha de dados e deteção do endereço IP público.
- TCP Port 8443: para acesso à interface web do controller e gestão remota. (Opcional)
Confirme que estas portas estão permitidas na firewall para garantir uma comunicação sem problemas entre os equipamentos UniFi e o controller.
L3-Adoption via DNS
Por predefinição, os equipamentos UniFi tentam resolver o nome “unifi” e ligar-se a esse controller. Se este nome for criado no DNS e resolver para o IP ou nome DNS do Cloud Controller, novos equipamentos registam-se automaticamente nesse controller para adoption.
Numa Sophos Firewall, a configuração poderia ter este aspeto. Naturalmente, o requisito é que a Sophos Firewall seja usada como DNS server.

L3-Adoption via CLI
Para configurar o equipamento UniFi pela CLI, pode seguir estes passos. Primeiro, o UniFi Switch ou Access Point deve arrancar na rede e receber um endereço IP.
- Estabelecer ligação SSH ao equipamento:
Abra um terminal e ligue-se por SSH:
ssh ubnt@
Nota: a palavra-passe predefinida é ubnt. Se isto não funcionar, só ajuda um reset do equipamento. Após adoption bem-sucedida no controller, a palavra-passe é alterada automaticamente.
- Definir UniFi Controller:
Após login bem-sucedido, introduza o comando set-inform correspondente, para que o equipamento saiba a que controller se deve ligar.
set-inform http://:8080/inform
Depois disso, o equipamento regista-se no UniFi Controller em poucos segundos, sem reboot. Se usar a mobile app, recebe uma push notification a indicar que um novo equipamento está pronto para ser adicionado por adoption.
Comandos SSH úteis
Ao ligar-se por SSH ao UniFi Switch ou Access Point, existem alguns comandos úteis para resolução de problemas:
Com este comando pode obter informação detalhada sobre o equipamento:
info
Se um equipamento tiver de ser reconfigurado, pode repor as definições de fábrica com este comando:
set-default
Se deve ser usada a definição standard do controller, como no estado de fábrica:
set-inform http://unifi:8080/inform
Reset do equipamento UniFi
Por vezes é mais simples repor o equipamento para as definições de fábrica.
- Reboot: prima brevemente o botão Reset no equipamento e solte-o.
- Repor definições de fábrica: mantenha o botão Reset premido durante mais de cinco segundos, até a LED apagar.