Dépannage ONVIF Home Assistant : RTSP, événements et Reolink

9 mai 2026

Dépannage ONVIF dans Home Assistant : RTSP, événements et Reolink LinknLink

La configuration d’une caméra ONVIF dans Home Assistant paraît simple, jusqu’à ce qu’un flux vidéo échoue, qu’aucun événement de détection de mouvement ne se déclenche ou qu’une caméra Reolink apparaisse à un endroit mais pas à un autre.

Ceci dépannage Ce guide s’adresse aux utilisateurs qui ont déjà essayé la configuration de base et souhaitent aller plus loin : quels points vérifier lorsque la détection fonctionne, mais pas la vidéo, comment RTSP complète ONVIF, dans quels cas l’intégration native de Reolink est préférable et comment une passerelle Home Assistant locale peut préserver la confidentialité et la fiabilité des automatisations liées aux caméras.

Introduction : la découverte ONVIF n’est que la première étape

Home Assistant peut détecter une caméra ONVIF sans pour autant permettre une utilisation satisfaisante de celle-ci. La détection confirme que l’appareil est accessible et qu’il annonce des services ONVIF. Elle ne garantit pas que le bon profil de flux, le service d’événements, le nom d’utilisateur, le mot de passe et le routage réseau soient configurés pour les automatisations.

Cette distinction est importante, car de nombreux utilisateurs cherchent le problème au mauvais niveau. Ils suppriment puis ajoutent à nouveau l’intégration alors que le véritable problème vient d’un chemin RTSP. Ils recréent leurs automatisations alors que les événements ONVIF sont désactivés dans l’interface web de la caméra. Ils mettent en cause Home Assistant alors que la caméra est isolée sur un réseau invité.

Utilisez ce guide comme liste de contrôle : d’abord le réseau, puis les paramètres de la caméra, ensuite l’intégration à Home Assistant et, enfin, la logique d’automatisation.

Solution 1 : Vérifiez que la caméra est accessible sur le réseau local

Commencez par les bases. L’hôte Home Assistant et la caméra doivent se trouver sur des segments réseau capables de communiquer entre eux. Si la caméra est connectée à un réseau WiFi invité, à un VLAN sans routage ou à un sous-réseau bloqué par des règles de pare-feu, la détection ONVIF peut être aléatoire et les flux vidéo peuvent ne pas fonctionner.

Vérifiez l’adresse IP de la caméra dans l’interface du routeur ou dans l’application de la caméra.
Ouvrez l’interface web de la caméra depuis le même réseau que Home Assistant.
Configurez une réservation d’adresse IP fixe pour que l’adresse de la caméra ne change pas après un redémarrage.
Désactivez l’isolation du réseau invité pour la caméra ou créez une règle de pare-feu avec des restrictions adaptées.

Dans la mesure du possible, connectez les caméras, les capteurs et les concentrateurs de télécommande au même réseau local de confiance. Cela simplifie considérablement la détection des appareils et le dépannage des automatisations, sans que les étapes de diagnostic dépendent d’un modèle de passerelle particulier.

Vérifiez les ports ONVIF et RTSP avant de modifier l’intégration

Les numéros de port ne sont pas identiques pour tous les modèles de caméras. Si un résultat de recherche ou un guide du fabricant mentionne 8899, 8000 ou un autre port, considérez ce numéro comme une valeur à vérifier plutôt que comme une valeur par défaut à recopier. Consultez la documentation de la caméra et ses paramètres locaux, puis vérifiez que le port ONVIF ou RTSP sélectionné est accessible depuis Home Assistant. Réutiliser le numéro de port d’un autre modèle peut rendre la détection aléatoire ou empêcher l’accès au flux.

Utilisez un compte dédié à la caméra disposant des autorisations requises par l’intégration, et testez le flux après toute modification des ports ou des identifiants. Limitez l’accès à la caméra au réseau local de confiance ou à une connexion à distance spécifiquement sécurisée ; n’exposez pas directement les ports de la caméra sur Internet.

Solution 2 : séparer le contrôle ONVIF du flux vidéo RTSP

ONVIF et RTSP fonctionnent souvent ensemble, mais ce sont deux choses différentes. ONVIF aide Home Assistant à découvrir les fonctionnalités des caméras et, dans certains cas, à recevoir des événements. RTSP sert généralement à transmettre le flux vidéo proprement dit. Une caméra peut répondre aux requêtes ONVIF alors que son flux RTSP est désactivé, protégé par un mot de passe ou configuré avec un codec que Home Assistant gère mal.

Consultez l’interface web de la caméra pour vérifier les paramètres de diffusion. Activez RTSP si la caméra dispose d’une option distincte à cet effet. Testez le flux dans un lecteur local avant de modifier les paramètres de Home Assistant. Si la caméra propose plusieurs flux, utilisez le flux secondaire à plus basse résolution pour les tableaux de bord et réservez le flux principal à l’enregistrement ou à l’examen détaillé des images.

Pour afficher les flux et les commandes sur un écran, prévoyez le Tableau de bord local des caméras avec ONVIF et RTSP autour du chemin d’accès au flux fonctionnel plutôt que de la seule découverte ONVIF.

L’erreur la plus courante consiste à utiliser un réglage de caméra disponible uniquement dans l’application et à supposer que Home Assistant peut le reprendre. L’automatisation locale d’une caméra nécessite un accès local à son flux vidéo.

Solution 3 : Reolink via ONVIF ou intégration native Reolink

Les caméras Reolink posent souvent la question du choix de l’intégration. L’intégration native Reolink peut donner accès à des fonctionnalités propres aux caméras et simplifier la gestion d’entités comme la détection de mouvement, la détection de personnes ou les commandes de sirène. ONVIF est utile lorsque vous souhaitez utiliser une méthode de connexion standard aux caméras ou comparer leur comportement entre différentes marques.

N’en faites pas une question de fidélité, mais une question de fonctionnement. Si l’intégration native expose les entités dont vous avez besoin et fonctionne suffisamment en local pour votre installation, utilisez-la. S’il manque un flux ou un événement nécessaire dans l’intégration native, testez directement ONVIF et RTSP.

Pour les foyers équipés de différentes caméras, consignez la méthode de connexion qui fonctionne pour chacune. Un modèle Reolink peut se comporter différemment d’un autre, car le micrologiciel, les paramètres de flux et la prise en charge des événements varient.

Correctif 4 : les événements de mouvement ne sont pas synonymes d’automatisations utiles

De nombreuses recherches de dépannage ONVIF sont motivées par l’absence d’événements de mouvement dans Home Assistant. Commencez par vérifier que la détection de mouvement est activée sur la caméra elle-même. Certaines caméras nécessitent d’activer les événements ONVIF, la détection intelligente ou la sortie d’alarme séparément de la diffusion vidéo.

Une fois les événements visibles, déterminez s’ils doivent déclencher directement des automatisations. La détection de mouvement par caméra peut générer de fausses alertes à l’extérieur et être trop lente à l’intérieur. Pour automatiser une pièce, associez les informations contextuelles de la caméra à des capteurs dédiés tels que Capteurs de présence LinknLink. Pour commander les appareils, faites passer l’action par Home Assistant et des hubs de télécommande tels que eRemote HA.

Pour les pièces où la détection de mouvement par caméra ne doit pas être le seul déclencheur, combinez le dispositif de caméra avec le Plan d’automatisation d’une pièce pour Home Assistant pour que les capteurs, la commande IR/RF et les informations contextuelles des caméras fonctionnent ensemble.

Une meilleure approche repose sur plusieurs niveaux : les événements des caméras pour le contexte de sécurité, les capteurs de présence pour l’occupation des pièces et Home Assistant pour gérer les règles en local.

Solution 5 : utilisez avec précaution les circuits d’enregistrement local et de notification

Un système de caméras fonctionnant en local doit conserver les flux essentiels au sein du domicile. Cela ne signifie pas que chaque notification doit être locale, mais le flux vidéo, le déclenchement des événements et les règles d’automatisation doivent continuer à fonctionner même lorsque le cloud du fabricant ralentit.

Si vous enregistrez des séquences vidéo, vérifiez vos besoins en stockage avant d’activer l’enregistrement continu. Si vous envoyez des notifications, ajustez l’automatisation pour éviter la lassitude liée aux alertes. Une installation de caméras fiable n’est pas celle qui compte le plus de déclencheurs. C’est celle qui envoie moins d’alertes, mais des alertes plus pertinentes.

Quelle place dans une installation Home Assistant existante

La connexion de la caméra passe en premier : caméra → ONVIF / RTSP → Home Assistant. Une fois la caméra intégrée et ses entités fiables, HomeClaw est le successeur actuel de LinknLink pour le rôle de passerelle locale Home Assistant, avec en plus une IA locale et des capacités d’AI Agent pour les automatisations. Il ne propose ni découverte ONVIF ni conversion RTSP ; ces fonctions restent assurées par la caméra et son intégration à Home Assistant.

Procédez au dépannage dans cet ordre : vérifiez d’abord la caméra et le flux vidéo, puis ajoutez des capteurs de présence ou des appareils IR/RF uniquement s’ils contribuent à l’automatisation globale de la pièce.

Lorsque les événements des caméras s’intègrent à une logique plus globale de la pièce, utilisez cette liste de vérification avec Automatisations d’économies d’énergie avec Home Assistant pour les règles de climatisation et d’éclairage, et utilisez le Guide des capteurs de présence mmWave lorsque la détection de mouvement par caméra doit être complétée par un capteur dédié à la détection de présence dans la pièce.

Diagnostiquer les problèmes de caméra par couche

Le fonctionnement d’une caméra dans Home Assistant comporte plusieurs points de contrôle distincts. Considérez l’entité caméra de Home Assistant comme une couche de diagnostic à part entière entre le flux RTSP et le tableau de bord : caméra/appareil → découverte ONVIF → flux RTSP → entité caméra dans Home Assistant → tableau de bord/interface utilisateur.

Suivez cette procédure pour identifier la couche défaillante avant de modifier d’autres paramètres. Un appareil détecté ne fournit pas nécessairement un flux exploitable, et un flux fonctionnel ne garantit pas que l’entité caméra correspondante dans Home Assistant fonctionne correctement.

Ordre de dépannage tenant compte des entités

Caméra / réseau : vérifiez l’alimentation, l’adresse, l’accessibilité sur le réseau local et les identifiants.
Découverte ONVIF : vérifiez que Home Assistant peut identifier l’appareil et rendre disponibles les services attendus.
Flux RTSP : vérifiez précisément le profil du flux, les identifiants, le protocole de transport et la compatibilité.
Entité caméra Home Assistant : vérifiez la disponibilité, les attributs et si l’entité fournit un flux vidéo en direct exploitable.
Tableau de bord / interface utilisateur : Vérifiez l’entité sélectionnée, le type de carte et le mode d’affichage uniquement après vous être assuré que les couches inférieures fonctionnent.

Symptôme → Identification de la couche probablement en cause

Symptôme	Couche probable	À vérifier en premier
La caméra n’est pas détectée	Détection des caméras, du réseau ou via ONVIF	Adresse, accessibilité, identifiants, prise en charge de l’intégration et disponibilité du service ONVIF.
La caméra est détectée, mais aucune vidéo ne s’affiche	Flux RTSP	Profil de flux exact, URL, identifiants, chemin réseau local et compatibilité des codecs.
RTSP fonctionne en externe, mais l’entité caméra de Home Assistant ne fonctionne pas	Entité caméra Home Assistant	Disponibilité des entités, attributs, correspondance des intégrations et flux mis à disposition de Home Assistant.
L’entité caméra existe, mais l’affichage sur le tableau de bord est incorrect	Tableau de bord/interface utilisateur	Entité sélectionnée, type de carte, mode d’affichage et état d’erreur de l’interface.
La capture d’image fonctionne, mais pas le flux vidéo en direct	Flux RTSP ou entité caméra	Profil du flux en direct, protocole de transport, identifiants et indication précisant si l’entité fournit un flux en direct exploitable.

Liste de vérification pour un diagnostic étape par étape

Vérifiez que la caméra et la passerelle Home Assistant se trouvent sur des réseaux locaux accessibles.
Réservez une adresse IP fixe pour la caméra dans le routeur.
Activez ONVIF et RTSP dans l’interface web de la caméra.
Testez le flux RTSP dans un lecteur local avant de modifier la configuration de Home Assistant.
Ajoutez l’intégration native si elle propose des entités mieux adaptées à votre modèle de caméra.
Ajoutez ONVIF comme solution de repli standard et comparez le comportement des événements.
Créez une automatisation simple, puis ajoutez progressivement des capteurs et des commandes pour vos appareils.

Questions fréquentes

Pourquoi ma caméra ONVIF est-elle détectée, mais ne diffuse-t-elle pas de vidéo dans Home Assistant ?

La détection prouve uniquement que Home Assistant peut voir la caméra. La diffusion vidéo dépend toujours des identifiants RTSP, des paramètres du flux vidéo de la caméra, de son accessibilité sur le réseau et de la disponibilité d’un profil compatible sur la caméra.

Reolink fonctionne-t-il mieux via ONVIF ou avec son intégration native ?

Utilisez l’intégration native Reolink lorsqu’elle fournit les entités dont vous avez besoin. Utilisez ONVIF ou RTSP comme solution de repli si vous souhaitez un accès local plus standard à votre caméra ou si vous devez diagnostiquer le comportement du flux vidéo.

HomeClaw peut-il exécuter un scénario de caméra en local avec Home Assistant ?

Oui. HomeClaw est le successeur actuel de LinknLink pour le rôle de passerelle locale Home Assistant et peut ajouter une assistance locale par IA ou AI Agent une fois la caméra correctement intégrée. La découverte ONVIF, la diffusion RTSP, les identifiants et la compatibilité de la caméra doivent toutefois être vérifiés séparément.

Pourquoi les événements de détection de mouvement ONVIF ne déclenchent-ils pas les automatisations ?

Certaines caméras désactivent les événements ONVIF par défaut, ne rendent la détection de mouvement accessible que via l’API du fabricant ou nécessitent une configuration distincte des événements. Vérifiez l’interface web de la caméra avant de recréer vos automatisations Home Assistant.

Les automatisations des caméras devraient-elles dépendre du cloud ?

Non. Les automatisations de sécurité et de détection de présence doivent, dans la mesure du possible, fonctionner sur le réseau local. Des notifications via le cloud peuvent ensuite être ajoutées en option.

Conclusion

Le dépannage ONVIF dans Home Assistant devient plus simple lorsque vous cessez de considérer la caméra comme une boîte noire. Vérifiez le réseau, distinguez ONVIF de RTSP, choisissez la méthode d’intégration adaptée à Reolink et privilégiez, lorsque c’est possible, l’exécution locale des automatisations liées aux caméras.

Pour une nouvelle installation domotique locale, confiez l’intégration des caméras à Home Assistant ; ajoutez des capteurs, des tableaux de bord et des dispositifs de commande à distance uniquement une fois le fonctionnement des caméras stabilisé.