Integración domótica MikroTik, gratuita y de código abierto

Routers MikroTik: presencia de sus dispositivos, estado del router, caudal y cortes WAN.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Siga su router MikroTik desde Gladys, en su red local: sepa quién está en casa gracias a los teléfonos conectados a su Wi-Fi, vigile el estado del router y el caudal de su acceso a internet, reciba un aviso cuando el WAN se corta o se conecta un dispositivo desconocido y, si lo permite, corte internet en la tableta de los niños desde una escena.

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha escrito y probado con las respuestas documentadas por MikroTik y los datos de prueba de la integración de Home Assistant, no con un router real. Si algo no funciona como se describe, dígalo en el foro de Gladys o en los issues.

Esta integración no está afiliada a MikroTik.

Lo que necesita

• Gladys Assistant 5.1.0 o posterior.
• Un router MikroTik con RouterOS 7 (API REST) o RouterOS 6.43 o posterior (API), accesible desde Gladys.
• Uno de estos servicios de RouterOS activado (IP → Services): www-ssl (HTTPS, RouterOS 7), api-ssl, www (HTTP, RouterOS 7) o api. La configuración por defecto de RouterOS activa www y api.
• Un usuario de RouterOS para Gladys (ver abajo).

Puesta en marcha

El usuario de RouterOS

Cree un usuario dedicado en lugar de usar admin. Una cuenta de solo lectura basta para los sensores de presencia, las medidas, los desencadenantes y los widgets. En un terminal (WinBox, WebFig o SSH):

/user add name=gladys group=read password=una-contrasena-larga

Compruebe que el grupo tiene el permiso api, y rest-api en RouterOS 7 (System → Users → Groups). Las órdenes (reglas de cortafuegos, reinicio) necesitan un grupo con los permisos write y reboot, como write.

Para ir más allá, permita el servicio solo desde la dirección de Gladys, por ejemplo /ip service set www address=192.168.88.10/32.

La configuración

Abra Integraciones → MikroTik → Configuración:

• Dirección del router: su dirección IP (192.168.88.1 por defecto), con :puerto si el servicio no usa su puerto predeterminado.
• Nombre de usuario y Contraseña del usuario de RouterOS.
• Protocolo: Automático prueba REST por HTTPS, API-SSL, REST por HTTP y luego API, y conserva el primero que funciona; los cifrados primero. Elija uno para imponerlo.
• Aceptar un certificado autofirmado: para HTTPS y API-SSL. RouterOS usa un certificado autofirmado si no ha instalado otro.
• Intervalo de actualización: de 10 segundos a 1 minuto (30 segundos por defecto).
• Interfaces WAN: vacío, la integración toma los miembros de la lista de interfaces WAN de RouterOS (la configuración por defecto pone ether1), si no ether1. Cuatro nombres como máximo, separados por comas.
• Presencia: el Retraso de salida (minutos) y las fuentes (ver abajo).
• Reglas de cortafuegos que seguir y Permitir órdenes (ver abajo).
• Idioma de los nombres: el idioma de los nombres de dispositivos y funciones.

Pulse después Probar la conexión: el informe indica el protocolo usado, las interfaces WAN seguidas, cuántos clientes se ven y si las reglas seguidas existen. Abra por último la pestaña Descubrir y añada los dispositivos que desee.

Los dispositivos

El router

Un dispositivo, con el nombre de la identidad de RouterOS:

Función	Lo que muestra
Carga del procesador	en %
Memoria usada	en %
Temperatura	en °C, cuando el router tiene un sensor
Tiempo de funcionamiento	en horas
Versión de RouterOS	p. ej. 7.18.2
Actualización de RouterOS disponible	Encendido cuando RouterOS indica una versión nueva
Descarga / Subida	por interfaz WAN, en Mbit/s, media de un ciclo
Enlace WAN	por interfaz WAN: Encendido cuando el enlace funciona

La integración pide a RouterOS que busque actualizaciones una vez al día (un usuario de solo lectura no puede: se muestra entonces la última búsqueda hecha por RouterOS).

Sensores de presencia

La pestaña Descubrir lista los clientes del router: sus concesiones DHCP, sus tablas de registro Wi-Fi (wireless, wifiwave2, wifi y CAPsMAN) y, si está activada, su tabla ARP. Añada los teléfonos que quiera seguir: cada uno se convierte en un sensor Presencia, con el nombre de su comentario en RouterOS, si no su nombre de host.

• Un dispositivo está presente en cuanto el router lo ve: asociado al Wi-Fi, o con una entrada ARP viva si Usar también la tabla ARP está marcado, o con una concesión DHCP activa si Contar una concesión DHCP como presente está marcado.
• Solo pasa a ausente si no se ha visto durante el Retraso de salida (5 minutos por defecto): un teléfono en reposo deja el Wi-Fi unos minutos sin salir de casa.
• Cuando el router no se puede leer, nadie cambia de estado.

Un dispositivo presente se publica de nuevo cada dos minutos, de modo que la acción de escena Comprobar presencia del usuario de Gladys también funciona; con el retraso de salida, rara vez la necesitará.

Los teléfonos usan una dirección Wi-Fi privada (aleatoria) por red. Manténgala fija para el Wi-Fi de casa (en iOS: Dirección Wi-Fi privada en Fija; en Android: aleatoria por red, no por conexión), si no el dispositivo parecerá nuevo tras un cambio.

Reglas de cortafuegos

Para seguir una regla, dele un comentario en RouterOS (IP → Firewall → Filter Rules) e introduzca ese comentario en Reglas de cortafuegos que seguir (Listar las reglas de cortafuegos muestra las reglas comentadas). Cada una se convierte en un dispositivo con una función Regla activada (Encendido cuando la regla está activada). Las reglas IPv4 e IPv6 que comparten el comentario cuentan como una.

El estado es de solo lectura. Con Permitir órdenes marcado, las acciones de escena y el widget pueden activar o desactivar la regla: la integración solo cambia entonces el indicador disabled de esas reglas, y nada más de la configuración.

Panel

Tres widgets:

• Router MikroTik: procesador, memoria, temperatura, caudal de descarga y de subida de la primera interfaz WAN, el estado de cada enlace WAN, el tiempo de funcionamiento, la versión de RouterOS o la actualización disponible, y un botón Reiniciar (con confirmación) cuando las órdenes están permitidas.
• Dispositivos presentes: los dispositivos seguidos como sensores de presencia, presentes primero, con el tiempo que llevan ausentes los demás. Su ajuste Mostrar conserva solo los presentes.
• Reglas de cortafuegos: las reglas seguidas y, cuando las órdenes están permitidas, un botón por regla (cuatro como máximo) para activarla o desactivarla, con confirmación. Una marca indica las reglas activadas.

Escenas

Desencadenantes

• Dispositivo desconocido conectado: una dirección MAC nunca vista se ha conectado al Wi-Fi o ha obtenido una concesión DHCP. Los dispositivos presentes en el primer arranque de la integración se aprenden sin desencadenar. Filtro: Visto por (Wi-Fi o concesión DHCP). Variables: dirección MAC, dirección IP, nombre de host, visto por, interfaz.
• Enlace WAN cortado: una interfaz WAN ha perdido su enlace. Filtro: Interfaz. Variable: interfaz.
• Enlace WAN restablecido: el enlace ha vuelto. Filtro: Interfaz. Variables: interfaz, corte en minutos.

Acciones

Necesitan Permitir órdenes y un usuario de RouterOS con los permisos write y reboot.

• Activar una regla de cortafuegos y Desactivar una regla de cortafuegos: elija un dispositivo regla. Salida: Regla activada.
• Reiniciar el router MikroTik: la red se corta uno o dos minutos.

Ideas de escenas

• Nadie en casa: cuando la presencia de cada teléfono es «Sin presencia», active la alarma y baje la calefacción.
• Hora de dormir para la tableta: cada noche a las 21:00, Activar una regla de cortafuegos «Bloquear tableta niños»; a las 7:00, Desactivar una regla de cortafuegos.
• Corte de internet: con Enlace WAN cortado, envíe un mensaje por un canal que no necesite internet (una pasarela SMS de la red local) y, con Enlace WAN restablecido, indique cuánto ha durado.
• ¿Quién es?: con Dispositivo desconocido conectado, envíese un mensaje con su nombre de host y su dirección IP.

Con qué frecuencia se lee el router

La integración lee ella misma el router, al intervalo de actualización de la configuración (Gladys no consulta estos dispositivos). Una lectura son unas diez listas pequeñas (recursos, estado, interfaces, Wi-Fi, ARP, concesiones DHCP, reglas): insignificante para el router. El estado de las actualizaciones se lee cada hora, y RouterOS consulta los servidores de MikroTik una vez al día. Solo se envían a Gladys los valores que cambian, más un latido cada seis horas.

Solución de problemas

• «nombre de usuario o contraseña rechazados»: compruébelos en WinBox. Tras un rechazo, la integración vuelve a intentarlo cada cinco minutos (cada intento es una línea en el registro de RouterOS).
• «al grupo del usuario le falta un permiso»: dé al grupo api (y rest-api en RouterOS 7).
• «certificado rechazado»: marque Aceptar un certificado autofirmado, o instale un certificado reconocido por Gladys.
• «no responde»: compruebe la dirección, que el servicio está activado en IP → Services y que su campo address permite a Gladys.
• Sin caudal WAN: los caudales necesitan dos lecturas; compruebe los nombres en Interfaces WAN.
• Un teléfono sigue ausente: marque Usar también la tabla ARP, aumente el retraso de salida y compruebe que su dirección Wi-Fi privada es fija.
• Más detalles: arranque la integración con LOG_LEVEL=debug. En el nivel por defecto, los registros solo muestran el arranque, el router perdido y recuperado, los problemas (una vez cada uno) y sus órdenes. Las contraseñas nunca aparecen en los registros.

Límites

• Un router por integración. Con varios puntos de acceso, siga la presencia en el que ve todos los clientes (el controlador CAPsMAN, o el router con la tabla ARP).
• El estado del enlace WAN es el de la interfaz: un corte de internet detrás de un enlace que funciona (del lado del operador) no se detecta.
• Los caudales son medias del intervalo de actualización, según los contadores de las interfaces.
• Las tablas Wi-Fi de puntos de acceso de otras marcas no se leen: use la tabla ARP.
• Los nombres de los dispositivos y funciones se fijan al añadir un dispositivo a Gladys.
• Solo reglas de filtrado del cortafuegos (no NAT, mangle ni Kid Control), encontradas por su comentario exacto.
• Desarrollada sin el hardware: las respuestas de routers reales pueden diferir de las documentadas. Sus comentarios son bienvenidos.

Parámetros de configuración

Estos son los parámetros que MikroTik te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Su router MikroTik	section	No	RouterOS 7 (API REST) o RouterOS 6.43+ (API). Cree un usuario dedicado: el grupo read basta para la presencia y las medidas. El protocolo se detecta automáticamente.
Dirección del router	string	Sí	Dirección IP o nombre del router, con :puerto si el servicio no usa su puerto predeterminado.
Nombre de usuario	string	Sí	Un usuario de RouterOS, idealmente del grupo read.
Contraseña	secret	No
Protocolo	select	No	Automático prueba REST por HTTPS, API-SSL, REST por HTTP y luego API, y conserva el primero que funciona.
Aceptar un certificado autofirmado	boolean	No	Para HTTPS y API-SSL: RouterOS usa un certificado autofirmado si no ha instalado otro. Márquelo solo para su propio router.
Intervalo de actualización	select	No	Con qué frecuencia se lee el router. Los caudales son medias en este intervalo.
Interfaces WAN	string	No	Nombres separados por comas, cuatro como máximo. Vacío: los miembros de la lista de interfaces WAN de RouterOS, si no ether1.
Presencia	section	No	Añada los dispositivos que quiera seguir desde la pestaña Descubrir: cada uno se convierte en un sensor de presencia, presente cuando el router lo ve.
Retraso de salida (minutos)	number	No	Un dispositivo que ya no se ve cuenta como ausente solo tras este retraso: un teléfono en reposo deja el Wi-Fi unos minutos.
Usar también la tabla ARP	boolean	No	Ve los dispositivos con cable y el Wi-Fi de otros puntos de acceso. Las tablas de registro Wi-Fi del router se usan siempre.
Contar una concesión DHCP como presente	boolean	No	Una concesión sigue activa hasta que caduca, mucho después de la salida: márquelo solo para dispositivos que nada más ve.
Reglas de cortafuegos y órdenes	section	No	Solo lectura por defecto. Las órdenes activan o desactivan las reglas indicadas abajo, o reinician el router, desde una escena o un widget. Nunca se cambia nada más.
Reglas de cortafuegos que seguir	string	No	Los comentarios de las reglas de filtrado, separados por comas (diez como máximo). «Listar las reglas de cortafuegos» los muestra.
Permitir órdenes	boolean	No	Permite a las escenas y widgets activar o desactivar las reglas de arriba y reiniciar el router. El usuario necesita los permisos write y reboot.
Idioma de los nombres	select	No	Idioma de los nombres de dispositivos y funciones, fijados al añadir un dispositivo.

Cómo instalar MikroTik en Gladys

1. En Gladys, abre Integraciones: MikroTik aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-mikrotik:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-mikrotik.

MikroTik requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas

MikroTik es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

• Explorar todas las integraciones, nativas y de la comunidad
• Crear y publicar tu propia integración externa
• Código fuente en GitHub — fuente de esta documentación

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂