Integración domótica UniFi Network, gratuita y de código abierto
Ubiquiti UniFi integration for UCG, UDM, Switches, APs and network presence tracking.
Publicado por guim31
- Dispositivos
- Versión 1.5.2
- Requiere Gladys >=4.62.0
- ★ 1
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
Connect your Ubiquiti UniFi OS console (UCG Fiber, Dream Machine UDM/UDM-SE, UniFi Express, Cloud Key, or self-hosted UniFi Controller) to Gladys Assistant.
Features
- Network Presence Tracking (Device Tracker): Real-time tracking of smartphones and connected network devices for Gladys presence/absence scenes.
- Internet Access Control: Switch button to block or unblock internet access for any connected client device.
- Switch PoE Port Control: Turn PoE power ON/OFF on switch ports (useful for power cycling IP cameras or Access Points).
- Wi-Fi SSID Control: Enable or disable Wi-Fi networks (e.g., Guest Wi-Fi) from Gladys dashboards or scenes.
- WAN & Gateway Health Metrics: Real-time Upload/Download throughput (Mbps) and Gateway online status.
Local Authentication Guide (100% Local First)
The integration connects directly to your local UniFi console using a local admin account:
Create a dedicated local admin account in UniFi OS:
- Log into your UniFi OS console (
https://192.168.1.1). - In the left navigation bar, click Admins / Users (👥) (or under Control Plane / Identity > Admins).
- Click Add Admin.
- Select Local Access Only.
- Set a username (e.g.
gladys) and password. - Grant Admin role (required to block internet or toggle PoE ports) or Read Only.
- In Gladys, enter your console IP address, username
gladys, and local password.
Usage
- Save configuration in Gladys and click Test UniFi Connection to verify.
- Go to the Discovery tab in Gladys to import your Gateway, network clients, PoE ports, and Wi-Fi networks.
Dashboard widgets
Since Gladys 5.1, the integration offers three widgets in the dashboard editor. They read the integration's last poll (every 30 seconds) and never query the console on their own. No widget shows a MAC or an IP address (the address fragments a nameless client gets in its Gladys name are removed): a dashboard can be public.
- Network: the network at a glance. Two tiles, "Download" and "Upload", and a chart follow the gateway's WAN throughput features, live; the "Clients" (active clients) and "Devices" (UniFi hardware online / total) tiles come from the last poll; the status list gives the Internet state (the console's WAN subsystem), the Wi-Fi, wired and guest clients, and the hardware offline.
- Settings: Gateway (the gateway added to Gladys; empty = the first known gateway) and Chart period (last hour, last day, last week).
- Limits: the throughput and the chart need the gateway to be added to Gladys from the Discovery tab (its features feed the tiles and the history). Without a UniFi gateway (a console that does not route), only the counters and the status list show.
- Presence: who is home, from the network clients added to Gladys, with their Gladys names. A "Present" tile (
n / N) and one row per device (present first, then by name); beyond ten rows, a "+ n more" note. The widget refreshes itself as soon as a presence changes.- Setting: Show (present and absent, or present only).
- Limits: a device not added to Gladys does not appear; rename the devices in Gladys for readable names.
- Wi-Fi: one Wi-Fi network (SSID): its state, its connected clients, whether it is a guest network, its band and security when the console gives them, and two buttons, Enable / Disable. The use case: the guest Wi-Fi, opened for the time of a visit from a wall tablet.
- Setting: Wi-Fi network (the SSID added to Gladys; empty = the first known SSID).
- Limits: the buttons go through the SSID's "Wi-Fi state" feature, so the SSID must be added to Gladys from the Discovery tab. The client count is the Wi-Fi clients whose SSID is this one at the last poll.
Parámetros de configuración
Estos son los parámetros que UniFi Network te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Local UniFi Connection | section | No | Select your authentication mode and enter your local UniFi credentials or local API key. |
| IP Address / Hostname | string | Sí | IP address of your UniFi OS console (e.g. 192.168.1.1). |
| Port | number | Sí | |
| Authentication Mode | select | Sí | |
| Local API Key | secret | No | API Key generated in UniFi Network > Integrations. |
| Local Username | string | No | Local admin username created in Console > Users & Admins (required if Credentials mode selected). |
| Local Password | secret | No | |
| Site ID | string | Sí | |
| Presence Offline Delay (s) | number | No | Inactivity delay before marking a device as absent (prevents deep sleep toggling). |
| Device Discovery & Filtering | section | No | Configure which devices should be discovered and published to Gladys. |
| Discover Infrastructure (Console, APs, Switches) | boolean | No | |
| Discover Network Clients | boolean | No | |
| Only Connected Clients (Ignore historical known clients) | boolean | No | Only import currently connected clients to prevent importing hundreds of offline historical devices. |
| Client Connection Type | select | No | |
| Allowed Wi-Fi SSIDs | string | No | Filter Wi-Fi clients by SSID names (comma separated, e.g. Home, IoT). Leave empty to allow all SSIDs. |
Cómo instalar UniFi Network en Gladys
- En Gladys, abre Integraciones: UniFi Network aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-integration-unifi:1.6.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-integration-unifi.
UniFi Network 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
UniFi Network 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 externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación