TP-Link Omada kann weiterhin über den gepflegten BigBearCasaOS-Store auf CasaOS installiert werden, das Paket wird jedoch von der Community gepflegt und ist kein offizielles Docker-Image von TP-Link. Im Jahr 2026 führt BigBearCasaOS den TP-Link Omada Controller 6.2 mit mbentley/omada-controller.
Das bedeutet, dass du die Anforderungen und Versionshinweise von TP-Link für den Controller als maßgebliche Produktquelle betrachten solltest, während du das BigBear-Manifest nur als CasaOS-Paketierungsschicht verwendest.
Den aktuellen BigBearCasaOS-Store hinzufügen
Der aktuelle BigBearCasaOS-App-Store führt seine App-Store-ZIP-Datei und das aktuelle Omada-Paket.
Die Omada-Controller-App installieren
Nachdem du den Store hinzugefügt hast, suche nach TP-Link Omada Controller, überprüfe Image und Version und installiere die App. Notiere die zugeordneten Konfigurations- und Datenordner, bevor du spätere Aktualisierungen durchführst.
TP-Link unterstützt Linux, aber dieses Docker-Image nicht direkt
Die aktuellen Anforderungen für den Omada Software Controller von TP-Link führen unterstützte x64-Windows-/Linux-Plattformen auf. Das von BigBear verwendete Docker-Image wird unabhängig davon gepflegt.
Controller-Daten dauerhaft speichern
Die Controller-Datenbank enthält Standorte, übernommene Geräte, Einstellungen, Benutzer und den Verlauf. Vergewissere dich, dass BigBear die Daten- und Protokollverzeichnisse des Controllers auf dauerhaften CasaOS-Speicher abbildet, bevor du ihm dein Netzwerk anvertraust.
Eine stabile LAN-IP verwenden
Reserviere die IP-Adresse des CasaOS-Servers in DHCP. Omada-Geräte und Administratoren sollten nach einem Neustart des Routers nicht einer wechselnden Controller-Adresse hinterherlaufen müssen.
Vor Upgrades der Controller-Version eine Sicherung erstellen
Exportiere vor einem größeren Upgrade eine Sicherung des Omada-Controllers und sichere die dauerhaften Container-Daten. Änderungen am Schema eines Netzwerk-Controllers lassen sich möglicherweise schwieriger rückgängig machen als ein normales Web-App-Update.
Übernahme- und Erkennungsports prüfen
Wenn die Weboberfläche geöffnet wird, Omada-Geräte jedoch nicht erkannt oder übernommen werden, sind der Netzwerkmodus des Containers und die erforderlichen Omada-Ports entscheidend. Vergleiche das BigBear-Manifest mit der aktuellen Controller-Dokumentation von TP-Link, anstatt wahllos Ports zu öffnen.
Die Administrationsoberfläche nicht direkt ins Internet stellen
Verwende den LAN-Zugriff, ein VPN oder den unterstützten Cloud-Zugriff des Controllers, statt die Managementoberfläche über eine direkte Weiterleitung von Internet-Ports bereitzustellen.
Der Docker-App-Leitfaden gilt auch für Community-Pakete von CasaOS.
Vor der Übernahme die aktuelle Controller-Version prüfen
Omada-Geräte und Controller-Versionen benötigen kompatible Firmware. Vergleiche vor der Übernahme eines neuen Gateways, Switches oder Access Points dessen Firmware-Anforderungen mit der von BigBear paketierten Controller-Version.
Sicherstellen, dass der Controller-Host aus den Management-VLANs erreichbar ist
Wenn sich deine Omada-Geräte in einem anderen VLAN befinden, müssen Routing und Firewall-Regeln den erforderlichen Datenverkehr für Erkennung und Übernahme zulassen. Ein funktionierendes Web-Dashboard im CasaOS-LAN beweist nicht, dass verwaltete Geräte den Controller erreichen können.
Nach größeren Änderungen eine Controller-Sicherung exportieren
Exportiere nach der Übernahme von Geräten, Änderungen an WLANs oder dem Neuaufbau von VLANs eine aktuelle Omada-Sicherung. So erhältst du nach Konfigurationsänderungen einen Wiederherstellungspunkt und nicht nur vor Software-Upgrades.
FAQ
Ist das BigBear-Omada-Image offizielle TP-Link-Software?
Es paketiert den Controller von TP-Link in einem Community-Docker-Image. TP-Link selbst dokumentiert die native Controller-Unterstützung für Linux und Windows.
Welche Version ist derzeit in BigBearCasaOS enthalten?
Das aktuelle Repository führt Omada Controller 6.2.
Sollte ich vor der Aktualisierung eine Sicherung erstellen?
Ja. Exportiere zuerst die Controller-Konfiguration und sichere die dauerhaften Daten.
Warum funktioniert die Benutzeroberfläche, aber die Geräte werden nicht übernommen?
Prüfe die erforderlichen Omada-Ports für Erkennung und Übernahme, den Netzwerkmodus, das VLAN-Routing und den Controller-Erkennungspfad des Geräts.
