TP-Link Omada si può ancora installare su CasaOS tramite lo store BigBearCasaOS gestito dalla community, ma il pacchetto è mantenuto dalla community e non è un'immagine Docker ufficiale di TP-Link. Nel 2026, BigBearCasaOS elenca TP-Link Omada Controller 6.2, basato su mbentley/omada-controller.
Questo significa che dovresti considerare i requisiti e le note di rilascio del controller TP-Link come fonte ufficiale di riferimento del prodotto, usando invece il manifest di BigBear solo come livello di pacchettizzazione per CasaOS.
Aggiungi lo store BigBearCasaOS attuale
L'attuale store di app BigBearCasaOS elenca il file ZIP dell'App Store e il pacchetto Omada attuale.
Installa l'app Omada Controller
Dopo aver aggiunto lo store, cerca TP-Link Omada Controller, controlla l'immagine e la versione, quindi installalo. Annota le cartelle di configurazione e dei dati mappate prima di eseguire aggiornamenti successivi.
TP-Link supporta Linux, ma non direttamente questa immagine Docker
L'attuale pagina dei requisiti di Omada Software Controller di TP-Link elenca le piattaforme Windows/Linux x64 supportate. L'immagine Docker utilizzata da BigBear è gestita separatamente.
Mantieni persistenti i dati del controller
Il database del controller contiene siti, dispositivi adottati, impostazioni, utenti e cronologia. Prima di affidargli la tua rete, verifica che BigBear mappi le directory dei dati e dei log del controller su uno spazio di archiviazione persistente di CasaOS.
Usa un IP LAN stabile
Assegna un IP riservato al server CasaOS tramite DHCP. I dispositivi Omada e gli amministratori non dovrebbero dover cercare un indirizzo del controller che cambia dopo il riavvio del router.
Esegui un backup prima di aggiornare la versione del controller
Esporta un backup del controller Omada e proteggi i dati persistenti del container prima di un aggiornamento importante. Le modifiche allo schema del controller di rete possono essere più difficili da annullare rispetto a un normale aggiornamento di un'app web.
Verifica le porte di adozione e rilevamento
Se l'interfaccia web si apre, ma i dispositivi Omada non vengono rilevati o adottati, sono importanti la modalità di rete del container e le porte Omada richieste. Confronta il manifest di BigBear con la documentazione aggiornata del controller TP-Link, invece di aprire porte a caso.
Non esporre direttamente l'interfaccia di amministrazione
Accedi tramite LAN, VPN o una modalità di accesso cloud supportata dal controller, invece di esporre l'interfaccia di gestione con il port forwarding diretto da Internet.
La guida alle app Docker si applica anche ai pacchetti della community di CasaOS.
Verifica la versione attuale del controller prima dell'adozione
I dispositivi Omada e le versioni del controller devono avere firmware compatibili. Prima di adottare un nuovo gateway, switch o punto di accesso, verifica i requisiti firmware rispetto alla versione del controller inclusa in BigBear.
Assicurati che l'host del controller sia raggiungibile dalle VLAN di gestione
Se i dispositivi Omada si trovano su un'altra VLAN, le regole di instradamento e del firewall devono consentire il traffico richiesto per il rilevamento e l'adozione. Il fatto che il pannello web funzioni sulla LAN di CasaOS non significa che i dispositivi gestiti possano raggiungere il controller.
Esporta un backup del controller dopo le modifiche importanti
Dopo aver adottato i dispositivi, modificato le WLAN o ricreato le VLAN, esporta un nuovo backup di Omada. In questo modo avrai un punto di ripristino dopo le modifiche alla configurazione, non solo prima degli aggiornamenti software.
FAQ
L'immagine Omada di BigBear è un software ufficiale TP-Link?
Include il controller TP-Link in un'immagine Docker gestita dalla community; TP-Link documenta invece il supporto nativo del controller per Linux e Windows.
Quale versione è disponibile ora in BigBearCasaOS?
Il repository attuale elenca Omada Controller 6.2.
Devo fare un backup prima dell'aggiornamento?
Sì. Esporta la configurazione del controller e proteggi prima i dati persistenti.
Perché l'interfaccia utente funziona, ma i dispositivi non vengono adottati?
Verifica le porte richieste per il rilevamento e l'adozione di Omada, la modalità di rete, l'instradamento VLAN e il percorso di rilevamento del controller usato dal dispositivo.
