Installa TP-Link Omada Controller su CasaOS come servizio Docker persistente e conserva le directory dei dati, del lavoro e dei log. Il vecchio tutorial del 2023 rimane utile a livello concettuale, ma l'immagine mantenuta mbentley/omada-controller si è evoluta e le distribuzioni attuali devono esporre diverse porte TCP e UDP per il rilevamento, l'adozione, la gestione e le funzioni del captive portal.
Non trattare Omada come una semplice app web con una sola porta. L'interfaccia web può aprirsi correttamente mentre il rilevamento e l'adozione dei dispositivi falliscono perché mancano le porte UDP o di gestione.
Usa un'immagine Docker di Omada mantenuta
L'attuale immagine Docker di Omada Controller è attivamente mantenuta e include indicazioni aggiornate sugli aggiornamenti.
Rendi persistenti tutti e tre i percorsi principali dei dati
L'immagine documenta volumi persistenti per:
/opt/tplink/EAPController/data/opt/tplink/EAPController/work/opt/tplink/EAPController/logs
Mappa queste directory nelle cartelle AppData di CasaOS, così gli aggiornamenti non cancelleranno lo stato del controller.
Esponi le porte richieste
Omada utilizza più della sola interfaccia di gestione. La documentazione attuale del container include porte come:
- 8043/TCP per la gestione HTTPS;
- 8088/TCP per la gestione HTTP;
- 8843/TCP per il portale HTTPS;
- 27001/UDP e 29810/UDP per il rilevamento;
- 29811–29817/TCP per la gestione dei dispositivi nelle release attuali.
Pubblica solo i servizi necessari alla tua distribuzione, ma non omettere le porte per il rilevamento e l'adozione per poi diagnosticare il controller come guasto.
La modalità bridge di solito funziona
I dispositivi Omada possono comunicare con un container tramite le porte pubblicate sull'host. Non sono automaticamente necessarie la rete host o un indirizzo macvlan dedicato.
Se il rilevamento dei dispositivi non riesce tra VLAN, si tratta di un problema di rilevamento instradato/progettazione della rete, non di un problema di installazione di CasaOS.
Come installare un'app personalizzata su CasaOS
- Crea un'app Docker personalizzata.
- Usa il valore corrente
mbentley/omada-controllerimmagine/tag. - Mappa le directory persistenti per dati, lavoro e log.
- Pubblica le porte TCP e UDP richieste.
- Imposta una policy di riavvio come
a meno che non venga arrestato. - Avvia il container e apri la porta di gestione HTTPS.
Esegui il backup del controller prima degli aggiornamenti principali
Gli aggiornamenti del controller Omada possono includere modifiche al database. Esporta un backup del controller prima di cambiare versione principale, soprattutto per le release che richiedono passaggi di migrazione.
Non esporre pubblicamente le porte di gestione
Mantieni il controller su una LAN affidabile o su una VPN privata. Usa la guida alla distribuzione Docker per gli stessi principi di distribuzione dei container.
Usa un indirizzo stabile per il controller
I dispositivi Omada devono continuare a trovare il controller dopo i riavvii. Assegna al server CasaOS un indirizzo LAN stabile tramite una prenotazione DHCP o un indirizzo IP statico gestito con attenzione. Se l’indirizzo dell’host cambia, i dispositivi precedentemente adottati potrebbero continuare a tentare di raggiungere il vecchio indirizzo del controller.
Il rilevamento tra VLAN potrebbe richiedere una progettazione di rete aggiuntiva
Il rilevamento tramite broadcast locale funziona al meglio quando il controller e i nuovi dispositivi Omada si trovano sulla stessa rete di livello 2. Se i punti di accesso e il controller sono su VLAN diverse, la semplice pubblicazione delle porte Docker potrebbe non consentire ai broadcast di rilevamento di attraversare il router.
In tal caso, usa il processo di adozione/informazione di livello 3 supportato da TP-Link oppure configura intenzionalmente le regole di routing e del firewall. Non risolvere un problema di routing tra VLAN reinstallando ripetutamente il container.
Controlla la memoria Java sui piccoli host CasaOS
Omada è un’applicazione Java e può consumare molta più memoria rispetto ai container leggeri per DNS o dashboard. L’immagine gestita espone impostazioni relative alla memoria e le implementazioni con risorse limitate dovrebbero lasciare abbastanza RAM per CasaOS, Docker e gli altri servizi.
Se il container si riavvia sotto carico, controlla i log e la pressione sulla memoria prima di presumere che il database sia danneggiato.
Verifica l’adozione dei dispositivi dopo ogni aggiornamento
Dopo un aggiornamento importante di Omada, verifica che l’interfaccia del controller si apra, che i dispositivi adottati rimangano connessi e che le porte per il rilevamento e l’adozione siano ancora pubblicate. Il fatto che un container sia “in esecuzione” non dimostra da solo che il piano di gestione della rete sia operativo.
Domande frequenti
Perché riesco ad aprire Omada, ma i dispositivi non vengono rilevati?
La porta web può funzionare mentre mancano le porte UDP per il rilevamento o quelle TCP per la gestione. Controlla tutte le porte obbligatorie pubblicate.
Ho bisogno della modalità host?
No. La modalità bridge con le porte pubblicate correttamente funziona per molte implementazioni.
Che cosa devo salvare?
Mantieni i dati, i log e le directory di lavoro documentati e usa anche il backup del controller integrato in Omada prima degli aggiornamenti importanti.
Posso esporre Omada direttamente su Internet?
Evita di farlo. Mantieni l’interfaccia di gestione dietro la LAN o un accesso remoto privato.
