Cómo configurar un hotspot TP-Link Omada de Powerlynx: guía sencilla

Esta guía muestra cómo usar un despliegue Wi-Fi TP-Link Omada — puntos de acceso EAP gestionados por un Omada Software Controller — como NAS de portal cautivo de Powerlynx, utilizando el flujo RADIUS + External Web Portal.

El controlador Omada (no cada EAP individual) es el cliente RADIUS y el receptor de CoA/PoD (UDP 3799). Un cliente que se une al SSID del hotspot es redirigido a la página de bienvenida de Powerlynx. Tras iniciar sesión o realizar el pago, Powerlynx envía automáticamente el navegador del cliente de vuelta al endpoint /portal/radius/browserauth del controlador, y el controlador realiza el intercambio RADIUS (auth + accounting) con Powerlynx a través de un túnel WireGuard.

!Importante: Solo controlador on-premise — ¡Omada Cloud no funciona!

Ambas configuraciones descritas a continuación requieren un controlador Omada autohospedado / on-premise. En Omada Cloud no funciona — el controlador en la nube no puede recibir RADIUS PoD ni CoA (UDP 3799) de Powerlynx, por lo que la desconexión remota y la autorización dinámica son imposibles.

Hay dos formas de crear un hotspot TP-Link Omada con Powerlynx, según si usas un gateway TP-Link Omada (serie ER):

Configuración 1 — Host Ubuntu / Omada Software Controller como gateway + TP-Link EAP. Úsala cuando no tengas (o no quieras usar) un gateway TP-Link. El servidor Ubuntu con el Omada Software Controller asume el rol de “gateway”: termina el túnel WireGuard hacia Powerlynx a nivel de SO y actúa como cliente RADIUS y receptor de CoA/PoD. Solo necesitas ese servidor más un TP-Link EAP — sin router/gateway Omada. El acceso a Internet de los clientes lo proporciona el router/enlace ascendente existente del sitio. Esta guía documenta esta configuración.

Configuración 2 — Controlador Omada + gateway TP-Link Omada (serie ER) + TP-Link EAP. Úsala cuando sí uses un gateway TP-Link Omada; el gateway termina el túnel WireGuard hacia Powerlynx (el WireGuard integrado de Omada es una función exclusiva del gateway) y actúa como cliente RADIUS. La configuración del lado Powerlynx es la misma que en la Configuración 1.

Solo la Configuración 1 está documentada paso a paso a continuación (es la configuración validada de extremo a extremo). Si necesitas ayuda con la Configuración 2 (gateway TP-Link Omada), contacta al equipo de soporte de Powerlynx en support@powerlynx.app.

Requisitos

• Host Linux — Ubuntu 16.04 / 18.04 / 20.04 / 22.04 / 24.04 o Debian 8–12 (64 bits). Windows también es compatible.
• OpenJDK 17+ (64 bits) para la versión v5.15.20 del controlador y superiores (las versiones anteriores usan Java 8+).
• MongoDB hasta la versión 8 para v5.15.20+ (hasta v7 para 5.14.20+).
• Apache Commons Daemon (jsvc) — se recomienda v1.0.15 con OpenJDK 17.
• Omada Software Controller, línea v5 (esta guía usa 5.15.x; la versión actual en distribución es v6.2.x — elige 5.15.x en “Previous Version” en la página de descarga).
• Un TP-Link Omada EAP (p. ej. EAP225 v3+).
• IP estática para el host del controlador — la adopción del EAP y la configuración RADIUS la referencian por IP.
• Una Ubicación de Powerlynx y un hotspot ya creados.

Cómo configurar TP-Link Omada con Powerlynx: guía de integración paso a paso

Resumen rápido de la configuración

1. Instalar el Omada Software Controller en el host Ubuntu
2. Adoptar el EAP y crear la WLAN del hotspot (SSID)
3. Configurar el túnel WireGuard entre el host del controlador y Powerlynx
4. Configurar el hotspot de Powerlynx (tipo de NAS, NAS IP, secreto RADIUS)
5. Configurar el Portal y el perfil RADIUS de Omada
6. Establecer los atributos RADIUS recomendados en el tipo de NAS de Powerlynx
7. Verificar: capturar tráfico RADIUS y probar una sesión completa

Pasos detallados

Paso 1. Instalar el Omada Software Controller

Instala el Omada Software Controller (línea v5) en el host Ubuntu. Los enlaces de descarga e instalación oficiales están en la sección de Referencias al final de esta guía.

# 1. OpenJDK 17 + jsvc
sudo apt update
sudo apt install -y openjdk-17-jre-headless jsvc curl gnupg

# 2. MongoDB 8.0
curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] \
https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | \
sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

sudo apt update && sudo apt install -y mongodb-org

# 3. Instala el .deb del controlador (descárgalo desde la página oficial — ver Referencias)
sudo dpkg -i omada_v5.15.24.19_linux_x64_*.deb
# Si dpkg da error por la versión de jsvc:
# sudo dpkg --ignore-depends=jsvc -i omada_v5.15.24.19_linux_x64_*.deb

# 4. Iniciar
sudo tpeap start
tpeap status

java -version # OpenJDK 17
sudo tpeap status # "Omada Controller is running"
sudo ss -tlnp | grep -E '8043|8088' # puertos web escuchando = arranque finalizado

sudo apt update && sudo apt install -y wireguard

[Interface]
PrivateKey = <client-private-key-from-generate>
Address = <controller-tunnel-ip>/32

[Peer]
PublicKey = lPYDyIwk5X4tyUMNT9ny/nyPSyHwk31mzm2ahOH7iV0=
Endpoint = 139.84.243.134:443
AllowedIPs = 172.16.0.1/32
PersistentKeepalive = 15

sudo wg-quick up wg0 # iniciar el túnel ahora
sudo systemctl enable wg-quick@wg0 # iniciar automáticamente al arrancar
systemctl status wg-quick@wg0.service # debe estar "active (exited)"
sudo wg show # peer, último handshake, contadores de transferencia
ping -c4 172.16.0.1 # confirmar conectividad a través del túnel

sudo radsniff -i wg0 -p 1812 -x # captura 1812/1813/3799
# o, solo para desconexión:
sudo tcpdump -ni wg0 -vv 'udp port 3799'