O TP-Link Omada continua a poder ser instalado no CasaOS através da loja mantida pelo BigBearCasaOS, mas o pacote é mantido pela comunidade e não é uma imagem Docker oficial da TP-Link. Em 2026, o BigBearCasaOS lista o TP-Link Omada Controller 6.2, que utiliza mbentley/omada-controller.
Isto significa que deve considerar os requisitos e as notas de lançamento do controlador da TP-Link como a fonte de informação fidedigna sobre o produto, utilizando o manifesto do BigBear apenas como camada de empacotamento do CasaOS.
Adicione a loja atual do BigBearCasaOS
A loja de aplicações do BigBearCasaOS atual lista o ficheiro ZIP da App Store e o pacote Omada atual.
Instale a aplicação Omada Controller
Depois de adicionar a loja, procure TP-Link Omada Controller, verifique a imagem/versão e instale-a. Registe as pastas de configuração/dados associadas antes de fazer atualizações posteriores.
A TP-Link suporta Linux, mas não esta imagem Docker diretamente
A lista atual de requisitos do Omada Software Controller da TP-Link indica as plataformas x64 suportadas para Windows/Linux. A imagem Docker utilizada pelo BigBear é mantida separadamente.
Mantenha os dados do controlador persistentes
A base de dados do controlador contém sites, dispositivos adotados, definições, utilizadores e histórico. Antes de confiar a sua rede ao BigBear, confirme que este associa os diretórios de dados/registos do controlador ao armazenamento persistente do CasaOS.
Utilize um IP de LAN estável
Reserve o IP do servidor CasaOS no DHCP. Os dispositivos Omada e os administradores não devem ter de procurar um endereço de controlador que muda após os reinícios do router.
Faça uma cópia de segurança antes de atualizar as versões do controlador
Exporte uma cópia de segurança do controlador Omada e proteja os dados persistentes do contentor antes de uma atualização importante. As alterações ao esquema do controlador de rede podem ser mais difíceis de reverter do que uma atualização normal de uma aplicação Web.
Verifique as portas de adoção e descoberta
Se a interface Web abrir, mas os dispositivos Omada não forem detetados nem adotados, o modo de rede do contentor e as portas necessárias do Omada são importantes. Compare o manifesto do BigBear com a documentação atual do controlador da TP-Link, em vez de abrir portas aleatórias.
Não exponha diretamente a interface de administração
Utilize o acesso à LAN, uma VPN ou o acesso à cloud suportado pelo controlador, em vez de reencaminhar diretamente portas da Internet para a interface de gestão.
O guia de aplicações Docker também se aplica aos pacotes da comunidade do CasaOS.
Verifique a versão atual do controlador antes da adoção
Os dispositivos Omada e as versões do controlador precisam de firmware compatível. Antes de adotar um novo gateway, switch ou ponto de acesso, compare os requisitos de firmware com a versão do controlador incluída no BigBear.
Garanta que o anfitrião do controlador está acessível a partir das VLANs de gestão
Se os seus dispositivos Omada estiverem noutra VLAN, as regras de encaminhamento e da firewall têm de permitir o tráfego necessário para a descoberta e adoção. O facto de o painel Web funcionar na LAN do CasaOS não prova que os dispositivos geridos consigam aceder ao controlador.
Exporte uma cópia de segurança do controlador após alterações importantes
Depois de adotar dispositivos, alterar WLANs ou reconstruir VLANs, exporte uma nova cópia de segurança do Omada. Assim, terá um ponto de recuperação após alterações à configuração, e não apenas antes de atualizar o software.
Perguntas frequentes
A imagem Omada do BigBear é software oficial da TP-Link?
O pacote inclui o controlador da TP-Link numa imagem Docker da comunidade; a própria TP-Link documenta o suporte nativo para controladores em Linux e Windows.
Que versão está atualmente no BigBearCasaOS?
O repositório atual indica o Omada Controller 6.2.
Devo fazer uma cópia de segurança antes de atualizar?
Sim. Exporte a configuração do controlador e proteja primeiro os dados persistentes.
Porque é que a interface funciona, mas os dispositivos não são adotados?
Verifique as portas necessárias para a descoberta e adoção do Omada, o modo de rede, o encaminhamento de VLANs e o percurso de descoberta do controlador pelo dispositivo.
