TP-Link Omada può ancora essere installato su CasaOS tramite lo store BigBearCasaOS mantenuto attivamente, ma il pacchetto è gestito dalla community e non è un'immagine Docker ufficiale di TP-Link. Nel 2026, BigBearCasaOS elenca TP-Link Omada Controller 6.2, che utilizza mbentley/omada-controller.
Ciò significa che dovresti considerare i requisiti e le note di rilascio del controller TP-Link come fonte di riferimento principale del prodotto, usando il manifest di BigBear solo come livello di pacchettizzazione per CasaOS.
Aggiungi lo store BigBearCasaOS aggiornato
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. Prendi nota delle cartelle di configurazione e dei dati mappate prima di eseguire aggiornamenti successivi.
TP-Link supporta Linux, ma non direttamente questa immagine Docker
I requisiti di Omada Software Controller di TP-Link elencano piattaforme x64 Windows/Linux 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. Verifica che BigBear mappi le directory dei dati e dei log del controller su uno storage persistente di CasaOS prima di affidargli la tua rete.
Usa un IP LAN stabile
Riserva l'indirizzo IP del server CasaOS nel DHCP. I dispositivi Omada e gli amministratori non dovrebbero dover inseguire 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 di un controller di rete possono essere più difficili da annullare rispetto a un normale aggiornamento di un'app web.
Controlla le porte per l'adozione e il rilevamento
Se l'interfaccia web si apre ma i dispositivi Omada non vengono rilevati o adottati, la modalità di rete del container e le porte Omada richieste sono importanti. Confronta il manifest di BigBear con la documentazione attuale del controller TP-Link invece di aprire porte casuali.
Non esporre direttamente l'interfaccia di amministrazione
Usa l'accesso LAN, una VPN o l'accesso cloud supportato dal controller invece del port forwarding diretto su Internet verso l'interfaccia di gestione.
La guida alle app Docker si applica anche ai pacchetti della community per CasaOS.
Controlla la versione attuale del controller prima dell'adozione
I dispositivi Omada e le versioni del controller richiedono firmware compatibili. Prima di adottare un nuovo gateway, switch o punto di accesso, confronta i requisiti del firmware con la versione del controller pacchettizzata da BigBear.
Mantieni l'host del controller raggiungibile dalle VLAN di gestione
Se i dispositivi Omada si trovano su un'altra VLAN, le regole di routing e firewall devono consentire il traffico richiesto per il rilevamento e l'adozione. Un dashboard web funzionante sulla LAN di CasaOS non dimostra 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.
Domande frequenti
L'immagine Omada di BigBear è un software ufficiale TP-Link?
Pacchettizza il controller TP-Link in un'immagine Docker della community; TP-Link documenta direttamente il supporto del controller nativo per Linux/Windows.
Quale versione è attualmente disponibile in BigBearCasaOS?
Il repository attuale elenca Omada Controller 6.2.
Devo eseguire un backup prima dell'aggiornamento?
Sì. Esporta prima la configurazione del controller e proteggi i dati persistenti.
Perché l'interfaccia funziona ma i dispositivi non vengono adottati?
Controlla le porte Omada richieste per il rilevamento e l'adozione, la modalità di rete, il routing tra VLAN e il percorso di rilevamento del controller del dispositivo.
