Installatiehandleiding voor Home Assistant ONVIF-integratie

 

Een IP-camera toevoegen aan de Home Assistant klinkt eenvoudig – totdat je ontdekt dat elk cameramerk zijn eigen dialect spreekt. De ONVIF-integratie is de enige standaard die de ruis doorbreekt: een enkele Home Assistant-integratie die werkt met Reolink, Amcrest, Dahua, Hikvision-klonen en de meeste "ONVIF-compatibele" IP-camera's die sinds 2018 zijn verkocht. Deze gids leidt u door de volledige installatie, de valkuilen die niemand noemt in forumthreads, en de goedkoopste manier om het uit te voeren: een LinknLink iSG Box SE met Home Assistant vooraf geïnstalleerd voor $ 69,90.

LinknLink iSG Box SE Home Assistant-gateway voor lokale ONVIF-cameraautomatisering

1. Wat is ONVIF en waarom Home Assistant-gebruikers het nodig hebben

ONVIF (Open Network Video Interface Forum) is een open standaard die definieert hoe IP-camera's, NVR's en videoclients met elkaar communiceren via een lokaal netwerk. In plaats van voor elk cameramerk een andere app nodig te hebben, kan elk ONVIF-compatibel apparaat gebeurtenissen van elk ander ONVIF-compatibel apparaat ontdekken, streamen en ontvangen.

Voor Home Assistant-gebruikers is dat om drie redenen belangrijk:

  • Privacy en lokale controle. ONVIF draait volledig op uw LAN. Geen video verlaat je huis, er is geen account nodig, geen enkele camerafabrikant kan je feed afsluiten met een firmware-update. Dit is precies het tegenovergestelde van het Wyze-, Ring- of Arlo-model.
  • Latentie. Een cloudgebaseerde camerafeed gaat doorgaans 300–1200 ms door een server van een leverancier voordat hij Home Assistant bereikt. ONVIF via het lokale netwerk is doorgaans minder dan 150 ms – snel genoeg om Home Assistant-automatiseringen (lichten, HVAC, sirenes) te activeren voordat de persoon die het frame binnenloopt, klaar is met het nemen van twee stappen.
  • Geen leverancierslock-in. Als uw cameramerk failliet gaat of overstapt op een abonnementsmodel, blijft uw systeem werken. ONVIF is een open specificatie in W3C-stijl met duizenden compatibele apparaten.

Als u nog steeds besluit of een speciale hub de moeite waard is, bespreken we de basisprincipes in Wat is een Smart Home Hub. Specifiek voor ONVIF is een hub met voldoende CPU-ruimte om meerdere RTSP-streams te verwerken niet onderhandelbaar. Daarom is de hardwarekeuze in het volgende gedeelte van belang.

Cameramerken die goed samenwerken met ONVIF + Home Assistant:

  • Reolink (RLC, E1, Duo-serie) - uitstekende ONVIF-profielbelichting, standaard hoofd- en substream
  • Amcrest (IP4M-, IP5M-serie) — Dahua OEM, zeer solide ONVIF-evenementen
  • Dahua (IPC-HFW, IPC-HDW-serie) — native ONVIF, uiterst solide bewegingsgebeurtenissen
  • Hikvision en rebrands (Annke, LTS, LaView) - ONVIF werkt, maar schakel het eerst in de webinterface van de camera in
  • Ubiquiti UniFi Protect G3/G4/G5 — ONVIF alleen via Protect-export, de meeste gebruikers slaan dit pad over
  • Axis, Bosch, Vivotek – uitstekende ONVIF-ondersteuning op ondernemingsniveau

Cameramerken die u moet vermijden voor ONVIF: Wyze, Blink, Arlo, Ring, Google Nest. Dit zijn cloud-first-producten; hun ONVIF-blootstelling is niet aanwezig of onstabiel na firmware-updates.

Home Assistant ONVIF en RTSP lokale camera-installatie-interface

Beste lokale gateway voor camera-automatisering

Voordat u het ONVIF-integratiescherm aanraakt, moet u ervoor zorgen dat u deze vier zaken op een rij heeft:

2.1 Een Home Assistant-host die krachtig genoeg is voor RTSP-streams

Home Assistant OS draait op een Raspberry Pi 4 (4 GB) werkt technisch gezien voor 1 à 2 camera's, maar als je meer doet (of op het moment dat je Frigate toevoegt voor AI-detectie) begint de Pi frames te laten vallen en oververhit te raken.

Wij raden de LinknLink iSG Box SE voor deze opstelling. Met een prijs van $ 69,90 is het de goedkoopste Home Assistant-host op de markt met vooraf geïnstalleerde HA, en hij heeft aanzienlijk meer rekenkracht dan een Pi 4 - genoeg speelruimte voor meer dan 8 ONVIF-camera's in native HA, of 2 à 4 camera's met Frigate NVR op dezelfde box. Volledige hardwarevergelijking vindt u in onze Home Assistant hardwarehandleiding.

Waarom iSG Box SE de juiste standaard is voor een ONVIF-build:

  • Home Assistant vooraf geïnstalleerd — sluit de stroom en Ethernet aan, open uw browser en voltooi de installatiewizard. Geen SD-kaartbeeldvorming, geen Proxmox, geen Home Assistant Gele supply chain-wachttijd.
  • Lokaal-eerste architectuur — 100% lokale controle, geen cloudaccount, geen maandelijkse kosten.
  • Genoeg CPU voor fregat — de §5-bonus voor AI-objectdetectie werkt zonder toevoeging van een Coral USB-versneller voor een opstelling met 2-4 camera's.
  • Prijs – $ 69,90 versus Home Assistant Green voor $ 158,90 of een Raspberry Pi 5-kit die boven de $ 120 uitkomt zodra je een SSD en behuizing toevoegt.

2.2 Een ONVIF-compatibele IP-camera op hetzelfde LAN

Controleer het specificatieblad van de camera of de beheerdersinterface voor de schakelaar "ONVIF". De meeste camera's van de merken in §1 worden geleverd met ONVIF ingeschakeld maar zonder wachtwoord. U voegt inloggegevens toe in §3.

2.3 Een statische IP-reservering in uw router

Home Assistant integreert camera's op basis van IP-adres. Als je router de camera volgende week een nieuw IP-adres geeft, wordt de integratie geruisloos verbroken. Reserveer in de DHCP-instellingen van uw router een permanent LAN IP voor het MAC-adres van elke camera (meestal weergegeven in de beheerdersinterface van de camera).

2.4 Camerabeheerdersreferenties

Niet de fabrieksstandaard: verander ze eerst. ONVIF-inloggegevens worden standaard via het LAN verzonden in digest-authenticatie, en standaardwachtwoorden zijn nog steeds het meest gescande oppervlak in elk thuisnetwerk.

Lokale RTSP-camera-instelling

Als de hardware klaar is, duurt de daadwerkelijke integratie minder dan tien minuten. Hier zijn de exacte vijf stappen.

Stap 1 — Schakel ONVIF in de webinterface van de camera in

Open het IP-adres van de camera in uw browser (bijv. http://192.168.1.50), log in met beheerdersreferenties en zoek de ONVIF-sectie. Paden per merk:

  • Reolink: Apparaatinstellingen → Netwerk → Geavanceerd → Poortinstellingen → vink "ONVIF" aan
  • Amcrest/Dahua: Instellingen → Netwerk → Verbinding → ONVIF → Authenticatie = "Digest" of "Geen"
  • Hikvisie: Configuratie → Netwerk → Geavanceerde instellingen → Integratieprotocol → schakel ONVIF in en maak een speciale ONVIF-gebruiker

Hikvision is het enige merk dat wordt geleverd met ONVIF standaard uitgeschakeld en vereist een afzonderlijk ONVIF-gebruikersaccount - stel dat in voordat u verdergaat.

Stap 2 — Noteer de RTSP-stream-URL's (optioneel maar nuttig)

Terwijl u zich in de webinterface bevindt, kopieert u de RTSP-URL's van de hoofd- en substream. De ONVIF-integratie van Home Assistant ontdekt deze automatisch, maar door ze bij de hand te hebben, wordt het debuggen veel sneller als de ontdekking mislukt. Typische formaten:

  • Reolink-hoofd: rtsp://admin:wachtwoord@192.168.1.50:554/h264Preview_01_main
  • Reolink-sub: rtsp://admin:wachtwoord@192.168.1.50:554/h264Preview_01_sub
  • Amcrest-hoofdgerecht: rtsp://admin:wachtwoord@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0
  • Amcrest-sub: rtsp://admin:wachtwoord@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1

Stap 3 — Open Home Assistant en voeg de ONVIF-integratie toe

In de Home Assistant-gebruikersinterface (of deze nu op iSG Box SE of elders draait):

  1. Ga naar Instellingen → Apparaten en services
  2. Klik + Integratie toevoegen (rechtsonder)
  3. Zoek naar "ONVIF" en selecteer het

Home Assistant scant het lokale netwerk via WS-Discovery. De meeste camera's verschijnen automatisch. Als de jouwe dat niet doet, kun je deze handmatig toevoegen via IP.

Stap 4 — Voer IP, poort en inloggegevens in

De standaard ONVIF-poort is 80 (HTTP) op de meeste camera's, niet 554 (dat is RTSP - een andere poort). Als uw camera een niet-standaard ONVIF-poort gebruikt (2020, 8000, 8899 zijn gebruikelijk), wordt deze vermeld in de webinterface van de camera onder het gedeelte Netwerk of ONVIF.

Voer in:

  • Gastheer: het statische LAN IP-adres van de camera
  • Haven: meestal 80; Hikvision gebruikt vaak 80, Dahua 80, Reolink 8000
  • Gebruikersnaam/wachtwoord: de ONVIF-gegevens die u in §2.4 hebt ingesteld (Hikvision: de speciale ONVIF-gebruiker die in stap 1 is aangemaakt)

Stap 5 — Kies de profielen (hoofd- en substream)

Home Assistant zal elk ONVIF-"profiel" weergeven waarvoor de camera adverteert - meestal één voor de hoofdstream (hoge resolutie) en één voor de substream (lage resolutie). Schakel beide in:

  • Hoofdstroom — gebruikt voor opnames, snapshots en weergave van hoge kwaliteit
  • Substroom — gebruikt voor de Home Assistant Lovelace-dashboardtegel (zodat het dashboard snel laadt, zelfs op mobiel)

Klik Verzenden. De camera verschijnt nu onder Apparaten en diensten met entiteiten voor de livefeed, bewegingssensor en (als de camera dit ondersteunt) binaire sensoren voor elke gebeurtenis waarbij de camera vuurt: lijnoverschrijding, inbraakdetectie, classificatie van mens/voertuig, manipulatie.

Reolink ONVIF-probleemoplossing

Dit zijn de vier problemen die 90% van de forumthreads over Home Assistant ONVIF genereren. Hier leest u hoe u elk probleem in minder dan twee minuten kunt oplossen.

4.1 "Camera niet ontdekt" tijdens het toevoegen van integratie

WS-Discovery maakt gebruik van multicast DNS (mDNS). Als uw Home Assistant-host en uw camera zich op verschillende VLAN's of verschillende WiFi-SSID's bevinden, overschrijden mDNS-pakketten de grens niet. Oplossingen, in volgorde van inspanning:

  • Zet de camera tijdelijk op hetzelfde subnet als Home Assistant voor detectie en verplaats hem vervolgens terug.
  • Voeg de camera handmatig toe via IP tijdens het instellen van de integratie (WS-Discovery is een gemak, geen vereiste).
  • Schakel mDNS-reflectie / Avahi in op uw router (UniFi: "Multicast DNS", pfSense: "Avahi" -pakket, OpenWrt: "umdns"). Dit is de permanente oplossing.

4.2 Livestream blijft bufferen of toont "Stream niet beschikbaar"

De hoofdstream op 4K of 1440p + 30 fps is vaak te veel voor het Lovelace-dashboard, vooral op mobiel. Schakel de dashboardtegel naar de substream:

  • Instellingen → Apparaten en services → ONVIF-integratie → Configureren → schakel 'Hoofdprofiel' uit voor de Picture Entity Card
  • Of rechtstreeks in de camerakaart YAML: set stream_bron naar de subprofielentiteit

Frigate NVR (besproken in §5) is hier een schonere oplossing: het codeert de stream één keer opnieuw en levert HLS/WebRTC met lage latentie aan alle clients.

4.3 Bewegingsdetectie-entiteiten activeren geen gebeurtenissen in Home Assistant

ONVIF-bewegingsgebeurtenissen zijn optioneel in de specificatie: de camera moet (a) bewegingsdetectie lokaal hebben ingeschakeld en (b) zijn geconfigureerd om ONVIF-gebeurtenissen te publiceren. Stappen:

  1. Schakel in de webinterface van de camera bewegingsdetectie in (meestal Gebeurtenis → Bewegingsdetectie → Inschakelen)
  2. Zoek de ONVIF- of 'smart event'-instellingen en schakel 'ONVIF Events' of 'Push Events' in
  3. Start in Home Assistant de ONVIF-integratie opnieuw: Instellingen → Apparaten en services → ONVIF → menu met drie stippen → Opnieuw laden

Als u een Hikvision- of Hikvision-OEM-camera gebruikt en gebeurtenissen nog steeds niet worden geactiveerd, controleer dan of de ONVIF-gebruiker die u in §3 Stap 1 heeft aangemaakt de machtigingen "Evenement" en "Media" heeft - standaard is de ONVIF-gebruiker alleen-lezen voor Gebruiker beheer, wat correct is, maar sommige firmwareversies beperken ook het abonnement op evenementen.

4.4 Camera werkt een dag, gaat daarna offline tot opnieuw opstarten

Dit is vrijwel altijd het verlopen van een DHCP-lease (geen statische reservering) of een RTSP keep-alive time-out. Bevestig dat de statische IP-reservering uit §2.3 wordt toegepast op de router, niet alleen in de eigen netwerkinstellingen van de camera. Sommige camera's respecteren beide; sommigen negeren hun eigen statische IP-adres en nemen alles wat de router toewijst.

5. Bonus: toevoeging van fregat-NVR voor AI-objectdetectie

Native Home Assistant ONVIF-beweging is binair: "iets bewoog" of "niets bewoog." Dat veroorzaakt veel valse positieven, bijvoorbeeld door bladeren die over het gazon waaien of schaduwen bij zonsondergang.

Fregat is een gratis, open-source NVR die draait als een Home Assistant-add-on en lokale AI-objectdetectie uitvoert op de camerafeed - dus in plaats van 'beweging' schieten uw automatiseringen op 'persoon', 'auto', 'pakket' of 'hond'. Alles draait op uw Home Assistant-host; er verlaten geen frames het LAN.

Waarom iSG Box SE krachtig genoeg is om fregat te hosten:

  • De standaard CPU-detector van het fregat verwerkt 2 tot 4 camera's met elk 5 tot 7 fps op de iSG Box SE zonder thermische beperking.
  • Als je later opschaalt naar 6-8 camera's, voeg dan een Google Coral USB-accelerator van $ 60 toe en Frigate ontlast de gevolgtrekking naar de TPU - iSG Box SE heeft hiervoor vrije USB-bandbreedte.
  • De installatie duurt ongeveer 15 minuten: installeer de Frigate-add-on uit de Home Assistant-add-onwinkel, plak uw ONVIF RTSP-URL's uit §3 Stap 2 in fregat.yaml, herladen.

Combineer dat met Home Assistant-automatiseringen ("als Frigate tussen 22.00 uur en 06.00 uur een persoon bij de voordeur detecteert, doe dan de verandaverlichting aan en laat de lamp in de woonkamer drie keer knipperen") en je hebt een slim beveiligingssysteem dat niets kost om verder te gaan dan de elektriciteitsrekening. De iSG Box SE is het startpunt met de laagste wrijving voor precies deze stapel.

Veelgestelde vragen over Home Assistant ONVIF-integratie

Kan Home Assistant ONVIF-camera's gebruiken zonder cloudtoegang?

Ja. De Home Assistant kan verbinding maken met veel ONVIF-camera's op het lokale netwerk met behulp van het IP-adres van de camera, de ONVIF-poort en lokale inloggegevens.

Waarom heeft een Reolink-camera RTSP-instellingen nodig met ONVIF?

ONVIF verzorgt de detectie en controle, terwijl RTSP vaak de live videostream verzorgt. Als de video mislukt, bevestig dan het RTSP-pad, de firmware en de LAN-machtigingen.

Welke LinknLink-gateway is het beste voor lokale camera-automatisering?

Gebruik iSG Box SE voor een compacte Home Assistant-gateway, of iSG Display Max als je ook een scherm aan de muur wilt voor camera- en kamerbediening.

7. Conclusie: Start vandaag nog uw ONVIF-installatie met iSG Box SE

De ONVIF-integratie is de kortste weg van 'Ik heb een IP-camera' naar 'mijn lichten gaan aan als iemand de oprit oploopt, mijn HVAC verandert als de woonkamer 20 minuten leeg is, en mijn telefoon pingt me als Frigate een bestelbusje ziet in plaats van een zwerfkat.' En de goedkoopste manier om daar te komen zonder een weekend lang aan de hardware te sleutelen is een LinknLink iSG Box SE ($69,90) — Home Assistant vooraf geïnstalleerd, 100% lokaal, klaar om ONVIF en Frigate uit te voeren zodra u de doos opent.

Volg de vijf stappen in §3 en binnen tien minuten kun je je eerste camera streamen in de Home Assistant. Volgend weekend de §5 Fregatlaag toevoegen. Voeg de rest van uw camera's toe wanneer u maar wilt: de ONVIF-integratie kan zonder verdere configuratie worden geschaald naar meer dan 8 apparaten.

Koop de iSG Box SE →