Home Assistant Guida alla configurazione dell'integrazione ONVIF

 

Aggiungere una telecamera IP a Home Assistant sembra semplice, finché non scopri che ogni marca di telecamere parla il proprio dialetto. L'integrazione ONVIF è l'unico standard che elimina il rumore: una singola integrazione Home Assistant che funziona con i cloni Reolink, Amcrest, Dahua, Hikvision e la maggior parte delle telecamere IP "compatibili ONVIF" vendute dal 2018. Questa guida ti guida attraverso la configurazione completa, le trappole che nessuno menziona nei thread del forum e il modo più economico per eseguirlo: un LinknLink iSG Box SE con Home Assistant preinstallato per $ 69,90.

LinknLink iSG Box SE Gateway Home Assistant per l'automazione di telecamere ONVIF locali

1. Cos'è ONVIF e perché gli utenti Home Assistant ne hanno bisogno

ONVIF (Open Network Video Interface Forum) è uno standard aperto che definisce il modo in cui telecamere IP, NVR e client video comunicano tra loro su una rete locale. Invece di aver bisogno di un'app diversa per ogni marca di fotocamera, qualsiasi dispositivo compatibile con ONVIF può scoprire, trasmettere in streaming e ricevere eventi da qualsiasi altro dispositivo compatibile con ONVIF.

Per gli utenti Home Assistant, questo è importante per tre motivi:

  • Privacy e controllo locale. ONVIF funziona interamente sulla tua LAN. Nessun video esce di casa, non è richiesto alcun account, nessun produttore di fotocamere può disattivare il tuo feed con un aggiornamento del firmware. Questo è l'esatto opposto del modello Wyze, Ring o Arlo.
  • Latenza. Il feed di una telecamera basato su cloud in genere impiega 300-1200 ms attraverso un server del fornitore prima di raggiungere Home Assistant. ONVIF sulla rete locale è solitamente inferiore a 150 ms: abbastanza veloce da attivare le automazioni Home Assistant (luci, HVAC, sirene) prima che la persona che entra nell'inquadratura abbia finito di fare due passi.
  • Nessun vincolo al fornitore. Se il marchio della tua fotocamera cessa l'attività o passa a un modello di abbonamento, il tuo sistema continua a funzionare. ONVIF è una specifica aperta in stile W3C con migliaia di dispositivi compatibili.

Se stai ancora decidendo se vale la pena acquistare un hub dedicato, tratteremo i fondamenti Che cos'è un hub di casa intelligente. Per ONVIF in particolare, un hub con sufficiente margine di CPU per gestire più flussi RTSP non è negoziabile, motivo per cui la scelta dell'hardware nella sezione successiva è importante.

Marche di fotocamere che funzionano bene con ONVIF + Home Assistant:

  • Reolink (serie RLC, E1, Duo): eccellente esposizione del profilo ONVIF, flusso principale + secondario pronto all'uso
  • Amcrest (serie IP4M, IP5M) — Dahua OEM, eventi ONVIF molto solidi
  • Dahua (serie IPC-HFW, IPC-HDW) — ONVIF nativo, eventi di movimento solidissimi
  • Hikvision e rebranding (Annke, LTS, LaView): ONVIF funziona ma abilitalo prima nell'interfaccia utente web della fotocamera
  • Ubiquiti UniFi Protect G3/G4/G5: ONVIF solo tramite esportazione Protect, la maggior parte degli utenti salta questo percorso
  • Axis, Bosch, Vivotek: eccellente supporto ONVIF di livello aziendale

Marche di fotocamere da evitare per ONVIF: Wyze, Blink, Arlo, Ring, Google Nest. Si tratta di prodotti cloud-first; la loro esposizione ONVIF è inesistente o instabile dopo gli aggiornamenti del firmware.

Home Assistant Interfaccia di configurazione della telecamera locale ONVIF e RTSP

Il miglior gateway locale per l'automazione delle telecamere

Prima di toccare la schermata di integrazione ONVIF, assicurati di aver allineato queste quattro cose:

2.1 Un host Home Assistant sufficientemente potente per i flussi RTSP

Il sistema operativo Home Assistant in esecuzione su un Raspberry Pi 4 (4 GB) funziona tecnicamente per 1-2 fotocamere, ma qualsiasi cosa di più - o nel momento in cui aggiungi Frigate per il rilevamento AI - e il Pi inizia a perdere fotogrammi e a surriscaldarsi.

Consigliamo il LinknLink iSG Box SE per questa configurazione. A $ 69,90 è l'host Home Assistant più economico sul mercato con HA preinstallato e ha una potenza di calcolo significativamente maggiore di un Pi 4: spazio sufficiente per 8+ telecamere ONVIF in HA nativo o 2-4 telecamere con NVR Frigate sulla stessa scatola. Il confronto hardware completo è nel nostro Guida all'hardware Home Assistant.

Perché iSG Box SE è l'impostazione predefinita corretta per una build ONVIF:

  • Home Assistant preinstallato — collega l'alimentazione e la rete Ethernet, apri il browser, completa la procedura guidata di configurazione. Nessuna imaging della scheda SD, nessun Proxmox, nessuna attesa della catena di fornitura gialla Home Assistant.
  • Architettura innanzitutto locale — Controllo locale al 100%, nessun account cloud, nessun canone mensile.
  • CPU sufficiente per Fregata — il bonus §5 sul rilevamento degli oggetti tramite intelligenza artificiale funziona senza aggiungere un acceleratore USB Coral per una configurazione da 2 a 4 telecamere.
  • Prezzo - $ 69,90 contro Home Assistant Green a $ 158,90 o un kit Raspberry Pi 5 che arriva sopra $ 120 una volta aggiunti un SSD e una custodia.

2.2 Una telecamera IP compatibile ONVIF sulla stessa LAN

Controlla la scheda tecnica della fotocamera o l'interfaccia utente di amministrazione per l'interruttore "ONVIF". La maggior parte delle telecamere dei marchi al §1 vengono fornite con ONVIF abilitato ma senza password: aggiungerai le credenziali al §3.

2.3 Una prenotazione IP statica nel router

Home Assistant integra le telecamere tramite indirizzo IP. Se il router trasmette alla telecamera un nuovo IP la prossima settimana, l'integrazione si interrompe silenziosamente. Nelle impostazioni DHCP del router, riserva un IP LAN permanente per l'indirizzo MAC di ciascuna telecamera (in genere mostrato nell'interfaccia utente di amministrazione della telecamera).

2.4 Credenziali di amministratore della telecamera

Non sono le impostazioni predefinite di fabbrica: modificale prima. Le credenziali ONVIF vengono inviate sulla LAN in autenticazione digest per impostazione predefinita e le password predefinite in fabbrica sono ancora la superficie più scansionata in qualsiasi rete domestica.

Configurazione della telecamera RTSP locale

Con l'hardware pronto, l'effettiva integrazione richiede meno di dieci minuti. Ecco i cinque passaggi esatti.

Passaggio 1: abilitare ONVIF nell'interfaccia utente web della telecamera

Apri l'IP della telecamera nel tuo browser (ad es. http://192.168.1.50), accedi con le credenziali di amministratore e trova la sezione ONVIF. Percorsi per marchio:

  • Ricollegamento: Impostazioni dispositivo → Rete → Avanzate → Impostazioni porta → seleziona "ONVIF"
  • Amcrest/Dahua: Configurazione → Rete → Connessione → ONVIF → Autenticazione = "Digest" o "Nessuno"
  • Hikvision: Configurazione → Rete → Impostazioni avanzate → Protocollo di integrazione → abilita ONVIF e crea un utente ONVIF dedicato

Hikvision è l'unico marchio fornito con ONVIF disabilitato per impostazione predefinita e richiede un account utente ONVIF separato: configuralo prima di continuare.

Passaggio 2: prendi nota degli URL dello streaming RTSP (facoltativo ma utile)

Mentre sei nell'interfaccia utente web, copia gli URL RTSP dello stream principale e secondario. L'integrazione ONVIF di Home Assistant li rileva automaticamente, ma averli a portata di mano rende il debug molto più veloce se il rilevamento fallisce. Formati tipici:

  • Reolink principale: rtsp://admin:password@192.168.1.50:554/h264Preview_01_main
  • Reolink sottotitolo: rtsp://admin:password@192.168.1.50:554/h264Preview_01_sub
  • Amcrest principale: rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0
  • Sottomarino Amcrest: rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1

Passaggio 3: apri Home Assistant e aggiungi l'integrazione ONVIF

Nell'interfaccia utente di Home Assistant (sia in esecuzione su iSG Box SE che altrove):

  1. Vai a Impostazioni → Dispositivi e servizi
  2. Fare clic + Aggiungi integrazione (in basso a destra)
  3. Cerca "ONVIF" e selezionarlo

Home Assistant eseguirà la scansione della rete locale tramite WS-Discovery. La maggior parte delle fotocamere viene visualizzata automaticamente. Se il tuo non lo fa, puoi aggiungerlo manualmente tramite IP.

Passaggio 4: inserisci IP, porta e credenziali

La porta ONVIF predefinita è 80 (HTTP) sulla maggior parte delle fotocamere, non 554 (ovvero RTSP, una porta diversa). Se la tua telecamera utilizza una porta ONVIF non standard (2020, 8000, 8899 sono comuni), verrà elencata nell'interfaccia utente web della telecamera nella sezione Rete o ONVIF.

Inserisci:

  • Ospite: l'IP LAN statico della telecamera
  • Porto: solitamente 80; Hikvision utilizza spesso 80, Dahua 80, Reolink 8000
  • Nome utente/Password: le credenziali ONVIF impostate al §2.4 (Hikvision: l'utente ONVIF dedicato creato allo Step 1)

Passaggio 5: scegli i profili (principale + flusso secondario)

Home Assistant esporrà ogni "profilo" ONVIF pubblicizzato dalla telecamera, in genere uno per il flusso principale (ad alta risoluzione) e uno per il flusso secondario (a bassa risoluzione). Abilita entrambi:

  • Flusso principale — utilizzato per registrazioni, istantanee e visualizzazioni di alta qualità
  • Sottoflusso — utilizzato per il riquadro del dashboard Home Assistant Lovelace (quindi il dashboard si carica velocemente anche sui dispositivi mobili)

Fare clic Invia. La fotocamera ora viene visualizzata sotto Dispositivi e servizi con entità per il feed live, sensore di movimento e (se la telecamera lo supporta) sensori binari per qualsiasi evento attivato dalla telecamera: attraversamento della linea, rilevamento di intrusioni, classificazione di persone/veicoli, manomissione.

Ricollegare la risoluzione dei problemi ONVIF

Questi sono i quattro problemi che generano il 90% dei thread del forum su Home Assistant ONVIF. Ecco come risolverli in meno di due minuti.

4.1 "Telecamera non rilevata" durante l'aggiunta dell'integrazione

WS-Discovery utilizza DNS multicast (mDNS). Se l'host Home Assistant e la videocamera si trovano su VLAN diverse o SSID WiFi diversi, i pacchetti mDNS non oltrepassano il confine. Correzioni, in ordine di impegno:

  • Posiziona temporaneamente la telecamera sulla stessa sottorete di Home Assistant per il rilevamento, quindi spostala indietro.
  • Aggiungere manualmente la telecamera tramite IP durante la configurazione dell'integrazione (WS-Discovery è una comodità, non un requisito).
  • Abilita la riflessione mDNS/Avahi sul tuo router (UniFi: "Multicast DNS", pfSense: pacchetto "Avahi", OpenWrt: "umdns"). Questa è la soluzione permanente.

4.2 Lo streaming live continua a essere bufferizzato o mostra "Stream non disponibile"

Lo streaming principale a 4K o 1440p + 30 fps è spesso troppo per la dashboard di Lovelace, soprattutto su mobile. Passa il riquadro del dashboard al flusso secondario:

  • Impostazioni → Dispositivi e servizi → Integrazione ONVIF → Configura → deseleziona "Profilo principale" per la Picture Entity Card
  • Oppure direttamente nella scheda della fotocamera YAML: set stream_source all'entità del profilo secondario

Frigate NVR (trattato nel §5) è una soluzione più pulita in questo caso: ricodifica il flusso una volta e fornisce HLS/WebRTC a bassa latenza a tutti i client.

4.3 Le entità di rilevamento del movimento non attivano eventi in Home Assistant

Gli eventi di movimento ONVIF sono facoltativi nelle specifiche: la telecamera deve (a) avere il rilevamento del movimento abilitato localmente e (b) essere configurata per pubblicare eventi ONVIF. Passaggi:

  1. Nell'interfaccia utente web della fotocamera, abilitare il rilevamento del movimento (di solito Evento → Rilevamento movimento → Abilita)
  2. Trova le impostazioni ONVIF o "eventi intelligenti" e abilita "Eventi ONVIF" o "Eventi push"
  3. In Home Assistant, riavvia l'integrazione ONVIF: Impostazioni → Dispositivi e servizi → ONVIF → menu a tre punti → Ricarica

Se utilizzi una fotocamera Hikvision o Hikvision-OEM e gli eventi continuano a non attivarsi, controlla che l'utente ONVIF creato nel §3 Passaggio 1 disponga delle autorizzazioni "Evento" e "Media": per impostazione predefinita l'utente ONVIF è di sola lettura per Utente gestione, il che è corretto, ma alcune versioni firmware limitano anche la sottoscrizione degli eventi.

4.4 La fotocamera funziona per un giorno, quindi va offline fino al riavvio

Si tratta quasi sempre di una scadenza del lease DHCP (nessuna prenotazione statica) o di un timeout keep-alive RTSP. Confermare che la prenotazione dell'IP statico di cui al §2.3 sia applicata al router, non solo nelle impostazioni di rete della fotocamera. Alcune fotocamere rispettano entrambi; alcuni ignorano il proprio IP statico e prendono qualunque cosa assegni il router.

5. Bonus: aggiunta dell'NVR della fregata per il rilevamento di oggetti AI

Il movimento ONVIF Home Assistant nativo è binario: "qualcosa si è mosso" o "niente si è mosso". Ciò innesca molti falsi positivi dovuti alle foglie che cadono sul prato o alle ombre al tramonto.

Fregata è un NVR open source gratuito che funziona come componente aggiuntivo Home Assistant e rileva oggetti AI locali sul feed della telecamera, quindi invece di "movimento", le tue automazioni si attivano su "persona", "auto", "pacchetto" o "cane". Tutto funziona sul tuo host Home Assistant; nessun frame lascia la LAN.

Perché iSG Box SE è abbastanza potente da ospitare Frigate:

  • Il rilevatore CPU predefinito di Frigate gestisce 2–4 telecamere a 5–7 fps ciascuna sull'iSG Box SE senza limitazione termica.
  • Se in seguito passi a 6-8 telecamere, aggiungi un acceleratore USB Google Coral da $ 60 e Frigate scarica l'inferenza sul TPU: iSG Box SE dispone di larghezza di banda USB libera per questo.
  • La configurazione richiede circa 15 minuti: installa il componente aggiuntivo Frigate dallo store dei componenti aggiuntivi Home Assistant, incolla gli URL ONVIF RTSP dal §3 Passaggio 2 in fregata.yaml, ricarica.

Abbinalo alle automazioni Home Assistant ("se Frigate rileva una persona alla porta d'ingresso tra le 22:00 e le 6:00, accendi la luce del portico e fai lampeggiare la lampada del soggiorno tre volte") e avrai un sistema di sicurezza intelligente che non costa nulla andare oltre la bolletta elettrica. Il iSG Box SE è il punto di partenza con l'attrito più basso esattamente per questo stack.

Domande frequenti sull'integrazione ONVIF di Home Assistant

Home Assistant può utilizzare le telecamere ONVIF senza accesso al cloud?

Sì. Home Assistant può connettersi a molte telecamere ONVIF sulla rete locale utilizzando l'indirizzo IP della telecamera, la porta ONVIF e le credenziali locali.

Perché una fotocamera Reolink necessita di impostazioni RTSP con ONVIF?

ONVIF gestisce il rilevamento e il controllo, mentre RTSP spesso trasporta il flusso video live. Se il video fallisce, conferma il percorso RTSP, il firmware e le autorizzazioni LAN.

Quale gateway LinknLink è il migliore per l'automazione della telecamera locale?

Utilizza iSG Box SE per un gateway Home Assistant compatto o iSG Display Max quando desideri anche uno schermo a parete per i controlli della fotocamera e della stanza.

7. Conclusione: inizia oggi stesso la tua configurazione ONVIF con iSG Box SE

L'integrazione ONVIF è il percorso più breve da "Ho una telecamera IP" a "le mie luci si accendono quando qualcuno cammina lungo il vialetto, il mio HVAC cambia quando il soggiorno è vuoto per 20 minuti e il mio telefono emette un segnale acustico quando Frigate vede un furgone per le consegne invece di un gatto randagio". E il modo più economico per arrivarci senza dover armeggiare con l'hardware per un fine settimana è a LinknLink iSG Box SE ($ 69,90) — Home Assistant preinstallato, locale al 100%, pronto per eseguire ONVIF e Frigate nel momento in cui apri la confezione.

Segui i cinque passaggi nel §3 e avrai la tua prima telecamera in streaming all'interno di Home Assistant in meno di dieci minuti. Aggiungi il livello Fregata §5 il prossimo fine settimana. Aggiungi il resto delle tue telecamere quando vuoi: l'integrazione ONVIF è scalabile fino a 8+ dispositivi senza alcuna ulteriore configurazione.

Ottieni l'iSG Box SE →