TP-Link Omada peut toujours être installé sur CasaOS via la boutique BigBearCasaOS maintenue, mais le paquet est maintenu par la communauté plutôt qu’une image Docker officielle de TP-Link. En 2026, BigBearCasaOS répertorie le contrôleur TP-Link Omada 6.2 utilisant mbentley/omada-controller.
Cela signifie que vous devez considérer les exigences et les notes de version du contrôleur de TP-Link comme la source de référence, et utiliser le manifeste de BigBear uniquement comme couche de paquetage pour CasaOS.
Ajouter la boutique BigBearCasaOS actuelle
La boutique d’applications BigBearCasaOS actuelle répertorie son fichier ZIP de boutique d’applications ainsi que le paquet Omada actuel.
Installer l’application Omada Controller
Après avoir ajouté la boutique, recherchez TP-Link Omada Controller, vérifiez l’image et la version, puis installez-la. Notez les dossiers de configuration et de données associés avant d’effectuer des mises à jour ultérieures.
TP-Link prend en charge Linux, mais pas directement cette image Docker
Les exigences du contrôleur logiciel Omada de TP-Link répertorient 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 manière persistante
La base de données du contrôleur contient les sites, les appareils adoptés, les paramètres, les utilisateurs et l’historique. Vérifiez que BigBear associe les répertoires de données et de journaux du contrôleur à un stockage CasaOS persistant avant de lui confier votre réseau.
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 à suivre une adresse de contrôleur qui change après le redémarrage du routeur.
Sauvegarder avant de mettre à niveau la version du 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 de schéma d’un contrôleur réseau peuvent être plus difficiles à annuler que la mise à jour d’une application web classique.
Vérifier les ports d’adoption et de découverte
Si l’interface web s’ouvre, mais que les appareils Omada ne sont pas détectés ou adoptés, le mode réseau du conteneur et les ports Omada requis sont importants. Comparez le manifeste BigBear avec la documentation actuelle du contrôleur TP-Link plutôt que d’ouvrir des ports au hasard.
Ne pas exposer directement l’interface d’administration
Utilisez un accès LAN, un VPN ou l’accès cloud pris en charge par le contrôleur plutôt qu’une redirection de port brute depuis Internet vers l’interface de gestion.
Le guide des applications Docker s’applique également aux paquets communautaires CasaOS.
Vérifier la version actuelle du contrôleur avant l’adoption
Les appareils Omada et les versions du contrôleur doivent disposer de micrologiciels compatibles. Avant d’adopter une nouvelle passerelle, un nouveau commutateur ou un nouveau point d’accès, comparez ses exigences de micrologiciel avec la version du contrôleur fournie par BigBear.
Garder l’hôte du contrôleur accessible 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 fonctionnement du tableau de bord web sur le LAN CasaOS ne prouve pas que les appareils gérés peuvent atteindre le contrôleur.
Exporter une sauvegarde du contrôleur après les changements importants
Après avoir adopté des appareils, modifié les réseaux WLAN ou reconfiguré les VLAN, exportez une nouvelle sauvegarde Omada. Vous disposerez ainsi d’un point de restauration après les modifications de configuration, et pas uniquement avant les mises à niveau logicielles.
FAQ
L’image Omada de BigBear est-elle un logiciel officiel de TP-Link ?
Elle intègre le contrôleur de TP-Link dans une image Docker communautaire ; TP-Link documente lui-même la prise en charge native des contrôleurs Linux/Windows.
Quelle version se trouve actuellement dans BigBearCasaOS ?
Le dépôt actuel répertorie Omada Controller 6.2.
Dois-je sauvegarder 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 alors que les appareils ne sont pas adoptés ?
Vérifiez les ports Omada requis pour la découverte et l’adoption, le mode réseau, le routage VLAN ainsi que le chemin de découverte du contrôleur utilisé par l’appareil.
