O TP-Link Omada ainda pode ser instalado no CasaOS através da loja BigBearCasaOS mantida pela comunidade, mas o pacote é mantido pela comunidade e não é uma imagem Docker oficial da TP-Link. Em 2026, a BigBearCasaOS apresenta o TP-Link Omada Controller 6.2 utilizando mbentley/omada-controller.
Isto significa que deve considerar os requisitos e as notas de lançamento do controlador da TP-Link como a fonte oficial de informação sobre o produto, utilizando o manifesto da BigBear apenas como camada de empacotamento para o CasaOS.
Adicionar a loja BigBearCasaOS atual
A atual loja de aplicações BigBearCasaOS apresenta o ZIP da loja de aplicações e o pacote Omada atual.
Instalar a aplicação Omada Controller
Depois de adicionar a loja, procure por TP-Link Omada Controller, verifique a imagem e a versão e instale-a. Registe as pastas de configuração/dados mapeadas antes de efetuar atualizações posteriores.
A TP-Link suporta Linux, mas não esta imagem Docker diretamente
Os atuais requisitos do Omada Software Controller da TP-Link indicam plataformas x64 Windows/Linux suportadas. A imagem Docker utilizada pela BigBear é mantida separadamente.
Manter os dados do controlador persistentes
A base de dados do controlador contém sites, dispositivos adotados, definições, utilizadores e histórico. Confirme que a BigBear mapeia os diretórios de dados/registos do controlador para armazenamento persistente do CasaOS antes de confiar-lhe a sua rede.
Utilizar um IP 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 diferente após reinícios do router.
Fazer 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.
Verificar as portas de adoção e descoberta
Se a interface web abrir, mas os dispositivos Omada não forem descobertos ou adotados, o modo de rede do contentor e as portas Omada necessárias são importantes. Compare o manifesto da BigBear com a documentação atual do controlador da TP-Link, em vez de abrir portas aleatórias.
Não expor diretamente a interface de administração
Utilize o acesso pela LAN, uma VPN ou o acesso à nuvem 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 comunitários do CasaOS.
Verificar a versão atual do controlador antes da adoção
Os dispositivos Omada e as versões do controlador necessitam de firmware compatível. Antes de adotar um novo gateway, switch ou ponto de acesso, compare os respetivos requisitos de firmware com a versão do controlador empacotada pela BigBear.
Manter o anfitrião do controlador 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 descoberta/adoção. Um painel web funcional na LAN do CasaOS não prova que os dispositivos geridos conseguem alcançar o controlador.
Exportar uma cópia de segurança do controlador após alterações importantes
Depois de adotar dispositivos, alterar WLANs ou recriar VLANs, exporte uma nova cópia de segurança do Omada. Isto proporciona um ponto de recuperação após alterações de configuração, e não apenas antes de atualizações de software.
FAQ
A imagem Omada da BigBear é software oficial da TP-Link?
Empacota o controlador da TP-Link numa imagem Docker comunitária; a própria TP-Link documenta o suporte nativo do controlador em Linux/Windows.
Que versão está atualmente na BigBearCasaOS?
O repositório atual apresenta o Omada Controller 6.2.
Devo fazer uma cópia de segurança antes de atualizar?
Sim. Exporte primeiro a configuração do controlador e proteja os dados persistentes.
Porque é que a interface funciona, mas os dispositivos não são adotados?
Verifique as portas Omada necessárias para descoberta/adoção, o modo de rede, o encaminhamento entre VLANs e o caminho de descoberta do controlador configurado no dispositivo.
