TP-Link Omada todavía se puede instalar en CasaOS mediante la tienda mantenida BigBearCasaOS, pero el paquete lo mantiene la comunidad y no es una imagen oficial de Docker de TP-Link. A partir de 2026, BigBearCasaOS ofrece TP-Link Omada Controller 6.2 mediante mbentley/omada-controller.
Esto significa que debes considerar los requisitos y las notas de versión del controlador de TP-Link como la fuente de verdad del producto, y usar el manifiesto de BigBear únicamente como la capa de empaquetado para CasaOS.
Añade la tienda actual de BigBearCasaOS
La tienda de aplicaciones BigBearCasaOS actual incluye el ZIP de su tienda de aplicaciones y el paquete actual de Omada.
Instala la aplicación Omada Controller
Después de añadir la tienda, busca TP-Link Omada Controller, revisa la imagen y la versión, e instálalo. Anota las carpetas de configuración y datos asignadas antes de realizar actualizaciones posteriores.
TP-Link admite Linux, pero no esta imagen de Docker directamente
Los requisitos de Omada Software Controller de TP-Link indican que admite plataformas x64 de Windows y Linux. La imagen de Docker utilizada por BigBear se mantiene por separado.
Mantén persistentes los datos del controlador
La base de datos del controlador contiene sitios, dispositivos adoptados, configuraciones, usuarios e historial. Verifica que BigBear asigne los directorios de datos y registros del controlador a un almacenamiento persistente de CasaOS antes de confiarle tu red.
Usa una IP LAN estable
Reserva la IP del servidor CasaOS en DHCP. Los dispositivos Omada y los administradores no deberían tener que buscar una dirección cambiante del controlador después de reiniciar el router.
Haz una copia de seguridad antes de actualizar las versiones del controlador
Exporta una copia de seguridad del controlador Omada y protege los datos persistentes del contenedor antes de realizar una actualización importante. Los cambios de esquema del controlador de red pueden ser más difíciles de deshacer que una actualización normal de una aplicación web.
Comprueba los puertos de adopción y descubrimiento
Si la interfaz web se abre, pero los dispositivos Omada no se descubren ni se adoptan, son importantes el modo de red del contenedor y los puertos requeridos por Omada. Compara el manifiesto de BigBear con la documentación actual del controlador de TP-Link en lugar de abrir puertos al azar.
No expongas directamente la interfaz de administración
Usa el acceso LAN, una VPN o el acceso en la nube compatible con el controlador en lugar de reenviar directamente puertos de Internet a la interfaz de administración.
La guía de aplicaciones Docker también se aplica a los paquetes comunitarios de CasaOS.
Comprueba la versión actual del controlador antes de la adopción
Los dispositivos Omada y las versiones del controlador necesitan un firmware compatible. Antes de adoptar un gateway, switch o punto de acceso nuevo, compara sus requisitos de firmware con la versión del controlador empaquetada por BigBear.
Mantén accesible el equipo del controlador desde las VLAN de administración
Si tus dispositivos Omada se encuentran en otra VLAN, las reglas de enrutamiento y del firewall deben permitir el tráfico requerido de descubrimiento y adopción. Que el panel web funcione en la LAN de CasaOS no demuestra que los dispositivos administrados puedan comunicarse con el controlador.
Exporta una copia de seguridad del controlador después de cambios importantes
Después de adoptar dispositivos, cambiar las WLAN o reconstruir las VLAN, exporta una copia de seguridad nueva de Omada. Así tendrás un punto de recuperación posterior a los cambios de configuración, no solo anterior a las actualizaciones de software.
Preguntas frecuentes
¿La imagen de Omada de BigBear es software oficial de TP-Link?
Empaqueta el controlador de TP-Link en una imagen de Docker comunitaria; TP-Link documenta por su parte la compatibilidad nativa del controlador con Linux y Windows.
¿Qué versión incluye BigBearCasaOS actualmente?
El repositorio actual indica Omada Controller 6.2.
¿Debo hacer una copia de seguridad antes de actualizar?
Sí. Exporta primero la configuración del controlador y protege los datos persistentes.
¿Por qué funciona la interfaz, pero los dispositivos no se adoptan?
Comprueba los puertos requeridos de descubrimiento y adopción de Omada, el modo de red, el enrutamiento entre VLAN y la ruta de descubrimiento del controlador del dispositivo.
