Conecte o Access Point (AP), roteador ou outra controladora \u00e0 rede local. Neste exemplo, utilizamos um Mikrotik, mas voc\u00ea pode usar outro roteador. Para identificar o dispositivo conectado, acesse a aba de dispositivos na interface do seu roteador.<\/p>\n\n\n\n
<\/p>\n\n\n\n
Passo 2: Verificar o IP atribu\u00eddo ao dispositivo<\/strong> Passo 3: Acessar o dispositivo UniFi via SSH<\/strong> <\/p>\n\n\n\n Passo 4: Abrir o terminal de sua prefer\u00eancia<\/strong><\/p>\n\n\n\n Esse erro acontece porque o seu cliente SSH (provavelmente uma vers\u00e3o mais recente do OpenSSH) n\u00e3o aceita mais alguns algoritmos antigos<\/strong>, como Passo 5: Conectar ao dispositivo UniFi via SSH com suporte a algoritmos antigos<\/strong>. Digite: yes <\/p>\n\n\n\n Passo 7: Executar o comando para vincular \u00e0 controladora UniFi<\/strong>: <\/p>\n\n\n\n Resultado esperado: <\/p>\n\n\n\n Importante:<\/strong> Passo 10: Repetir a conex\u00e3o via SSH (se necess\u00e1rio)<\/strong> Passo 11: Executar o comando para vincular \u00e0 controladora UniFi<\/strong>: Se a resposta for positiva<\/strong> (por exemplo, uma resposta <\/p>\n\n\n\n Acesse a interface web da sua controladora UniFi (via IP ou dom\u00ednio). Neste passo a passo, vou ensinar como vincular um dispositivo UniFi \u00e0 controladora UniFi. \u00c9 fundamental seguir cada etapa corretamente para garantir que a vincula\u00e7\u00e3o seja realizada com sucesso. Passo 1: Conectar o dispositivo \u00e0 rede localConecte o Access Point (AP), roteador ou outra controladora \u00e0 rede local. Neste exemplo, utilizamos um Mikrotik, mas voc\u00ea […]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","template":"","knowledgebase_cat":[5],"class_list":["post-949","knowledgebase","type-knowledgebase","status-publish","hentry","knowledgebase_cat-tutorias-tecnicos"],"_links":{"self":[{"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/knowledgebase\/949","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/types\/knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/comments?post=949"}],"version-history":[{"count":2,"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/knowledgebase\/949\/revisions"}],"predecessor-version":[{"id":967,"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/knowledgebase\/949\/revisions\/967"}],"wp:attachment":[{"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/media?parent=949"}],"wp:term":[{"taxonomy":"knowledgebase_cat","embeddable":true,"href":"https:\/\/novalink.com.br\/knowledge-base\/wp-json\/wp\/v2\/knowledgebase_cat?post=949"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
No Mikrotik, valide qual endere\u00e7o IP foi atribu\u00eddo ao seu dispositivo UniFi. Para isso, acesse o Terminal<\/strong> e execute o seguinte comando: log print
Ou, se preferir, verifique diretamente na aba Log<\/strong> da interface gr\u00e1fica. Procure por entradas relacionadas ao novo dispositivo conectado.<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-1024x545.png\")
<\/figure>\n\n\n\n
No meu caso, o Mikrotik atribuiu o IP 192.168.20.88<\/strong> ao dispositivo UniFi. Na sua rede, esse endere\u00e7o pode ser diferente \u2014 verifique conforme explicado no passo anterior.
Agora, vamos acessar o dispositivo UniFi via SSH<\/strong>, utilizando o IP atribu\u00eddo, para realizar a vincula\u00e7\u00e3o com a controladora UniFi.<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-1-1024x518.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-2.png\")
<\/figure>\n\n\n\n
Abra o terminal SSH de sua prefer\u00eancia \u2014 pode ser o Termius<\/strong>, PuTTY<\/strong>, PowerShell<\/strong>, Terminal do Linux\/macOS<\/strong>, entre outros.Conforme mostrado na imagem abaixo, insira o endere\u00e7o IP do dispositivo UniFi (neste exemplo: 192.168.20.88<\/code>) e conecte utilizando a porta padr\u00e3o 22<\/strong>.
Exemplo de comando no terminal:<\/strong> ssh ubnt@192.168.20.88 -p22 Enter<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-3.png\")
<\/figure>\n\n\n\nssh-rsa<\/code> e ssh-dss<\/code>, por padr\u00e3o que ainda s\u00e3o usados por dispositivos UniFi mais antigos (ou sem atualiza\u00e7\u00e3o de firmware). Nesse caso vamos mudar a abordagem.<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-4.png\")
<\/figure>\n\n\n\n
Para acessar o dispositivo UniFi, copie e cole o comando abaixo no terminal. Apenas substitua o IP 192.168.20.88<\/code> pelo IP que seu equipamento recebeu na rede local.<\/strong>
ssh -oHostKeyAlgorithms=+ssh-rsa -oPubkeyAcceptedKeyTypes=+ssh-rsa ubnt@192.168.20.88 -p22
Observa\u00e7\u00e3o:<\/strong>
Esse comando for\u00e7a o uso do algoritmo ssh-rsa<\/code>, necess\u00e1rio para se conectar a alguns dispositivos UniFi com vers\u00f5es de firmware mais antigas.<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-5.png\")
<\/figure>\n\n\n\n
Pressione Enter<\/strong>.<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-6.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-7.png\")
<\/figure>\n\n\n\n
O terminal solicitar\u00e1 a senha do dispositivo.
Credenciais padr\u00e3o UniFi (caso n\u00e3o tenham sido alteradas):<\/strong>
Usu\u00e1rio:<\/strong> ubnt<\/code>
Senha:<\/strong> ubnt<\/code> Digite a senha e pressione Enter<\/strong> novamente.<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-8.png\")
<\/figure>\n\n\n\n
curl -v http:\/\/190.89.95.181:8080\/inform<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-9.png\")
<\/figure>\n\n\n\n
Se a resposta for “Connection refused”<\/strong> ou “connection closed”<\/strong>, conforme ilustrado na imagem acima, pode haver alguma configura\u00e7\u00e3o personalizada na controladora impedindo a autentica\u00e7\u00e3o.
Caso a resposta seja “closed” ou “refused”, execute o seguinte comando para for\u00e7ar a vincula\u00e7\u00e3o:
set-default
<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-10.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-11.png\")
<\/figure>\n\n\n\n
Ap\u00f3s digitar o comando set-inform<\/code>, o dispositivo pode reiniciar automaticamente<\/strong> ou realizar um reset de f\u00e1brica parcial<\/strong>, dependendo do firmware e do estado atual de ado\u00e7\u00e3o.
\u26a0\ufe0f Aten\u00e7\u00e3o:<\/strong>
Voc\u00ea poder\u00e1 perder temporariamente a comunica\u00e7\u00e3o com o dispositivo<\/strong> via SSH. Isso \u00e9 normal \u2014 significa que o equipamento est\u00e1 se preparando para ser adotado pela controladora.<\/p>\n\n\n\n
Caso o IP tenha mudado, atualize o comando SSH com o novo endere\u00e7o:<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-12.png\")
<\/figure>\n\n\n\n
set-inform http:\/\/190.89.95.181:8080\/inform<\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-13.png\")
<\/figure>\n\n\n\nHTTP\/1.1 200 OK<\/code>), significa que o AP est\u00e1 conseguindo alcan\u00e7ar a controladora.Assim que voc\u00ea estiver conectado via SSH ao dispositivo UniFi, a tela do terminal indicar\u00e1 que o acesso foi bem-sucedido. Agora, precisamos informar ao equipamento o endere\u00e7o da controladora UniFi.
Passo 11: Finalizar a ado\u00e7\u00e3o do dispositivo na controladora UniFi<\/strong><\/p>\n\n\n\n![\"\"](\"https:\/\/novalink.com.br\/knowledge-base\/wp-content\/uploads\/2025\/05\/image-14-1024x436.png\")
<\/figure>\n\n\n\n
Na tela inicial, v\u00e1 at\u00e9 a aba “Dispositivos”<\/strong>.
Verifique se o Access Point (ou outro dispositivo UniFi) aparece com o status “Adopting”<\/strong> ou “Pending Adoption”<\/strong>.
Clique em “Adotar”<\/strong> (Adopt<\/em>).
O processo de ado\u00e7\u00e3o ser\u00e1 iniciado.
Assim que o dispositivo for adotado, aguarde a atualiza\u00e7\u00e3o autom\u00e1tica do firmware, se necess\u00e1rio.
<\/p>\n","protected":false},"excerpt":{"rendered":"