Installera TP-Link Omada Controller på CasaOS som en beständig Docker-tjänst och bevara katalogerna för data, arbete och loggar. Den gamla handledningen från 2023 är fortfarande användbar i princip, men den underhållna avbildningen mbentley/omada-controller har utvecklats och aktuella installationer måste exponera flera TCP- och UDP-portar för identifiering, adoptering, hantering och captive portal-funktioner.
Betrakta inte Omada som en webbapp med endast en port. Webbgränssnittet kan öppnas utan problem samtidigt som identifiering och adoptering av enheter misslyckas på grund av att UDP- eller hanteringsportar saknas.
Använd en underhållen Omada Docker-avbildning
Den aktuella Omada Controller Docker-avbildningen underhålls aktivt och innehåller aktuell vägledning för uppgraderingar.
Gör alla tre huvudsakliga datasökvägar beständiga
Avbildningen dokumenterar beständiga volymer för:
/opt/tplink/EAPController/data/opt/tplink/EAPController/work/opt/tplink/EAPController/logs
Mappa dessa till CasaOS AppData-mappar så att uppgraderingar inte raderar controllerns tillstånd.
Exponera de portar som krävs
Omada använder fler portar än bara hanteringsgränssnittet. Den aktuella containerdokumentationen innehåller portar som:
- 8043/TCP för HTTPS-hantering;
- 8088/TCP för HTTP-hantering;
- 8843/TCP för HTTPS-portal;
- 27001/UDP och 29810/UDP för identifiering;
- 29811–29817/TCP för enhetshantering i aktuella versioner.
Publicera endast de tjänster som din installation behöver, men utelämna inte identifierings- och adopteringsportarna för att sedan felsöka controllern som om den vore trasig.
Bridge-läge fungerar vanligtvis
Omada-enheter kan kommunicera med en container via publicerade värdportar. Du behöver inte automatiskt använda värdnätverk eller en dedikerad macvlan-adress.
Om enhetsidentifieringen misslyckas mellan VLAN blir det ett problem med routad identifiering eller nätverksdesign, inte med CasaOS-installationen.
Så installerar du som en anpassad CasaOS-app
- Skapa en anpassad Docker-app.
- Använd den aktuella
mbentley/omada-controllerimage/tag. - Mappa katalogerna för beständiga data, arbete och loggar.
- Publicera de TCP- och UDP-portar som krävs.
- Ange en omstartspolicy, till exempel
unless-stopped. - Starta containern och öppna HTTPS-hanteringsporten.
Säkerhetskopiera controllern före större uppgraderingar
Omada Controller-uppgraderingar kan innebära databasändringar. Exportera en säkerhetskopia av controllern innan du byter större version, särskilt vid versioner som kräver migreringssteg.
Exponera inte hanteringsportar offentligt
Håll styrenheten på ett betrott LAN eller ett privat VPN. Använd Docker-distributionsguiden för samma principer för containerdistribution.
Använd en stabil styrenhetsadress
Omada-enheter måste fortsätta hitta styrenheten efter omstarter. Ge CasaOS-servern en stabil LAN-adress genom en DHCP-reservation eller en noggrant hanterad statisk IP-adress. Om värdadressen ändras kan tidigare anslutna enheter fortsätta försöka nå den gamla styrenhetsadressen.
Upptäckt mellan VLAN kan kräva ytterligare nätverksdesign
Lokal broadcast-upptäckt fungerar bäst när styrenheten och de nya Omada-enheterna finns i samma layer-2-nätverk. Om dina åtkomstpunkter och styrenheten ligger i olika VLAN kan det hända att enbart publicering av Docker-portar inte får discovery-broadcasts att passera routern.
I så fall ska du använda TP-Links stödda layer-3-process för anslutning/informering eller konfigurera routing- och brandväggsregler medvetet. Försök inte lösa ett VLAN-routingproblem genom att installera om containern upprepade gånger.
Kontrollera Java-minnet på mindre CasaOS-värdar
Omada är en Java-applikation och kan använda betydligt mer minne än lättviktiga DNS- eller instrumentpanelscontainrar. Den underhållna avbildningen exponerar minnesrelaterade inställningar, och resursbegränsade distributioner bör lämna tillräckligt med RAM åt CasaOS, Docker och andra tjänster.
Om containern startar om under belastning ska du undersöka loggar och minnesbelastning innan du antar att databasen är skadad.
Verifiera enhetsanslutningen efter varje uppgradering
Efter en större Omada-uppdatering ska du bekräfta att styrenhetens gränssnitt öppnas, att anslutna enheter förblir anslutna och att portar för upptäckt och anslutning fortfarande är publicerade. Att en container är ”igång” är inte tillräckligt bevis för att nätverkshanteringen fungerar korrekt.
Vanliga frågor
Varför kan jag öppna Omada, men enheter upptäcks inte?
Webbporten kan fungera trots att UDP-upptäckt eller TCP-hanteringsportar saknas. Kontrollera alla portar som måste publiceras.
Behöver jag värdläge?
Nej. Bryggläge med korrekt publicerade portar fungerar för många distributioner.
Vad bör jag säkerhetskopiera?
Säkerhetskopiera de dokumenterade data-, work- och loggkatalogerna och använd även Omadas egen säkerhetskopiering av styrenheten före större uppgraderingar.
Kan jag exponera Omada direkt mot internet?
Undvik att göra det. Håll administrationsgränssnittet bakom LAN eller privat fjärråtkomst.
