TP-Link Omada lässt sich weiterhin über den gepflegten BigBearCasaOS-Store auf CasaOS installieren, aber das Paket wird von der Community und nicht von TP-Link selbst gepflegt und ist kein offizielles TP-Link-Docker-Image. Im Jahr 2026 führt BigBearCasaOS TP-Link Omada Controller 6.2 mit mbentley/omada-controller auf.
Das bedeutet: Betrachte die Controller-Anforderungen und Versionshinweise von TP-Link als maßgebliche Produktquelle und nutze das Manifest von BigBear lediglich als CasaOS-Verpackungsschicht.
Aktuellen BigBearCasaOS-Store hinzufügen
Der aktuelle BigBearCasaOS-App-Store listet seine App-Store-ZIP-Datei und das aktuelle Omada-Paket auf.
Omada Controller-App installieren
Suche nach dem Hinzufügen des Stores nach TP-Link Omada Controller, prüfe das Image und die Version und installiere die App. Notiere dir die zugeordneten Konfigurations- und Datenordner, bevor du später Updates durchführst.
TP-Link unterstützt Linux, aber nicht direkt dieses Docker-Image
Die aktuellen Anforderungen an den Omada Software Controller von TP-Link führen unterstützte x64-Plattformen für Windows und Linux auf. Das von BigBear verwendete Docker-Image wird separat gepflegt.
Controller-Daten persistent speichern
Die Controller-Datenbank enthält Standorte, eingebundene Geräte, Einstellungen, Benutzer und den Verlauf. Stelle sicher, dass BigBear die Daten- und Protokollverzeichnisse des Controllers persistentem CasaOS-Speicher zuordnet, bevor du ihm dein Netzwerk anvertraust.
Eine stabile LAN-IP-Adresse verwenden
Reserviere die IP-Adresse des CasaOS-Servers per DHCP. Omada-Geräte und Administratoren sollten nach einem Router-Neustart nicht erst die neue Controller-Adresse suchen müssen.
Vor dem Upgrade der Controller-Version ein Backup erstellen
Exportiere vor einem größeren Upgrade ein Backup des Omada Controllers und sichere die persistenten Containerdaten. Änderungen am Schema eines Netzwerkcontrollers lassen sich möglicherweise schwerer rückgängig machen als ein normales Update einer Web-App.
Adoptions- und Discovery-Ports prüfen
Wenn sich die Web-Benutzeroberfläche öffnen lässt, Omada-Geräte aber nicht erkannt oder übernommen werden, sind der Netzwerkmodus des Containers und die erforderlichen Omada-Ports entscheidend. Vergleichen Sie das BigBear-Manifest mit der aktuellen TP-Link-Controller-Dokumentation, anstatt wahllos Ports zu öffnen.
Die Admin-Oberfläche nicht direkt dem Internet aussetzen
Verwenden Sie den LAN-Zugriff, ein VPN oder den unterstützten Cloud-Zugriff des Controllers, anstatt die Verwaltungsoberfläche über eine direkte Portweiterleitung aus dem Internet zugänglich zu machen.
Der Docker-App-Leitfaden gilt auch für CasaOS-Community-Pakete.
Vor der Übernahme die aktuelle Controller-Version prüfen
Omada-Geräte und Controller-Versionen benötigen kompatible Firmware. Vergleichen Sie vor der Übernahme eines neuen Gateways, Switches oder Access Points dessen Firmware-Anforderungen mit der von BigBear bereitgestellten Controller-Version.
Sicherstellen, dass der Controller-Host aus den Verwaltungs-VLANs erreichbar ist
Wenn sich Ihre Omada-Geräte in einem anderen VLAN befinden, müssen Routing und Firewall-Regeln den erforderlichen Erkennungs- und Übernahmeverkehr zulassen. Ein funktionierendes Web-Dashboard im CasaOS-LAN bedeutet nicht, dass verwaltete Geräte den Controller erreichen können.
Controller-Backup nach größeren Änderungen exportieren
Exportieren Sie nach der Übernahme von Geräten, Änderungen an WLANs oder dem Neuaufbau von VLANs ein aktuelles Omada-Backup. So haben Sie nach Konfigurationsänderungen einen Wiederherstellungspunkt und nicht nur vor Software-Upgrades.
FAQ
Ist das Omada-Image von BigBear offizielle TP-Link-Software?
Das Paket enthält 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 gibt es jetzt in BigBearCasaOS?
Das aktuelle Repository führt Omada Controller 6.2 auf.
Sollte ich vor der Aktualisierung ein Backup erstellen?
Ja. Exportieren Sie zuerst die Controller-Konfiguration und sichern Sie die persistenten Daten.
Warum funktioniert die Benutzeroberfläche, aber die Geräte werden nicht übernommen?
Prüfen Sie die erforderlichen Omada-Ports für Erkennung und Übernahme, den Netzwerkmodus, das VLAN-Routing und den Erkennungspfad des Controllers für das Gerät.
