Guide de configuration de l'intégration Home Assistant ONVIF pour les caméras RTSP locales

 

Ajouter une caméra IP au Home Assistant semble simple, jusqu'à ce que vous appreniez que chaque marque de caméra parle son propre dialecte. L'intégration ONVIF est la seule norme qui coupe le bruit : une seule intégration Home Assistant qui fonctionne avec les clones Reolink, Amcrest, Dahua, Hikvision et la plupart des caméras IP « compatibles ONVIF » vendues depuis 2018. Ce guide vous guide à travers la configuration complète, les pièges que personne ne mentionne dans les fils de discussion et le moyen le moins cher de l'exécuter : un LinknLink iSG Box SE avec Home Assistant préinstallé pour 69,90 $.

LinknLink iSG Box SE Passerelle Home Assistant pour l'automatisation locale des caméras ONVIF

1. Qu'est-ce que le ONVIF et pourquoi les utilisateurs du Home Assistant en ont besoin

ONVIF (Open Network Video Interface Forum) est une norme ouverte qui définit la manière dont les caméras IP, les NVR et les clients vidéo communiquent entre eux sur un réseau local. Au lieu d'avoir besoin d'une application différente pour chaque marque de caméra, n'importe quel appareil compatible ONVIF peut découvrir, diffuser et recevoir des événements de n'importe quel autre appareil compatible ONVIF.

Pour les utilisateurs de Home Assistant, cela est important pour trois raisons :

  • Confidentialité et contrôle local. Le ONVIF fonctionne entièrement sur votre réseau local. Aucune vidéo ne quitte votre maison, aucun compte n'est requis, aucun fabricant de caméra ne peut désactiver votre flux avec une mise à jour du micrologiciel. C’est exactement le contraire du modèle Wyze, Ring ou Arlo.
  • Latence. Un flux de caméra basé sur le cloud effectue généralement un aller-retour de 300 à 1 200 ms via un serveur d'un fournisseur avant d'atteindre Home Assistant. Le ONVIF sur le réseau local dure généralement moins de 150 ms – assez rapide pour déclencher les automatisations du Home Assistant (lumières, HVAC, sirènes) avant que la personne entrant dans le cadre n'ait fini de faire deux pas.
  • Pas de dépendance envers un fournisseur. Si la marque de votre caméra cesse ses activités ou passe à un modèle d'abonnement, votre système continue de fonctionner. ONVIF est une spécification ouverte de style W3C avec des milliers d'appareils compatibles.

Si vous êtes encore en train de décider si un hub dédié en vaut la peine, nous abordons les principes fondamentaux dans Qu'est-ce qu'un hub pour maison intelligente. Pour le ONVIF en particulier, un hub doté d'une marge CPU suffisante pour gérer plusieurs flux RTSP n'est pas négociable. C'est pourquoi le choix matériel dans la section suivante est important.

Marques d'appareils photo qui fonctionnent bien avec ONVIF + Home Assistant :

  • Reolink (séries RLC, E1, Duo) — excellente exposition du profil ONVIF, flux principal et secondaire prêts à l'emploi
  • Amcrest (séries IP4M, IP5M) — Dahua OEM, événements ONVIF très solides
  • Dahua (séries IPC-HFW, IPC-HDW) — ONVIF natif, événements de mouvement à toute épreuve
  • Hikvision et changements de marque (Annke, LTS, LaView) – ONVIF fonctionne, mais activez-le d'abord dans l'interface utilisateur Web de la caméra.
  • Ubiquiti UniFi Protect G3/G4/G5 — ONVIF uniquement via l'exportation Protect, la plupart des utilisateurs ignorent ce chemin
  • Axis, Bosch, Vivotek – niveau entreprise, excellente prise en charge du ONVIF

Marques d'appareils photo à éviter pour le ONVIF : Wyze, Blink, Arlo, Ring, Google Nest. Ce sont des produits axés sur le cloud ; leur exposition au ONVIF est soit inexistante, soit instable après les mises à jour du firmware.

Interface de configuration de caméra locale Home Assistant ONVIF et RTSP

Meilleure passerelle locale pour l'automatisation des caméras

Avant de toucher l'écran d'intégration du ONVIF, assurez-vous d'avoir aligné ces quatre éléments :

2.1 Un hôte Home Assistant suffisamment puissant pour les flux RTSP

Le système d'exploitation Home Assistant fonctionnant sur un Raspberry Pi 4 (4 Go) fonctionne techniquement pour 1 à 2 caméras, mais rien de plus - ou au moment où vous ajoutez Frigate pour la détection de l'IA - et le Pi commence à perdre des images et à surchauffer.

Nous recommandons le LinknLink iSG Box SE pour cette configuration. À 69,90 $, il s'agit de l'hôte Home Assistant le moins cher du marché avec HA préinstallé, et il offre beaucoup plus de calcul qu'un Pi 4 – suffisamment d'espace libre pour plus de 8 caméras ONVIF en HA natif, ou 2 à 4 caméras avec Frigate NVR sur le même boîtier. La comparaison complète du matériel est dans notre Guide du matériel Home Assistant.

Pourquoi iSG Box SE est la bonne valeur par défaut pour une version ONVIF :

  • Home Assistant préinstallé - branchez l'alimentation et Ethernet, ouvrez votre navigateur, terminez l'assistant de configuration. Pas d'imagerie de carte SD, pas de Proxmox, pas d'attente dans la chaîne d'approvisionnement jaune Home Assistant.
  • Architecture axée sur le local — Contrôle local à 100 %, pas de compte cloud, pas de frais mensuels.
  • Assez de CPU pour la frégate — le bonus §5 sur la détection d'objets AI fonctionne sans ajouter d'accélérateur USB Coral pour une configuration de 2 à 4 caméras.
  • Prix - 69,90 $ contre Home Assistant Green à 158,90 $ ou un kit Raspberry Pi 5 qui atterrit au-dessus de 120 $ une fois que vous ajoutez un SSD et un boîtier.

2.2 Une caméra IP compatible ONVIF sur le même LAN

Consultez la fiche technique de la caméra ou l'interface utilisateur d'administration pour la bascule "ONVIF". La plupart des caméras des marques du §1 sont livrées avec ONVIF activé mais sans mot de passe — vous ajouterez les informations d'identification au §3.

2.3 Une réservation IP statique dans votre routeur

Home Assistant intègre des caméras par adresse IP. Si votre routeur transmet à la caméra une nouvelle adresse IP la semaine prochaine, l'intégration s'interrompt silencieusement. Dans les paramètres DHCP de votre routeur, réservez une adresse IP LAN permanente pour l'adresse MAC de chaque caméra (généralement affichée dans l'interface utilisateur d'administration de la caméra).

2.4 Informations d'identification de l'administrateur de la caméra

Il ne s'agit pas des paramètres d'usine par défaut : modifiez-les d'abord. Les informations d'identification du ONVIF sont envoyées par défaut sur le réseau local dans l'authentification Digest, et les mots de passe par défaut restent la surface la plus analysée dans n'importe quel réseau domestique.

Configuration locale de la caméra RTSP

Une fois le matériel prêt, l’intégration réelle prend moins de dix minutes. Voici les cinq étapes exactes.

Étape 1 — Activez le ONVIF dans l'interface utilisateur Web de la caméra

Ouvrez l'adresse IP de la caméra dans votre navigateur (par ex. http://192.168.1.50), connectez-vous avec les informations d'identification d'administrateur et recherchez la section ONVIF. Parcours par marque :

  • Reolink : Paramètres de l'appareil → Réseau → Avancé → Paramètres du port → cochez « ONVIF »
  • Amcrest/Dahua : Configuration → Réseau → Connexion → ONVIF → Authentification = "Digest" ou "Aucun"
  • Hikvision : Configuration → Réseau → Paramètres avancés → Protocole d'intégration → activez ONVIF et créez un utilisateur ONVIF dédié

Hikvision est la seule marque livrée avec ONVIF désactivé par défaut et nécessite un compte utilisateur ONVIF distinct – configurez-le avant de continuer.

Étape 2 — Notez les URL du flux RTSP (facultatif mais utile)

Pendant que vous êtes dans l’interface utilisateur Web, copiez les URL RTSP du flux principal et du sous-flux. L'intégration ONVIF de Home Assistant les découvre automatiquement, mais les avoir à portée de main rend le débogage beaucoup plus rapide en cas d'échec de la découverte. Formats typiques :

  • Reolink principal : rtsp://admin:password@192.168.1.50:554/h264Preview_01_main
  • Sous-marin Reolink : rtsp://admin:password@192.168.1.50:554/h264Preview_01_sub
  • Amcrest principal : rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0
  • Sous Amcrest : rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1

Étape 3 — Ouvrez Home Assistant et ajoutez l'intégration ONVIF

Dans l'interface utilisateur Home Assistant (qu'elle soit exécutée sur iSG Box SE ou ailleurs) :

  1. Aller à Paramètres → Appareils et services
  2. Cliquez + Ajouter une intégration (en bas à droite)
  3. Rechercher "ONVIF" et sélectionnez-le

Home Assistant analysera le réseau local via WS-Discovery. La plupart des caméras apparaissent automatiquement. Si ce n’est pas le cas, vous pouvez l’ajouter manuellement par IP.

Étape 4 — Entrez l'adresse IP, le port et les informations d'identification

Le port ONVIF par défaut est 80 (HTTP) sur la plupart des caméras, pas 554 (c'est-à-dire RTSP — un port différent). Si votre caméra utilise un port ONVIF non standard (2020, 8000, 8899 sont courants), il sera répertorié dans l'interface utilisateur Web de la caméra sous la section Réseau ou ONVIF.

Entrez :

  • Hôte : l'adresse IP LAN statique de la caméra
  • Port : généralement 80 ; Hikvision utilise souvent 80, Dahua 80, Reolink 8000
  • Nom d'utilisateur/Mot de passe : les informations d'identification ONVIF que vous avez définies au §2.4 (Hikvision : l'utilisateur ONVIF dédié créé à l'étape 1)

Étape 5 — Choisissez les profils (flux principal + secondaire)

Home Assistant exposera chaque "profil" ONVIF annoncé par la caméra - généralement un pour le flux principal (haute résolution) et un pour le flux secondaire (basse résolution). Activez les deux :

  • Flux principal — utilisé pour les enregistrements, les instantanés et la visualisation de haute qualité
  • Sous-flux — utilisé pour la vignette du tableau de bord Home Assistant Lovelace (pour que le tableau de bord se charge rapidement même sur mobile)

Cliquez Soumettre. La caméra apparaît maintenant sous Appareils et services avec des entités pour le flux en direct, un capteur de mouvement et (si la caméra le prend en charge) des capteurs binaires pour tout événement déclenché par la caméra : franchissement de ligne, détection d'intrusion, classification humain/véhicule, falsification.

Reolink ONVIF Dépannage

Ce sont les quatre problèmes qui génèrent 90 % des discussions sur le forum concernant Home Assistant ONVIF. Voici comment résoudre chacun d’eux en moins de deux minutes.

4.1 "Caméra non découverte" lors de l'ajout d'une intégration

WS-Discovery utilise le DNS multidiffusion (mDNS). Si votre hôte Home Assistant et votre caméra se trouvent sur des VLAN différents ou des SSID WiFi différents, les paquets mDNS ne traversent pas la frontière. Correctifs, par ordre d'effort :

  • Placez temporairement la caméra sur le même sous-réseau que le Home Assistant pour la découverte, puis déplacez-la en arrière.
  • Ajoutez la caméra manuellement par IP lors de la configuration de l'intégration (WS-Discovery est une commodité, pas une exigence).
  • Activez la réflexion mDNS / Avahi sur votre routeur (UniFi : « Multicast DNS », pfSense : package « Avahi », OpenWrt : « umdns »). C'est la solution permanente.

4.2 Le flux en direct continue de se mettre en mémoire tampon ou d'afficher « Flux non disponible »

Le flux principal en 4K ou 1440p + 30 fps est souvent trop pour le tableau de bord Lovelace, notamment sur mobile. Basculez la vignette du tableau de bord vers le sous-flux :

  • Paramètres → Appareils et services → Intégration ONVIF → Configurer → décochez "Profil principal" pour la carte d'entité image
  • Ou directement dans la carte caméra YAML : définir stream_source à l'entité de sous-profil

Frigate NVR (abordé au §5) est une solution plus propre ici : il réencode le flux une fois et sert du HLS/WebRTC à faible latence à tous les clients.

4.3 Les entités de détection de mouvement ne déclenchent pas d'événements dans Home Assistant

Les événements de mouvement ONVIF sont facultatifs dans la spécification : la caméra doit à la fois (a) avoir la détection de mouvement activée localement et (b) être configurée pour publier des événements ONVIF. Étapes :

  1. Dans l'interface utilisateur Web de la caméra, activez la détection de mouvement (généralement Événement → Détection de mouvement → Activer)
  2. Recherchez les paramètres du ONVIF ou « événement intelligent » et activez « Événements ONVIF » ou « Événements push »
  3. Dans Home Assistant, redémarrez l'intégration ONVIF : Paramètres → Appareils et services → ONVIF → menu à trois points → Recharger

Si vous êtes sur une caméra Hikvision ou Hikvision-OEM et que les événements ne se déclenchent toujours pas, vérifiez que l'utilisateur ONVIF que vous avez créé au §3 Étape 1 dispose des autorisations « Événement » et « Média » — par défaut, l'utilisateur ONVIF est en lecture seule pour Utilisateur gestion, ce qui est correct, mais certaines versions de firmware restreignent également l'abonnement aux événements.

4.4 La caméra fonctionne pendant une journée, puis se déconnecte jusqu'à un redémarrage

Il s'agit presque toujours d'une expiration de bail DHCP (pas de réservation statique) ou d'un délai d'expiration de conservation RTSP. Confirmez que la réservation IP statique du §2.3 est appliquée sur le routeur, pas seulement dans les paramètres réseau de la caméra. Certaines caméras honorent les deux ; certains ignorent leur propre adresse IP statique et prennent ce que le routeur leur attribue.

5. Bonus : ajout de Frigate NVR pour la détection d'objets IA

Le mouvement natif Home Assistant ONVIF est binaire : « quelque chose a bougé » ou « rien n'a bougé ». Cela déclenche de nombreux faux positifs dus aux feuilles soufflées sur la pelouse ou aux ombres au coucher du soleil.

Frégate est un NVR gratuit et open source qui fonctionne comme un module complémentaire Home Assistant et effectue une détection locale des objets IA sur le flux de la caméra. Ainsi, au lieu du « mouvement », vos automatisations se déclenchent sur « personne », « voiture », « colis » ou « chien ». Tout fonctionne sur votre hôte Home Assistant ; aucune trame ne quitte le réseau local.

Pourquoi le iSG Box SE est suffisamment puissant pour héberger Frigate :

  • Le détecteur de processeur par défaut de Frigate gère 2 à 4 caméras à 5 à 7 ips chacune sur le iSG Box SE sans limitation thermique.
  • Si vous passez à 6 à 8 caméras plus tard, ajoutez un accélérateur USB Google Coral à 60 $ et Frigate décharge l'inférence vers le TPU - le iSG Box SE dispose d'une bande passante USB disponible pour cela.
  • L'installation prend environ 15 minutes : installez le module complémentaire Frigate à partir de la boutique de modules complémentaires Home Assistant, collez vos URL ONVIF RTSP du §3 Étape 2 dans frigate.yaml, rechargez.

Associez cela aux automatisations Home Assistant (« si Frigate détecte une personne à la porte d'entrée entre 22 heures et 6 heures du matin, allumez la lumière du porche et faites clignoter la lampe du salon trois fois ») et vous obtenez un système de sécurité intelligent qui ne coûte rien au-delà de la facture d'électricité. Le iSG Box SE est le point de départ à friction la plus faible pour exactement cette pile.

6. FAQ sur l'intégration du Home Assistant ONVIF

Le Home Assistant peut-il utiliser les caméras ONVIF sans accès au cloud ?

Oui. Le Home Assistant peut se connecter à de nombreuses caméras ONVIF sur le réseau local à l'aide de l'adresse IP de la caméra, du port ONVIF et des informations d'identification locales.

Pourquoi une caméra Reolink a-t-elle besoin des paramètres RTSP avec ONVIF ?

Le ONVIF gère la découverte et le contrôle, tandis que le RTSP transporte souvent le flux vidéo en direct. Si la vidéo échoue, confirmez le chemin du RTSP, le micrologiciel et les autorisations LAN.

Quelle passerelle LinknLink dois-je choisir pour l'automatisation des caméras locales ?

Utilisez le iSG Box SE pour une passerelle Home Assistant compacte, ou le iSG Display Max lorsque vous souhaitez également un écran mural pour les commandes de caméra et de pièce.

7. Conclusion : démarrez votre configuration ONVIF avec iSG Box SE aujourd'hui

L'intégration ONVIF est le chemin le plus court entre "J'ai une caméra IP" et "mes lumières s'allument lorsque quelqu'un monte dans l'allée, mon HVAC change lorsque le salon est vide pendant 20 minutes et mon téléphone me signale lorsque Frigate voit une camionnette de livraison au lieu d'un chat errant". Et le moyen le moins cher d'y arriver sans bricoler du matériel pendant un week-end est de LinknLink iSG Box SE (69,90 $) — Home Assistant préinstallé, 100% local, prêt à exécuter ONVIF et Frigate dès l'ouverture de la boîte.

Suivez les cinq étapes du §3 et vous aurez votre première caméra en streaming dans Home Assistant en moins de dix minutes. Ajoutez la couche Frégate §5 le week-end prochain. Ajoutez le reste de vos caméras quand vous le souhaitez : l'intégration du ONVIF s'adapte à plus de 8 appareils sans aucune configuration supplémentaire.

Procurez-vous le iSG Box SE →