Communityoplossing

Installeer TP-Link Omada veilig op CasaOS met BigBear

A 2024 BigBearCasaOS tutorial introduced Omada on CasaOS; the current BigBear store still maintains an Omada Controller package.

TP-Link Omada kan nog steeds op CasaOS worden geïnstalleerd via de onderhouden BigBearCasaOS-store, maar het pakket wordt door de community onderhouden en is geen officiële Docker-installatiekopie van TP-Link. Vanaf 2026 vermeldt BigBearCasaOS TP-Link Omada Controller 6.2, die gebruikmaakt van mbentley/omada-controller.

Dat betekent dat je de vereisten en releaseopmerkingen van de controller van TP-Link moet beschouwen als de belangrijkste bron van waarheid voor het product, terwijl je het manifest van BigBear alleen als de CasaOS-verpakkingslaag gebruikt.

Voeg de huidige BigBearCasaOS-store toe

De huidige BigBearCasaOS-appstore vermeldt het ZIP-bestand van de appstore en het huidige Omada-pakket.

Installeer de Omada Controller-app

Zoek na het toevoegen van de store naar TP-Link Omada Controller, controleer de installatiekopie en versie en installeer de app. Noteer de gekoppelde configuratie- en gegevensmappen voordat je later updates uitvoert.

TP-Link ondersteunt Linux, maar niet deze Docker-installatiekopie rechtstreeks

De huidige vereisten voor Omada Software Controller van TP-Link vermelden ondersteunde x64-platforms voor Windows en Linux. De Docker-installatiekopie die BigBear gebruikt, wordt afzonderlijk onderhouden.

Houd controllergegevens persistent

De controllerdatabase bevat sites, geadopteerde apparaten, instellingen, gebruikers en geschiedenis. Controleer voordat je de controller voor je netwerk gebruikt of BigBear de gegevens- en logmappen van de controller koppelt aan permanente CasaOS-opslag.

Gebruik een stabiel LAN-IP-adres

Reserveer het IP-adres van de CasaOS-server in DHCP. Omada-apparaten en beheerders zouden na herstarts van de router niet achter een veranderend controlleradres aan moeten hoeven gaan.

Maak een back-up voordat je controller­versies bijwerkt

Exporteer een back-up van de Omada-controller en beveilig de permanente containergegevens voordat je een grote update uitvoert. Wijzigingen in het netwer­kcontrollerschema zijn moeilijker terug te draaien dan een normale update van een webapp.

Controleer adoptie- en detectiepoorten

Als de webinterface opent maar Omada-apparaten niet worden gedetecteerd of geadopteerd, zijn de netwerkmodus van de container en de vereiste Omada-poorten van belang. Vergelijk het BigBear-manifest met de actuele controllerdocumentatie van TP-Link in plaats van willekeurig poorten te openen.

Stel de beheerinterface niet rechtstreeks bloot

Gebruik LAN-toegang, een VPN of de ondersteunde cloudtoegang van de controller in plaats van het rechtstreeks doorsturen van internetpoorten naar de beheerinterface.

De Docker-apphandleiding geldt ook voor communitypakketten voor CasaOS.

Controleer de huidige controllerversie vóór adoptie

Omada-apparaten en controllerreleases hebben compatibele firmware nodig. Vergelijk voordat je een nieuwe gateway, switch of accesspoint adopteert de firmwarevereisten met de controllerversie die door BigBear wordt aangeboden.

Houd de controllerhost bereikbaar vanuit beheer-VLAN's

Als je Omada-apparaten zich op een ander VLAN bevinden, moeten routering en firewallbeleid het vereiste detectie- en adoptieverkeer toestaan. Een werkend dashboard op het CasaOS-LAN bewijst niet dat beheerde apparaten de controller kunnen bereiken.

Exporteer een controllerback-up na grote wijzigingen

Exporteer na het adopteren van apparaten, het wijzigen van WLAN's of het opnieuw opbouwen van VLAN's een nieuwe Omada-back-up. Zo beschik je over een herstelpunt na configuratiewijzigingen, en niet alleen vóór software-updates.

Veelgestelde vragen

Is de BigBear-Omada-installatiekopie officiële TP-Link-software?

Het pakket bevat de controller van TP-Link in een Docker-installatiekopie die door de community wordt onderhouden; TP-Link documenteert zelf ondersteuning voor native controllers op Linux en Windows.

Welke versie staat er nu in BigBearCasaOS?

De huidige repository vermeldt Omada Controller 6.2.

Moet ik een back-up maken voordat ik update?

Ja. Exporteer eerst de controllerconfiguratie en beveilig de permanente gegevens.

Waarom werkt de interface wel, maar worden apparaten niet geadopteerd?

Controleer de vereiste Omada-detectie- en adoptiepoorten, de netwerkmodus, VLAN-routering en het controllerdetectiepad van het apparaat.