Añadir una cámara IP a Home Assistant parece sencillo, hasta que descubre que cada marca habla su propio dialecto. La integración ONVIF es el único estándar que corta el ruido de raíz: una única integración de Home Assistant que funciona con Reolink, Amcrest, Dahua, los clones de Hikvision y con la mayoría de cámaras IP «compatibles ONVIF» vendidas desde 2018. Esta guía le acompaña en la configuración completa, las trampas que nadie menciona en los hilos de los foros y la forma más barata de ejecutarla: un LinknLink iSG Box SE con Home Assistant preinstalado por 69,90 $.
1. Qué es ONVIF y por qué los usuarios de Home Assistant lo necesitan
ONVIF (Open Network Video Interface Forum) es un estándar abierto que define cómo se comunican entre sí las cámaras IP, los NVR y los clientes de vídeo a través de una red local. En lugar de necesitar una aplicación distinta para cada marca de cámara, cualquier dispositivo compatible con ONVIF puede descubrir, retransmitir y recibir eventos de cualquier otro dispositivo compatible con ONVIF.
Para los usuarios de Home Assistant, esto importa por tres motivos:
- Privacidad y control local. ONVIF se ejecuta íntegramente en su LAN. Ningún vídeo sale de su casa, no se requiere cuenta alguna y ningún fabricante de cámaras puede cortarle el feed con una actualización de firmware. Es justo lo contrario del modelo de Wyze, Ring o Arlo.
- Latencia. Un feed de cámara basado en la nube suele hacer un viaje de ida y vuelta de entre 300 y 1200 ms a través del servidor del fabricante antes de llegar a Home Assistant. ONVIF sobre la red local suele estar por debajo de 150 ms: lo bastante rápido para disparar automatizaciones de Home Assistant (luces, HVAC, sirenas) antes de que la persona que entra en cuadro haya dado dos pasos.
- Sin dependencia del fabricante. Si la marca de su cámara cierra o pivota a un modelo por suscripción, su sistema sigue funcionando. ONVIF es una especificación abierta al estilo W3C, con miles de dispositivos compatibles.
Si aún está decidiendo si merece la pena una central dedicada, cubrimos los fundamentos en Qué es una central domótica. Específicamente para ONVIF, es innegociable contar con una central con suficiente margen de CPU para gestionar varios streams RTSP; por eso la decisión de hardware de la siguiente sección es clave.
Marcas de cámaras que funcionan bien con ONVIF + Home Assistant:
- Reolink (series RLC, E1, Duo): excelente exposición de perfiles ONVIF, main + sub stream de serie
- Amcrest (series IP4M, IP5M): OEM de Dahua, eventos ONVIF muy sólidos
- Dahua (series IPC-HFW, IPC-HDW): ONVIF nativo, eventos de movimiento a prueba de bombas
- Hikvision y sus marcas blancas (Annke, LTS, LaView): ONVIF funciona, pero actívelo primero en la interfaz web de la cámara
- Ubiquiti UniFi Protect G3/G4/G5: ONVIF solo mediante exportación de Protect, la mayoría de usuarios descartan esta vía
- Axis, Bosch, Vivotek: gama empresarial, excelente soporte ONVIF
Marcas de cámaras a evitar para ONVIF: Wyze, Blink, Arlo, Ring, Google Nest. Son productos cloud-first; su exposición ONVIF es inexistente o inestable tras las actualizaciones de firmware.
2. Requisitos previos: el hardware necesario
Antes de tocar la pantalla de integración de ONVIF, asegúrese de tener estos cuatro elementos preparados:
2.1 Un host Home Assistant con potencia suficiente para streams RTSP
Home Assistant OS sobre una Raspberry Pi 4 (4 GB) funciona técnicamente para 1 o 2 cámaras, pero más allá —o en cuanto añada Frigate para detección con IA— la Pi empieza a perder frames y a sobrecalentarse.
Recomendamos el LinknLink iSG Box SE para esta configuración. A 69,90 $ es el host de Home Assistant más barato del mercado con HA preinstalado y ofrece significativamente más cómputo que una Pi 4: margen de sobra para 8 o más cámaras ONVIF en HA nativo, o de 2 a 4 cámaras con Frigate NVR en el mismo equipo. La comparativa de hardware completa está en nuestra guía de compra de hardware para Home Assistant.
Por qué el iSG Box SE es la opción por defecto adecuada para una instalación ONVIF:
- Home Assistant preinstalado: enchufe la alimentación y el cable Ethernet, abra el navegador y complete el asistente de configuración. Sin flashear una tarjeta SD, sin Proxmox, sin esperar a una Home Assistant Yellow con problemas de suministro.
- Arquitectura local-first: control 100 % local, sin cuenta en la nube, sin cuota mensual.
- CPU suficiente para Frigate: el bonus de la §5 sobre detección de objetos con IA funciona sin necesidad de añadir un Coral USB para una configuración de 2 a 4 cámaras.
- Precio: 69,90 $ frente a los 158,90 $ de un Home Assistant Green o los más de 120 $ de un kit Raspberry Pi 5 una vez que se suman SSD y caja.
2.2 Una cámara IP compatible con ONVIF en la misma LAN
Revise la ficha técnica de la cámara o su panel de administración en busca de la opción «ONVIF». La mayoría de cámaras de las marcas del §1 vienen con ONVIF activado pero sin contraseña: las credenciales las añadirá en el §3.
2.3 Una reserva de IP estática en el router
Home Assistant integra las cámaras por dirección IP. Si el router le asigna la semana que viene una IP nueva a la cámara, la integración se rompe en silencio. En los ajustes DHCP del router, reserve una IP LAN permanente para la dirección MAC de cada cámara (suele aparecer en el panel de administración de la propia cámara).
2.4 Credenciales de administrador de la cámara
No las de fábrica: cámbielas primero. Las credenciales ONVIF se envían por la LAN mediante autenticación digest por defecto, y las contraseñas por defecto siguen siendo la superficie más escaneada de cualquier red doméstica.
3. Configuración paso a paso de la integración ONVIF
Con el hardware listo, la integración en sí lleva menos de diez minutos. Estos son los cinco pasos exactos.
Paso 1: activar ONVIF en la interfaz web de la cámara
Abra la IP de la cámara en el navegador (p. ej. http://192.168.1.50), inicie sesión con credenciales de administrador y localice la sección ONVIF. Rutas por marca:
- Reolink: Device Settings → Network → Advanced → Port Settings → marque «ONVIF»
- Amcrest/Dahua: Setup → Network → Connection → ONVIF → Authentication = «Digest» o «None»
- Hikvision: Configuration → Network → Advanced Settings → Integration Protocol → active ONVIF y cree un usuario ONVIF dedicado
Hikvision es la única marca que viene con ONVIF desactivado de fábrica y que exige una cuenta de usuario ONVIF independiente: configúrela antes de continuar.
Paso 2: anotar las URL de los streams RTSP (opcional pero útil)
Ya que está en la interfaz web, copie las URL RTSP de los streams main y sub. La integración ONVIF de Home Assistant las descubre automáticamente, pero tenerlas a mano acelera mucho la depuración si el descubrimiento falla. Formatos habituales:
- Reolink main:
rtsp://admin:password@192.168.1.50:554/h264Preview_01_main - Reolink sub:
rtsp://admin:password@192.168.1.50:554/h264Preview_01_sub - Amcrest main:
rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0 - Amcrest sub:
rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1
Paso 3: abrir Home Assistant y añadir la integración ONVIF
En la interfaz de Home Assistant (ya se ejecute en el iSG Box SE o en otro lugar):
- Vaya a Settings → Devices & Services
- Haga clic en + Add Integration (abajo a la derecha)
- Busque «ONVIF» y selecciónelo
Home Assistant escaneará la red local vía WS-Discovery. La mayoría de las cámaras aparecen de forma automática. Si la suya no lo hace, puede añadirla manualmente por IP.
Paso 4: introducir IP, puerto y credenciales
El puerto ONVIF por defecto es el 80 (HTTP) en la mayoría de las cámaras, no el 554 (ese es el de RTSP: un puerto distinto). Si su cámara usa un puerto ONVIF no estándar (son habituales 2020, 8000 u 8899), aparecerá en la interfaz web de la cámara, en la sección Network u ONVIF.
Introduzca:
- Host: la IP LAN estática de la cámara
- Port: normalmente 80; Hikvision suele usar 80, Dahua 80, Reolink 8000
- Usuario/contraseña: las credenciales ONVIF establecidas en el §2.4 (Hikvision: el usuario ONVIF dedicado creado en el Paso 1)
Paso 5: elegir los perfiles (main + sub stream)
Home Assistant expondrá cada «perfil» ONVIF que anuncie la cámara: normalmente uno para el stream main (alta resolución) y otro para el sub (baja resolución). Active ambos:
- Main stream: se usa para grabaciones, capturas y visualización de alta calidad
- Sub stream: se usa para la tarjeta del panel Lovelace de Home Assistant (para que el dashboard cargue rápido incluso en móvil)
Haga clic en Submit. La cámara aparecerá ahora en Devices & Services con entidades para el feed en directo, el sensor de movimiento y (si la cámara lo admite) sensores binarios para cada evento que dispare la cámara: cruce de línea, detección de intrusión, clasificación humano/vehículo o sabotaje.
4. Problemas habituales y soluciones
Estos son los cuatro problemas que generan el 90 % de los hilos de foros sobre Home Assistant ONVIF. Así se resuelve cada uno en menos de dos minutos.
4.1 «Camera not discovered» durante Add Integration
WS-Discovery utiliza multicast DNS (mDNS). Si su host Home Assistant y su cámara están en VLAN distintas o en SSID WiFi diferentes, los paquetes mDNS no cruzan la frontera. Soluciones, por orden de esfuerzo:
- Ponga la cámara en la misma subred que Home Assistant temporalmente para el descubrimiento y, después, devuélvala a su red.
- Añada la cámara manualmente por IP durante la configuración de la integración (WS-Discovery es una comodidad, no un requisito).
- Active la reflexión de mDNS / Avahi en el router (UniFi: «Multicast DNS»; pfSense: paquete «Avahi»; OpenWrt: «umdns»). Es la solución permanente.
4.2 El stream en directo se queda cargando o muestra «Stream not available»
El stream main en 4K o 1440p a 30 fps suele ser demasiado para el panel Lovelace, sobre todo en móvil. Cambie la tarjeta del dashboard al stream sub:
- Settings → Devices & Services → integración ONVIF → Configure → desmarque «Main Profile» para la Picture Entity Card
- O, directamente en el YAML de la tarjeta de cámara: defina
stream_sourceapuntando a la entidad del perfil sub
Frigate NVR (tratado en la §5) es una solución más limpia aquí: recodifica el stream una sola vez y sirve HLS/WebRTC de baja latencia a todos los clientes.
4.3 Las entidades de detección de movimiento no disparan eventos en Home Assistant
Los eventos de movimiento ONVIF son opcionales en la especificación: la cámara debe (a) tener la detección de movimiento activada localmente y (b) estar configurada para publicar eventos ONVIF. Pasos:
- En la interfaz web de la cámara, active la detección de movimiento (normalmente Event → Motion Detection → Enable)
- Busque los ajustes ONVIF o «smart event» y active «ONVIF Events» o «Push Events»
- En Home Assistant, reinicie la integración ONVIF: Settings → Devices & Services → ONVIF → menú de tres puntos → Reload
Si utiliza una cámara Hikvision o un OEM de Hikvision y los eventos siguen sin dispararse, compruebe que el usuario ONVIF creado en el Paso 1 del §3 tiene los permisos «Event» y «Media»: por defecto, el usuario ONVIF es de solo lectura para la gestión de User, lo cual es correcto, pero algunas versiones de firmware también restringen la suscripción a eventos.
4.4 La cámara funciona un día y después se queda offline hasta que se reinicia
Esto casi siempre es una expiración del lease DHCP (sin reserva estática) o un timeout del keep-alive de RTSP. Confirme que la reserva de IP estática del §2.3 está aplicada en el router, no solo en los ajustes de red de la propia cámara. Algunas cámaras respetan ambas; otras ignoran su propia IP estática y aceptan la que les asigne el router.
5. Bonus: añadir Frigate NVR para detección de objetos con IA
El movimiento ONVIF nativo de Home Assistant es binario: «algo se ha movido» o «nada se ha movido». Eso dispara muchos falsos positivos por hojas que cruzan el jardín o sombras al atardecer.
Frigate es un NVR gratuito y de código abierto que se ejecuta como add-on de Home Assistant y realiza detección local de objetos con IA sobre el feed de la cámara; así, en lugar de «movimiento», sus automatizaciones se disparan ante «persona», «coche», «paquete» o «perro». Todo se ejecuta en su host Home Assistant; ningún frame sale de la LAN.
Por qué el iSG Box SE es lo bastante potente para alojar Frigate:
- El detector por CPU por defecto de Frigate gestiona de 2 a 4 cámaras a 5–7 fps cada una en el iSG Box SE sin throttling térmico.
- Si más adelante escala a 6–8 cámaras, añada un acelerador Google Coral USB de 60 $ y Frigate descargará la inferencia en la TPU: el iSG Box SE dispone de ancho de banda USB de sobra para ello.
- La configuración lleva unos 15 minutos: instale el add-on de Frigate desde la tienda de add-ons de Home Assistant, pegue las URL RTSP ONVIF del §3 Paso 2 en
frigate.yamly recargue.
Combine eso con automatizaciones de Home Assistant («si Frigate detecta una persona en la puerta de entrada entre las 22:00 y las 6:00, enciende la luz del porche y haz parpadear la lámpara del salón tres veces») y obtendrá un sistema de seguridad inteligente cuyo único coste de funcionamiento es la factura de la luz. El iSG Box SE es el punto de partida con menos fricción para exactamente este stack.
6. FAQ
¿Necesito un servidor dedicado para ejecutar Home Assistant + ONVIF?
No. El LinknLink iSG Box SE (69,90 $) viene con Home Assistant preinstalado y gestiona de 2 a 4 cámaras ONVIF más Frigate NVR nada más sacarlo de la caja. Es la entrada más barata a un stack Home Assistant local-first: sin flashear una Raspberry Pi, sin Proxmox, sin suscripción.
¿Funciona ONVIF sin conexión a Internet?
Sí. ONVIF es un protocolo que funciona solo en la LAN. Una vez que sus cámaras, el host de Home Assistant y el iSG Box SE están en la misma red local, todo sigue funcionando durante un corte de Internet. Sin nube, sin suscripción, sin cuota mensual.
¿Cuántas cámaras puede gestionar el iSG Box SE por ONVIF?
La integración ONVIF nativa de Home Assistant gestiona sin problemas más de 8 cámaras en el iSG Box SE. Cuando añade Frigate NVR para detección de objetos con IA en el mismo dispositivo, recomendamos de 2 a 4 cámaras para una inferencia fluida en tiempo real, sin throttling térmico.
¿Necesito abrir puertos (port-forwarding)?
No para uso local. Para visualización remota, utilice Nabu Casa Home Assistant Cloud (6,50 $/mes) o una VPN como WireGuard o Tailscale. Nunca abra directamente los puertos ONVIF o RTSP: los puertos de cámaras expuestos están entre los objetivos más escaneados de la Internet pública.
¿Qué cámaras recomienda LinknLink para Home Assistant + ONVIF?
Hemos probado Reolink RLC-820A, Amcrest IP4M-1051 y Dahua IPC-HFW1435 con los ajustes ONVIF por defecto en el iSG Box SE. Las tres se descubren automáticamente, exponen los streams main y sub, y disparan eventos de movimiento con fiabilidad. Evite las cámaras que solo ofrecen apps propietarias en la nube: rara vez publican perfiles ONVIF utilizables.
7. Conclusión: empiece hoy su instalación ONVIF con el iSG Box SE
La integración ONVIF es el camino más corto entre «tengo una cámara IP» y «las luces se encienden cuando alguien sube por el camino de entrada, la HVAC cambia cuando el salón lleva 20 minutos vacío y el móvil me avisa cuando Frigate ve una furgoneta de reparto en lugar de un gato callejero». Y la forma más barata de llegar hasta ahí sin pasarse el fin de semana trasteando hardware es un LinknLink iSG Box SE (69,90 $): Home Assistant preinstalado, 100 % local, listo para ejecutar ONVIF y Frigate en cuanto abra la caja.
Siga los cinco pasos del §3 y tendrá su primera cámara retransmitiendo dentro de Home Assistant en menos de diez minutos. Añada la capa Frigate del §5 el siguiente fin de semana. Añada el resto de cámaras cuando quiera: la integración ONVIF escala a 8 o más dispositivos sin configuración adicional.