Omada de TP-Link se puede seguir instalando en CasaOS a través de la tienda mantenida por BigBearCasaOS, pero el paquete lo mantiene la comunidad y no es una imagen oficial de Docker de TP-Link. En 2026, BigBearCasaOS ofrece TP-Link Omada Controller 6.2 con mbentley/omada-controller.
Esto significa que debes considerar los requisitos del controlador y las notas de la versión de TP-Link como la fuente de información oficial 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 la tienda de aplicaciones y el paquete Omada actual.
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 futuras actualizaciones.
TP-Link es compatible con Linux, pero no directamente con esta imagen de Docker
La página actual de requisitos de Omada Software Controller de TP-Link enumera las plataformas compatibles con Windows/Linux x64. La imagen de Docker que usa BigBear se mantiene por separado.
Mantén persistentes los datos del controlador
La base de datos del controlador contiene sitios, dispositivos adoptados, ajustes, usuarios e historial. Comprueba que BigBear asigne los directorios de datos y registros del controlador a 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 la versión del controlador
Exporta una copia de seguridad del controlador Omada y protege los datos persistentes del contenedor antes de una actualización importante. Los cambios en el esquema del controlador de red pueden ser más difíciles de revertir que una actualización normal de una aplicación web.
Comprobar los puertos de adopción y descubrimiento
Si se abre la interfaz web, pero los dispositivos Omada no se detectan ni se adoptan, importan el modo de red del contenedor y los puertos necesarios de 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 a través de la LAN, una VPN o el acceso a la nube compatible con el controlador, en lugar de redirigir puertos de Internet directamente a la interfaz de administración.
La guía de aplicaciones de Docker también se aplica a los paquetes comunitarios de CasaOS.
Comprueba la versión actual del controlador antes de adoptar dispositivos
Los dispositivos Omada y las versiones del controlador requieren firmware compatible. Antes de adoptar una nueva puerta de enlace, un conmutador o un punto de acceso, compara los requisitos de firmware con la versión del controlador incluida en BigBear.
Asegúrate de que se pueda acceder al host del controlador desde las VLAN de administración
Si tus dispositivos Omada están en otra VLAN, las políticas de enrutamiento y del cortafuegos deben permitir el tráfico necesario para el descubrimiento y la adopción. Que el panel web funcione en la LAN de CasaOS no demuestra que los dispositivos administrados puedan acceder al 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 nueva copia de seguridad de Omada. Así tendrás un punto de recuperación tras los cambios de configuración, no solo antes de actualizar el software.
Preguntas frecuentes
¿La imagen de Omada de BigBear es software oficial de TP-Link?
Incluye el controlador de TP-Link en una imagen comunitaria de Docker; TP-Link documenta la compatibilidad nativa del controlador con Linux y Windows.
¿Qué versión hay ahora en BigBearCasaOS?
El repositorio actual incluye Omada Controller 6.2.
¿Debo hacer una copia de seguridad antes de actualizar?
Sí. Exporta la configuración del controlador y protege primero los datos persistentes.
¿Por qué funciona la interfaz de usuario, pero los dispositivos no se adoptan?
Comprueba los puertos necesarios para el descubrimiento y la adopción de Omada, el modo de red, el enrutamiento de VLAN y la ruta de descubrimiento del controlador del dispositivo.
