TP-Link Omada peut toujours être installé sur CasaOS via le magasin BigBearCasaOS maintenu par la communauté, mais le paquet est maintenu par la communauté et ne constitue pas une image Docker officielle de TP-Link. En 2026, BigBearCasaOS répertorie TP-Link Omada Controller 6.2 utilisant mbentley/omada-controller.
Vous devez donc considérer les exigences et les notes de version de TP-Link comme la source de référence sur le produit, et n’utiliser le manifeste BigBear que comme couche de paquetage pour CasaOS.
Ajouter le magasin BigBearCasaOS actuel
Le magasin d’applications BigBearCasaOS actuel répertorie son fichier ZIP App Store et le paquet Omada actuel.
Installer l’application Omada Controller
Après avoir ajouté le magasin, recherchez TP-Link Omada Controller, vérifiez l’image et la version, puis installez-le. Notez les dossiers de configuration et de données associés avant d’effectuer de futures mises à jour.
TP-Link prend en charge Linux, mais pas directement cette image Docker
La page actuelle des exigences d’Omada Software Controller de TP-Link indique les plateformes x64 Windows/Linux prises en charge. L’image Docker utilisée par BigBear est maintenue séparément.
Conserver les données du contrôleur de façon persistante
La base de données du contrôleur contient les sites, les appareils adoptés, les paramètres, les utilisateurs et l’historique. Avant de lui confier votre réseau, vérifiez que BigBear associe les répertoires de données et de journaux du contrôleur à un stockage CasaOS persistant.
Utiliser une adresse IP LAN stable
Réservez l’adresse IP du serveur CasaOS dans le DHCP. Les appareils Omada et les administrateurs ne devraient pas avoir à rechercher une adresse de contrôleur qui change après le redémarrage du routeur.
Sauvegarder avant de mettre à niveau le contrôleur
Exportez une sauvegarde du contrôleur Omada et protégez les données persistantes du conteneur avant une mise à niveau majeure. Les modifications du schéma d’un contrôleur réseau peuvent être plus difficiles à annuler que celles d’une mise à jour classique d’application Web.
Vérifier les ports d’adoption et de découverte
Si l’interface Web s’ouvre, mais que les appareils Omada ne sont ni détectés ni adoptés, le mode réseau du conteneur et les ports Omada requis sont importants. Comparez le manifeste BigBear à la documentation actuelle de TP-Link sur le contrôleur plutôt que d’ouvrir des ports au hasard.
N’exposez pas directement l’interface d’administration
Utilisez l’accès au réseau local, un VPN ou la fonction d’accès cloud prise en charge par le contrôleur plutôt qu’une redirection brute de ports Internet vers l’interface de gestion.
Le guide des applications Docker s’applique également aux paquets communautaires CasaOS.
Vérifiez la version actuelle du contrôleur avant l’adoption
Les appareils Omada et les versions du contrôleur doivent utiliser des micrologiciels compatibles. Avant d’adopter une nouvelle passerelle, un nouveau commutateur ou un nouveau point d’accès, vérifiez que la configuration requise par son micrologiciel correspond à la version du contrôleur fournie par BigBear.
Assurez l’accessibilité de l’hôte du contrôleur depuis les VLAN de gestion
Si vos appareils Omada se trouvent sur un autre VLAN, le routage et les règles du pare-feu doivent autoriser le trafic requis pour la découverte et l’adoption. Le bon fonctionnement du tableau de bord Web sur le réseau local CasaOS ne prouve pas que les appareils gérés peuvent atteindre le contrôleur.
Exporter une sauvegarde du contrôleur après les modifications importantes
Après avoir adopté des appareils, modifié des réseaux WLAN ou recréé des VLAN, exportez une nouvelle sauvegarde Omada. Vous disposez ainsi d’un point de restauration après les modifications de configuration, et pas seulement avant les mises à niveau logicielles.
FAQ
L’image BigBear Omada est-elle un logiciel officiel de TP-Link ?
Il regroupe le contrôleur de TP-Link dans une image Docker communautaire ; TP-Link documente lui-même la prise en charge native du contrôleur sous Linux/Windows.
Quelle version figure actuellement dans BigBearCasaOS ?
Le dépôt actuel répertorie Omada Controller 6.2.
Dois-je effectuer une sauvegarde avant la mise à jour ?
Oui. Exportez d’abord la configuration du contrôleur et protégez les données persistantes.
Pourquoi l’interface fonctionne-t-elle, mais pas l’adoption des appareils ?
Vérifiez les ports requis pour la découverte et l’adoption Omada, le mode réseau, le routage VLAN et le chemin de découverte du contrôleur par l’appareil.
