Como atualizar o firmware das antenas Ubiquiti (UniFi)

Audere Comércio em TI
17 de ago. de 2020
4 min de leitura

Atualizado: 21 de dez. de 2025

Como atualizar o firmware das antenas Ubiquiti (UniFi)

Manter o firmware das antenas e dispositivos Ubiquiti UniFi atualizado é essencial para garantir segurança, desempenho, estabilidade e compatibilidade com novas funcionalidades. Neste artigo, você confere um guia completo sobre como realizar upgrade ou downgrade de firmware em dispositivos UniFi, como Access Points, Switches, Gateways (USG) e UDM, utilizando diferentes métodos.

Visão geral

Este artigo descreve como atualizar ou reverter versões de firmware em dispositivos UniFi, abordando:

Atualização simples para a versão mais recente via UniFi Network Controller
Alteração manual do firmware (inclusive versões antigas ou não lançadas)
Atualização via cache de firmware
Atualização local via SSH
Procedimentos específicos para USG e UniFi Dream Machine (UDM)

⚠️ Importante: este conteúdo trata da atualização do firmware dos dispositivos, não do software do UniFi Network Controller ou Cloud Key.

Notas e requisitos importantes

Caso você utilize uma versão de firmware diferente da disponibilizada automaticamente pelo controlador, desative as atualizações automáticas no UniFi Network Controller.
Atualizações agendadas podem reverter o firmware para a versão padrão da CDN da Ubiquiti, desde que o controlador tenha acesso à internet.

Atualização simples para a versão de firmware mais recente

A forma mais comum de atualização é diretamente pelo UniFi Network Controller.

Passo a passo:

Acesse o UniFi Network Controller
Vá até Devices
Quando houver uma atualização disponível, aparecerá a opção Upgrade ao passar o mouse sobre o dispositivo
- Na visualização em lista: botão Upgrade
- Na visualização em grade: ícone de atualização no canto superior direito

Rolling Upgrade (atualização contínua – dispositivos wireless)

Para pontos de acesso sem fio:

Acesse Devices > Wireless
Clique em Start Rolling Upgrade
O controlador atualizará os APs de forma gradual, evitando indisponibilidade total da rede

Quando usar atualização manual de firmware?

Você pode precisar alterar manualmente o firmware quando:

Precisar de uma versão mais antiga
Testar um firmware em desenvolvimento
Resolver problemas de adoção
Realizar testes controlados antes de atualizar todo o ambiente

É possível executar versões diferentes de firmware por tipo de dispositivo ou por local (site).

Alterando o firmware pela interface web do UniFi Controller

Dispositivos com acesso à Internet

Mesmo dispositivos não adotados podem ser atualizados antes da adoção
Para dispositivos adotados:
1. Vá em Devices
2. Clique no dispositivo
3. Acesse Config > Manage Device > Custom Upgrade
4. Cole o Direct URL do firmware desejado

Onde encontrar o firmware:

Página oficial Downloads da Ubiquiti
Seção Firmware
Comunidade Ubiquiti (Releases)

⚠️ Atenção: APs e Switches usam arquivos .bin USGs usam arquivos .tar Nunca utilize arquivos de software (.exe, .pkg, .deb)

💡 Dica:Se estiver atualizando a partir da versão 3.7.56 ou anterior, utilize http:// em vez de https://

Dispositivos sem acesso à Internet – Firmware em cache

Se os dispositivos não têm acesso à internet, mas o controlador tem, é possível usar o cache de firmware.

Passo a passo:

Acesse Settings > Maintenance > Firmware
Vá até a aba All
Selecione o firmware desejado
Clique em Cache
Após o cache, vá em Devices
A opção Upgrade aparecerá para o dispositivo

Esse método também ajuda quando atualizações diretas falham.

Atualização local de firmware via SSH

Aplicável para: UniFi AP e UniFi Switch

Com acesso à Internet:

upgrade https://dl.ui.com/path/to/upgrade-vX.Y.Z.bin

O dispositivo fará o download, aplicará a atualização e reiniciará automaticamente.

Sem acesso à Internet:

Baixe o firmware correto (.bin)
Envie o arquivo para o dispositivo:

scp /caminho/firmware.bin usuario@IP_DO_DISPOSITIVO:/tmp/fwupdate.bin

Conecte-se via SSH
Execute:

syswrapper.sh upgrade2 &

💡 Dica:Se aparecer erro de Firmware inválido, exclua o arquivo em /tmp e tente novamente.

Atualização do UniFi Security Gateway (USG)

Atualização via Internet:

upgrade https://dl.ui.com/path/to/upgrade-vX.Y.Z.tar

Atualização offline:

scp upgrade-vX.Y.Z.tar usuario@IP_DO_USG:~/upgrade.tar
sudo syswrapper.sh upgrade upgrade.tar

Atualização do UniFi Dream Machine (UDM / UDM Pro)

Atualização direta via URL:

ubnt-upgrade https://fw-download.ubnt.com/data/udm/arquivo.bin

Atualização local:

Envie o arquivo .bin para /mnt/data/
Execute:

ubnt-upgrade /mnt/data/firmware-name.bin

Conclusão

A atualização de firmware dos dispositivos Ubiquiti UniFi é um processo essencial para manter sua rede segura, estável e performática. Seja via interface gráfica, cache, ou SSH, escolher o método correto garante menos riscos e maior controle sobre o ambiente.

Se você não tem certeza sobre qual firmware utilizar ou deseja evitar indisponibilidades, o ideal é contar com suporte especializado.

👉 A Audere oferece suporte técnico Ubiquiti com contratos mensais ou atendimentos avulsos, ajudando desde a atualização segura de firmware até o gerenciamento completo da sua infraestrutura de rede.

Fale com um de nossos especialistas

Compartilhe

🌟 Descubra um mundo de inovação e conhecimento! 🚀✨ Siga-nos nas nossas redes sociais e faça parte de uma comunidade apaixonada por tecnologia. No Instagram, oferecemos inspiração diária e bastidores exclusivos. No LinkedIn, mergulhe em artigos e conteúdos profissionais sobre as últimas tendências. Em nosso canal no YouTube, você terá acesso a vídeos incríveis e tutoriais envolventes. E, é claro, no Facebook, junte-se a conversas animadas e novidades fresquinhas! Não perca essa oportunidade de estar por dentro de tudo o que acontece. Siga-nos agora e seja um Auderiano! 🌐👍