Installieren Sie den TP-Link Omada Controller in CasaOS als persistenten Docker-Dienst und bewahren Sie seine Verzeichnisse für Daten, Arbeitsdateien und Protokolle auf. Das alte Tutorial von 2023 ist weiterhin grundsätzlich hilfreich, aber das gepflegte Image mbentley/omada-controller wurde weiterentwickelt, und aktuelle Bereitstellungen müssen mehrere TCP- und UDP-Ports für Erkennung, Bereitstellung, Verwaltung und Captive-Portal-Funktionen freigeben.
Betrachten Sie Omada nicht als Web-App mit nur einem Port. Die Weboberfläche kann erfolgreich geöffnet werden, während Erkennung und Gerätebereitstellung fehlschlagen, weil UDP- oder Verwaltungsports fehlen.
Ein gepflegtes Omada-Docker-Image verwenden
Das aktuelle Docker-Image des Omada-Controllers wird aktiv gepflegt und enthält aktuelle Hinweise zu Upgrades.
Alle drei wichtigen Datenpfade dauerhaft speichern
Das Image dokumentiert persistente Volumes für:
/opt/tplink/EAPController/data/opt/tplink/EAPController/work/opt/tplink/EAPController/logs
Binden Sie diese an CasaOS-AppData-Ordner, damit Upgrades den Controller-Zustand nicht löschen.
Erforderliche Ports freigeben
Omada verwendet mehr als nur die Verwaltungsoberfläche. Die aktuelle Container-Dokumentation enthält unter anderem folgende Ports:
- 8043/TCP für die HTTPS-Verwaltung;
- 8088/TCP für die HTTP-Verwaltung;
- 8843/TCP für das HTTPS-Portal;
- 27001/UDP und 29810/UDP für die Erkennung;
- 29811–29817/TCP für die Geräteverwaltung in aktuellen Versionen.
Veröffentlichen Sie nur die von Ihrer Bereitstellung benötigten Dienste, aber lassen Sie Erkennungs- und Bereitstellungsports nicht weg, um anschließend den Controller als fehlerhaft zu diagnostizieren.
Der Bridge-Modus funktioniert in der Regel
Omada-Geräte können über veröffentlichte Host-Ports mit einem Container kommunizieren. Host-Netzwerk oder eine dedizierte macvlan-Adresse sind nicht automatisch erforderlich.
Wenn die Geräteerkennung VLAN-übergreifend fehlschlägt, handelt es sich eher um ein geroutetes Erkennungs- oder Netzwerkdesignproblem als um ein CasaOS-Installationsproblem.
So installieren Sie eine benutzerdefinierte App in CasaOS
- Erstellen Sie eine benutzerdefinierte Docker-App.
- Verwenden Sie das aktuelle
mbentley/omada-controllerimage/tag. - Binden Sie die Verzeichnisse für persistente Daten, Arbeitsdateien und Protokolle ein.
- Veröffentlichen Sie die erforderlichen TCP- und UDP-Ports.
- Legen Sie eine Neustartrichtlinie fest, etwa
unless-stopped. - Starten Sie den Container und öffnen Sie den HTTPS-Verwaltungsport.
Controller vor größeren Upgrades sichern
Upgrades des Omada-Controllers können Datenbankänderungen umfassen. Exportieren Sie vor dem Wechsel auf eine Hauptversion ein Controller-Backup, insbesondere bei Versionen, die Migrationsschritte erfordern.
Verwaltungsports nicht öffentlich zugänglich machen
Halten Sie den Controller in einem vertrauenswürdigen LAN oder privaten VPN. Verwenden Sie den Docker-Bereitstellungsleitfaden für dieselben Prinzipien der Container-Bereitstellung.
Eine stabile Controller-Adresse verwenden
Omada-Geräte müssen den Controller auch nach Neustarts weiterhin finden. Geben Sie dem CasaOS-Server über eine DHCP-Reservierung oder eine sorgfältig verwaltete statische IP-Adresse eine stabile LAN-Adresse. Wenn sich die Hostadresse ändert, können bereits übernommene Geräte weiterhin versuchen, die alte Controller-Adresse zu erreichen.
Die Erkennung über VLANs hinweg kann zusätzliche Netzwerkplanung erfordern
Die lokale Broadcast-Erkennung funktioniert am besten, wenn sich der Controller und neue Omada-Geräte im selben Layer-2-Netzwerk befinden. Wenn Ihre Access Points und der Controller in verschiedenen VLANs liegen, sorgt das einfache Veröffentlichen von Docker-Ports möglicherweise nicht dafür, dass Erkennungs-Broadcasts den Router passieren.
Verwenden Sie in diesem Fall den von TP-Link unterstützten Layer-3-Übernahme-/Inform-Prozess oder konfigurieren Sie Routing- und Firewall-Regeln gezielt. Versuchen Sie nicht, ein VLAN-Routing-Problem durch wiederholte Neuinstallationen des Containers zu lösen.
Java-Speicher auf kleinen CasaOS-Hosts überprüfen
Omada ist eine Java-Anwendung und kann deutlich mehr Speicher verbrauchen als schlanke DNS- oder Dashboard-Container. Das gepflegte Image stellt speicherbezogene Einstellungen bereit, und bei ressourcenbeschränkten Bereitstellungen sollte ausreichend RAM für CasaOS, Docker und andere Dienste freigelassen werden.
Wenn der Container unter Last neu startet, prüfen Sie die Protokolle und den Speicherdruck, bevor Sie annehmen, dass die Datenbank beschädigt ist.
Geräteübernahme nach jedem Upgrade überprüfen
Bestätigen Sie nach jedem größeren Omada-Update, dass die Controller-Oberfläche geöffnet wird, verbundene Geräte weiterhin verbunden sind und die Erkennungs- und Übernahmeports weiterhin veröffentlicht sind. Ein Container, der „läuft“, ist kein ausreichender Beleg dafür, dass die Netzwerkverwaltungsebene fehlerfrei arbeitet.
FAQ
Warum kann ich Omada öffnen, aber werden Geräte nicht erkannt?
Der Webport kann funktionieren, während UDP-Erkennung oder TCP-Verwaltungsports fehlen. Überprüfen Sie jeden erforderlichen veröffentlichten Port.
Benötige ich den Host-Modus?
Nein. Der Bridge-Modus mit korrekt veröffentlichten Ports funktioniert bei vielen Bereitstellungen.
Was sollte ich sichern?
Sichern Sie die dokumentierten Daten-, Konfigurations- und Protokollverzeichnisse und verwenden Sie vor größeren Upgrades zusätzlich das Controller-eigene Omada-Backup.
Kann ich Omada direkt dem Internet aussetzen?
Vermeiden Sie dies. Halten Sie die Verwaltungsoberfläche hinter dem LAN oder einem privaten Fernzugriff.
