Agregar una cámara IP al Home Assistant suena simple, hasta que aprendes que cada marca de cámara habla su propio dialecto. La integración ONVIF es el único estándar que elimina el ruido: una única integración Home Assistant que funciona con clones de Reolink, Amcrest, Dahua, Hikvision y la mayoría de las cámaras IP "compatibles con ONVIF" vendidas desde 2018. Esta guía lo guía a través de la configuración completa, las trampas que nadie menciona en los hilos del foro y la forma más económica de ejecutarla: una LinknLink iSG Box SE con Home Assistant preinstalado para $69,90.
1. ¿Qué es ONVIF y por qué lo necesitan los usuarios de Home Assistant?
ONVIF (Foro de interfaz de video en red abierta) es un estándar abierto que define cómo las cámaras IP, los NVR y los clientes de video se comunican entre sí a través de una red local. En lugar de necesitar una aplicación diferente para cada marca de cámara, cualquier dispositivo compatible con ONVIF puede descubrir, transmitir y recibir eventos desde cualquier otro dispositivo compatible con ONVIF.
Para los usuarios de Home Assistant, eso es importante por tres razones:
- Privacidad y control local. ONVIF se ejecuta completamente en su LAN. Ningún video sale de su casa, no se requiere una cuenta, ningún fabricante de cámaras puede cortar su transmisión con una actualización de firmware. Esto es exactamente lo contrario del modelo Wyze, Ring o Arlo.
- Latencia. La alimentación de una cámara basada en la nube normalmente realiza un recorrido de ida y vuelta de 300 a 1200 ms a través de un servidor de proveedor antes de llegar a Home Assistant. ONVIF en la red local suele ser inferior a 150 ms, lo suficientemente rápido como para activar las automatizaciones Home Assistant (luces, HVAC, sirenas) antes de que la persona que entra en el cuadro haya terminado de dar dos pasos.
- Sin dependencia del proveedor. Si la marca de su cámara cierra o cambia a un modelo de suscripción, su sistema sigue funcionando. ONVIF es una especificación abierta estilo W3C con miles de dispositivos compatibles.
Si todavía está decidiendo si vale la pena un centro dedicado, cubrimos los conceptos básicos en ¿Qué es un centro de hogar inteligente?. Específicamente para ONVIF, un concentrador con suficiente espacio de CPU para manejar múltiples transmisiones RTSP no es negociable, razón por la cual la elección de hardware en la siguiente sección es importante.
Marcas de cámaras que funcionan bien con ONVIF + Home Assistant:
- Reolink (serie RLC, E1, Duo): excelente exposición del perfil ONVIF, transmisión principal + secundaria lista para usar
- Amcrest (series IP4M, IP5M): Dahua OEM, eventos ONVIF muy sólidos
- Dahua (series IPC-HFW, IPC-HDW): ONVIF nativo, eventos de movimiento sólidos
- Hikvision y cambios de marca (Annke, LTS, LaView): ONVIF funciona, pero habilítelo primero en la interfaz de usuario web de la cámara
- Ubiquiti UniFi Protect G3/G4/G5: ONVIF solo a través de la exportación Protect, la mayoría de los usuarios omiten esta ruta
- Axis, Bosch, Vivotek: excelente soporte ONVIF de nivel empresarial
Marcas de cámaras que se deben evitar para ONVIF: Wyze, Blink, Arlo, Ring, Google Nest. Estos son productos que dan prioridad a la nube; su exposición ONVIF es inexistente o inestable después de las actualizaciones de firmware.
La mejor puerta de enlace local para la automatización de cámaras
Antes de tocar la pantalla de integración ONVIF, asegúrese de tener estas cuatro cosas alineadas:
2.1 Un host Home Assistant lo suficientemente potente para transmisiones RTSP
El sistema operativo Home Assistant que se ejecuta en una Raspberry Pi 4 (4 GB) técnicamente funciona para 1 o 2 cámaras, pero cualquier cosa más, o el momento en que agrega Frigate para la detección de IA, y la Pi comienza a perder fotogramas y a sobrecalentarse.
Recomendamos el LinknLink iSG Caja SE para esta configuración. A $ 69,90, es el host Home Assistant más barato del mercado con HA preinstalado y tiene significativamente más computación que un Pi 4: suficiente espacio para más de 8 cámaras ONVIF en HA nativo, o de 2 a 4 cámaras con Frigate NVR en la misma caja. La comparación completa de hardware está en nuestra Guía de hardware Home Assistant.
Por qué iSG Box SE es el valor predeterminado correcto para una compilación ONVIF:
- Home Assistant preinstalado — conecte la alimentación y Ethernet, abra su navegador, finalice el asistente de configuración. No hay imágenes de tarjetas SD, no hay Proxmox, no hay espera en la cadena de suministro de Home Assistant Yellow.
- Arquitectura local primero — Control 100% local, sin cuenta en la nube, sin tarifa mensual.
- Suficiente CPU para fragata — la bonificación §5 en la detección de objetos con IA funciona sin agregar un acelerador USB Coral para una configuración de 2 a 4 cámaras.
- Precio — $69,90 frente a Home Assistant Green a $158,90 o un kit Raspberry Pi 5 que supera los $120 una vez que agregas un SSD y una carcasa.
2.2 Una cámara IP compatible con ONVIF en la misma LAN
Consulte la hoja de especificaciones de la cámara o la interfaz de usuario de administración para ver la opción "ONVIF". La mayoría de las cámaras de las marcas del §1 se envían con ONVIF habilitado pero sin contraseña; agregará las credenciales en el §3.
2.3 Una reserva de IP estática en tu router
Home Assistant integra cámaras por dirección IP. Si su enrutador le entrega a la cámara una nueva IP la próxima semana, la integración se interrumpe silenciosamente. En la configuración DHCP de su enrutador, reserve una IP LAN permanente para la dirección MAC de cada cámara (normalmente se muestra en la interfaz de usuario de administración de la cámara).
2.4 Credenciales de administrador de la cámara
No son los valores predeterminados de fábrica; cámbielos primero. Las credenciales ONVIF se envían a través de la LAN en autenticación de resumen de forma predeterminada, y las contraseñas predeterminadas de fábrica siguen siendo la superficie más escaneada en cualquier red doméstica.
Configuración de la cámara RTSP local
Con el hardware listo, la integración real lleva menos de diez minutos. Aquí están los cinco pasos exactos.
Paso 1: habilite ONVIF en la interfaz de usuario web de la cámara
Abra la IP de la cámara en su navegador (p. ej. http://192.168.1.50), inicie sesión con credenciales de administrador y busque la sección ONVIF. Caminos por marca:
- Reoenlace: Configuración del dispositivo → Red → Avanzado → Configuración de puerto → marque "ONVIF"
- Amcrest/Dahua: Configuración → Red → Conexión → ONVIF → Autenticación = "Resumen" o "Ninguno"
- Hikvisión: Configuración → Red → Configuración avanzada → Protocolo de integración → habilitar ONVIF y crear un usuario ONVIF dedicado
Hikvision es la única marca que se envía con ONVIF deshabilitado de forma predeterminada y requiere una cuenta de usuario ONVIF separada; configúrela antes de continuar.
Paso 2: anote las URL de transmisión RTSP (opcional pero útil)
Mientras esté en la interfaz de usuario web, copie las URL RTSP de transmisión principal y secundaria. La integración ONVIF de Home Assistant los descubre automáticamente, pero tenerlos a mano hace que la depuración sea mucho más rápida si el descubrimiento falla. Formatos típicos:
- Reoenlace principal:
rtsp://admin:contraseña@192.168.1.50:554/h264Preview_01_main - Reolink sub:
rtsp://admin:contraseña@192.168.1.50:554/h264Preview_01_sub - Amcrest principal:
rtsp://admin:contraseña@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0 - Substituto de Amcrest:
rtsp://admin:contraseña@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1
Paso 3: abra Home Assistant y agregue la integración ONVIF
En la interfaz de usuario de Home Assistant (ya sea que se ejecute en iSG Box SE o en otro lugar):
- Ir a Configuración → Dispositivos y servicios
- Haga clic + Agregar integración (abajo a la derecha)
- Buscar "ONVIF" y selecciónalo
Home Assistant escaneará la red local a través de WS-Discovery. La mayoría de las cámaras aparecen automáticamente. Si el tuyo no lo hace, puedes agregarlo manualmente por IP.
Paso 4: Ingrese IP, puerto y credenciales
El puerto ONVIF predeterminado es 80 (HTTP) en la mayoría de las cámaras, no 554 (es decir, RTSP, un puerto diferente). Si su cámara utiliza un puerto ONVIF no estándar (2020, 8000, 8899 son comunes), aparecerá en la interfaz de usuario web de la cámara en la sección Red u ONVIF.
Introduzca:
- Anfitrión: IP LAN estática de la cámara
- Puerto: normalmente 80; Hikvision suele utilizar 80, Dahua 80, Reolink 8000
- Nombre de usuario/Contraseña: las credenciales ONVIF que configuró en §2.4 (Hikvision: el usuario ONVIF dedicado creado en el Paso 1)
Paso 5: elija los perfiles (transmisión principal + secundaria)
Home Assistant expondrá cada "perfil" ONVIF que anuncia la cámara, generalmente uno para la transmisión principal (alta resolución) y otro para la transmisión secundaria (baja resolución). Habilite ambos:
- corriente principal — utilizado para grabaciones, instantáneas y visualización de alta calidad
- Subcorriente — utilizado para el mosaico del tablero Home Assistant Lovelace (para que el tablero se cargue rápidamente incluso en dispositivos móviles)
Haga clic Enviar. La cámara ahora aparece debajo Dispositivos y servicios con entidades para la transmisión en vivo, sensor de movimiento y (si la cámara lo admite) sensores binarios para cualquier evento que active la cámara: cruce de línea, detección de intrusiones, clasificación de personas/vehículos, manipulación.
Solución de problemas de Reolink ONVIF
Estos son los cuatro problemas que generan el 90% de los hilos del foro sobre Home Assistant ONVIF. A continuación se explica cómo solucionar cada uno de ellos en menos de dos minutos.
4.1 "Cámara no descubierta" durante Agregar integración
WS-Discovery utiliza DNS de multidifusión (mDNS). Si su host Home Assistant y su cámara están en diferentes VLAN o diferentes SSID de WiFi, los paquetes mDNS no cruzan el límite. Correcciones, en orden de esfuerzo:
- Coloque la cámara en la misma subred que Home Assistant temporalmente para su descubrimiento y luego muévala hacia atrás.
- Agregue la cámara manualmente por IP durante la configuración de la integración (WS-Discovery es una conveniencia, no un requisito).
- Habilite la reflexión mDNS/Avahi en su enrutador (UniFi: "Multicast DNS", pfSense: paquete "Avahi", OpenWrt: "umdns"). Esta es la solución permanente.
4.2 La transmisión en vivo sigue almacenándose en el búfer o muestra "Transmisión no disponible"
La transmisión principal a 4K o 1440p + 30 fps suele ser demasiado para el panel de Lovelace, especialmente en dispositivos móviles. Cambie el mosaico del panel a la secuencia secundaria:
- Configuración → Dispositivos y servicios → Integración ONVIF → Configurar → desmarque "Perfil principal" para la tarjeta de entidad de imagen
- O directamente en la tarjeta de la cámara YAML: configurar
fuente_transmisióna la entidad del subperfil
Frigate NVR (tratado en el §5) es una solución más limpia en este caso: vuelve a codificar la transmisión una vez y ofrece HLS/WebRTC de baja latencia a todos los clientes.
4.3 Entidades de detección de movimiento que no activan 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 habilitada localmente y (b) estar configurada para publicar eventos ONVIF. Pasos:
- En la interfaz de usuario web de la cámara, habilite la detección de movimiento (normalmente Evento → Detección de movimiento → Activar)
- Busque la configuración de ONVIF o "evento inteligente" y habilite "Eventos ONVIF" o "Eventos push"
- En Home Assistant, reinicie la integración ONVIF: Configuración → Dispositivos y servicios → ONVIF → menú de tres puntos → Recargar
Si está usando una cámara Hikvision o Hikvision-OEM y los eventos aún no se activan, verifique que el usuario ONVIF que creó en el §3 Paso 1 tenga los permisos "Evento" y "Medios"; de manera predeterminada, el usuario ONVIF es de solo lectura para Usuario gestión, lo cual es correcto, pero algunas versiones de firmware también restringen la suscripción a eventos.
4.4 La cámara funciona durante un día y luego se desconecta hasta que se reinicia
Casi siempre se trata de una expiración de la concesión de DHCP (sin reserva estática) o un tiempo de espera de mantenimiento de RTSP. Confirme que la reserva de IP estática del §2.3 se aplica en el enrutador, no sólo en la configuración de red de la propia cámara. Algunas cámaras honran a ambos; algunos ignoran su propia IP estática y toman lo que les asigne el enrutador.
5. Bonificación: agregar Frigate NVR para la detección de objetos con IA
El movimiento nativo de Home Assistant ONVIF es binario: "algo se movió" o "nada se movió". Eso desencadena muchos falsos positivos debido a las hojas que vuelan sobre el césped o las sombras al atardecer.
fragata es un NVR gratuito y de código abierto que se ejecuta como un complemento Home Assistant y detecta objetos con IA local en la transmisión de la cámara, por lo que, en lugar de "movimiento", sus automatizaciones se activan en "persona", "automóvil", "paquete" o "perro". Todo se ejecuta en su host Home Assistant; ninguna trama sale de la LAN.
Por qué iSG Box SE es lo suficientemente potente como para albergar Frigate:
- El detector de CPU predeterminado de Frigate maneja de 2 a 4 cámaras a 5 a 7 fps cada una en el iSG Box SE sin limitación térmica.
- Si escala a 6 a 8 cámaras más adelante, agregue un acelerador USB Google Coral de $ 60 y Frigate descarga la inferencia al TPU: iSG Box SE tiene ancho de banda USB adicional para esto.
- La configuración tarda ~15 minutos: instale el complemento Frigate desde la tienda de complementos Home Assistant, pegue sus URL ONVIF RTSP del §3 Paso 2 en
fragata.yaml, recargar.
Combine eso con las automatizaciones Home Assistant ("si Frigate detecta una persona en la puerta de entrada entre las 10 p. m. y las 6 a. m., encienda la luz del porche y encienda la lámpara de la sala tres veces") y tendrá un sistema de seguridad inteligente que no cuesta nada más allá de la factura de electricidad. el Caja iSG SE es el punto de partida de menor fricción exactamente para esta pila.
Preguntas frecuentes sobre la integración de Home Assistant ONVIF
¿Puede Home Assistant usar cámaras ONVIF sin acceso a la nube?
Sí. Home Assistant puede conectarse a muchas cámaras ONVIF en la red local utilizando la dirección IP de la cámara, el puerto ONVIF y las credenciales locales.
¿Por qué una cámara Reolink necesita configuración RTSP con ONVIF?
ONVIF se encarga del descubrimiento y el control, mientras que RTSP suele transmitir la transmisión de vídeo en directo. Si el video falla, confirme la ruta RTSP, el firmware y los permisos de LAN.
¿Qué puerta de enlace LinknLink es mejor para la automatización de cámaras locales?
Utilice iSG Box SE para una puerta de enlace Home Assistant compacta, o iSG Display Max cuando también desee una pantalla de pared para los controles de la cámara y la sala.
7. Conclusión: inicie su configuración ONVIF con iSG Box SE hoy
La integración ONVIF es el camino más corto desde "tengo una cámara IP" hasta "mis luces se encienden cuando alguien camina por el camino de entrada, mi HVAC cambia cuando la sala de estar está vacía durante 20 minutos y mi teléfono me hace sonar cuando Frigate ve una camioneta de reparto en lugar de un gato callejero". Y la forma más económica de llegar allí sin necesidad de realizar ajustes en el hardware durante el fin de semana es Caja LinknLink iSG SE ($69,90) — Home Assistant preinstalado, 100% local, listo para ejecutar ONVIF y Frigate en el momento en que abres la caja.
Siga los cinco pasos del §3 y tendrá su primera cámara transmitiendo dentro de Home Assistant en menos de diez minutos. Agrega la capa Fragata §5 el próximo fin de semana. Agregue el resto de sus cámaras cuando lo desee: la integración ONVIF escala a más de 8 dispositivos sin necesidad de configuración adicional.