Adicionar uma câmera IP ao Home Assistant parece simples – até você aprender que cada marca de câmera fala seu próprio dialeto. A integração ONVIF é o único padrão que elimina o ruído: uma única integração Home Assistant que funciona com clones Reolink, Amcrest, Dahua, Hikvision e a maioria das câmeras IP "compatíveis com ONVIF" vendidas desde 2018. Este guia orienta você na configuração completa, as armadilhas que ninguém menciona nos tópicos do fórum e a maneira mais barata de executá-lo: um LinknLink iSG Box SE com Home Assistant pré-instalado para $ 69,90.
1. O que é ONVIF e por que os usuários do Home Assistant precisam dele
ONVIF (Open Network Video Interface Forum) é um padrão aberto que define como câmeras IP, NVRs e clientes de vídeo se comunicam entre si em uma rede local. Em vez de precisar de um aplicativo diferente para cada marca de câmera, qualquer dispositivo compatível com ONVIF pode descobrir, transmitir e receber eventos de qualquer outro dispositivo compatível com ONVIF.
Para usuários do Home Assistant, isso é importante por três motivos:
- Privacidade e controle local. ONVIF é executado inteiramente na sua LAN. Nenhum vídeo sai de sua casa, nenhuma conta é necessária, nenhum fabricante de câmera pode desligar seu feed com uma atualização de firmware. Este é exatamente o oposto do modelo Wyze, Ring ou Arlo.
- Latência. Um feed de câmera baseado em nuvem normalmente percorre 300–1200 ms através de um servidor de fornecedor antes de chegar a Home Assistant. O ONVIF na rede local geralmente é inferior a 150 ms – rápido o suficiente para acionar automações Home Assistant (luzes, HVAC, sirenes) antes que a pessoa que entra no quadro termine de dar dois passos.
- Sem dependência de fornecedor. Se a marca da sua câmera fechar ou mudar para um modelo de assinatura, seu sistema continuará funcionando. ONVIF é uma especificação aberta no estilo W3C com milhares de dispositivos compatíveis.
Se você ainda está decidindo se vale a pena ter um hub dedicado, abordamos os fundamentos em O que é um hub doméstico inteligente. Especificamente para ONVIF, um hub com espaço de CPU suficiente para lidar com vários fluxos RTSP não é negociável – e é por isso que a escolha do hardware na próxima seção é importante.
Marcas de câmeras que funcionam bem com ONVIF + Home Assistant:
- Reolink (série RLC, E1, Duo) — excelente exposição de perfil ONVIF, fluxo principal + secundário pronto para uso
- Amcrest (série IP4M, IP5M) — Dahua OEM, eventos ONVIF muito sólidos
- Dahua (série IPC-HFW, IPC-HDW) — ONVIF nativo, eventos de movimento sólidos
- Hikvision e reformulações de marca (Annke, LTS, LaView) — ONVIF funciona, mas habilite-o primeiro na interface da web da câmera
- Ubiquiti UniFi Protect G3/G4/G5 — ONVIF somente via exportação Protect, a maioria dos usuários pula este caminho
- Axis, Bosch, Vivotek — excelente suporte ONVIF de nível empresarial
Marcas de câmeras a serem evitadas para ONVIF: Wyze, Blink, Arlo, Ring, Google Nest. Estes são produtos que priorizam a nuvem; sua exposição ao ONVIF é inexistente ou instável após atualizações de firmware.
Melhor gateway local para automação de câmeras
Antes de tocar na tela de integração ONVIF, certifique-se de ter estas quatro coisas alinhadas:
2.1 Um host Home Assistant poderoso o suficiente para fluxos RTSP
O sistema operacional Home Assistant rodando em um Raspberry Pi 4 (4 GB) funciona tecnicamente para 1–2 câmeras, mas qualquer coisa mais – ou no momento em que você adiciona Frigate para detecção de IA – e o Pi começa a perder quadros e superaquecer.
Recomendamos o Caixa LinknLink iSG SE para esta configuração. Por US$ 69,90, é o host Home Assistant mais barato do mercado com HA pré-instalado e possui significativamente mais computação do que um Pi 4 – espaço suficiente para mais de 8 câmeras ONVIF em HA nativo ou 2 a 4 câmeras com Frigate NVR na mesma caixa. A comparação completa de hardware está em nosso Guia de hardware Home Assistant.
Por que o iSG Box SE é o padrão correto para uma compilação ONVIF:
- Home Assistant pré-instalado - conecte energia e Ethernet, abra seu navegador e conclua o assistente de configuração. Sem imagem de cartão SD, sem Proxmox, sem espera na cadeia de suprimentos do Home Assistant Yellow.
- Arquitetura local primeiro — Controle 100% local, sem conta na nuvem, sem mensalidade.
- CPU suficiente para fragata - o bônus §5 na detecção de objetos por IA funciona sem adicionar um acelerador Coral USB para uma configuração de 2 a 4 câmeras.
- Preço – $ 69,90 vs. Home Assistant Green por $ 158,90 ou um kit Raspberry Pi 5 que chega a mais de $ 120 quando você adiciona um SSD e um case.
2.2 Uma câmera IP compatível com ONVIF na mesma LAN
Verifique a folha de especificações da câmera ou a interface do administrador para ver se há a opção "ONVIF". A maioria das câmeras das marcas em §1 são fornecidas com ONVIF habilitado, mas sem senha – você adicionará credenciais em §3.
2.3 Uma reserva de IP estático no seu roteador
Home Assistant integra câmeras por endereço IP. Se o seu roteador entregar à câmera um novo IP na próxima semana, a integração será interrompida silenciosamente. Nas configurações de DHCP do seu roteador, reserve um IP de LAN permanente para o endereço MAC de cada câmera (normalmente mostrado na interface de administração da câmera).
2.4 Credenciais de administrador da câmera
Não é o padrão de fábrica – altere-os primeiro. As credenciais ONVIF são enviadas pela LAN em autenticação digest por padrão, e as senhas padrão de fábrica ainda são a superfície mais verificada em qualquer rede doméstica.
Configuração de câmera RTSP local
Com o hardware pronto, a integração real leva menos de dez minutos. Aqui estão as cinco etapas exatas.
Passo 1 — Habilite o ONVIF na interface web da câmera
Abra o IP da câmera no seu navegador (por exemplo, http://192.168.1.50), faça login com credenciais de administrador e encontre a seção ONVIF. Caminhos por marca:
- Vincular novamente: Configurações do dispositivo → Rede → Avançado → Configurações de porta → marque "ONVIF"
- Amcrest/Dahua: Configuração → Rede → Conexão → ONVIF → Autenticação = "Digest" ou "Nenhum"
- Hikvisão: Configuração → Rede → Configurações avançadas → Protocolo de integração → habilitar ONVIF e criar um usuário ONVIF dedicado
Hikvision é a única marca que vem com o ONVIF desativado por padrão e requer uma conta de usuário ONVIF separada – configure-a antes de continuar.
Passo 2 — Observe os URLs do stream RTSP (opcional, mas útil)
Enquanto estiver na IU da web, copie os URLs RTSP do stream principal e secundário. A integração ONVIF do Home Assistant os descobre automaticamente, mas tê-los à mão torna a depuração muito mais rápida se a descoberta falhar. Formatos típicos:
- Reolink principal:
rtsp://admin:senha@192.168.1.50:554/h264Preview_01_main - Reolink sub:
rtsp://admin:senha@192.168.1.50:554/h264Preview_01_sub - Principal Amcrest:
rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0 - Subamcrest:
rtsp://admin:senha@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1
Passo 3 — Abra o Home Assistant e adicione a integração ONVIF
Na IU do Home Assistant (em execução no iSG Box SE ou em outro lugar):
- Vá para Configurações → Dispositivos e serviços
- Clique + Adicionar integração (canto inferior direito)
- Procure por "ONVIF" e selecione-o
O Home Assistant fará a varredura da rede local via WS-Discovery. A maioria das câmeras aparece automaticamente. Caso o seu não tenha, você pode adicioná-lo manualmente por IP.
Passo 4 — Insira IP, porta e credenciais
A porta ONVIF padrão é 80 (HTTP) na maioria das câmeras, não 554 (que é RTSP — uma porta diferente). Se a sua câmera usar uma porta ONVIF não padrão (2020, 8000, 8899 são comuns), ela será listada na interface da web da câmera na seção Rede ou ONVIF.
Digite:
- Anfitrião: o IP estático da LAN da câmera
- Porto: geralmente 80; A Hikvision costuma usar 80, Dahua 80, Reolink 8000
- Nome de usuário/senha: as credenciais ONVIF que você definiu em §2.4 (Hikvision: o usuário ONVIF dedicado criado na Etapa 1)
Passo 5 — Escolha os perfis (principal + sub stream)
O Home Assistant exporá todos os "perfis" ONVIF anunciados pela câmera - normalmente um para o fluxo principal (alta resolução) e outro para o fluxo secundário (baixa resolução). Habilite ambos:
- Fluxo principal — usado para gravações, instantâneos e visualização de alta qualidade
- Transmissão secundária - usado para o bloco do painel Home Assistant Lovelace (para que o painel carregue rapidamente, mesmo em dispositivos móveis)
Clique Enviar. A câmera agora aparece abaixo Dispositivos e serviços com entidades para transmissão ao vivo, sensor de movimento e (se a câmera suportar) sensores binários para qualquer evento em que a câmera dispara — cruzamento de linha, detecção de intrusão, classificação de pessoas/veículos, adulteração.
Solução de problemas do Reolink ONVIF
Esses são os quatro problemas que geram 90% dos tópicos do fórum sobre o Home Assistant ONVIF. Veja como consertar cada um em menos de dois minutos.
4.1 "Câmera não descoberta" durante Adicionar Integração
O WS-Discovery usa DNS multicast (mDNS). Se o seu host Home Assistant e sua câmera estiverem em VLANs ou SSIDs WiFi diferentes, os pacotes mDNS não cruzam o limite. Correções, em ordem de esforço:
- Coloque a câmera na mesma sub-rede que Home Assistant temporariamente para descoberta e, em seguida, mova-a de volta.
- Adicione a câmera manualmente por IP durante a configuração da integração (WS-Discovery é uma conveniência, não um requisito).
- Habilite a reflexão mDNS/Avahi em seu roteador (UniFi: "Multicast DNS", pfSense: pacote "Avahi", OpenWrt: "umdns"). Esta é a solução permanente.
4.2 A transmissão ao vivo continua sendo armazenada em buffer ou mostrando "Transmissão não disponível"
O fluxo principal em 4K ou 1440p + 30 fps costuma ser demais para o painel Lovelace, especialmente em dispositivos móveis. Mude o bloco do painel para o substream:
- Configurações → Dispositivos e Serviços → Integração ONVIF → Configurar → desmarque "Perfil Principal" para o Cartão de Entidade de Imagem
- Ou diretamente no cartão da câmera YAML: set
stream_sourcepara a entidade de subperfil
O Frigate NVR (abordado na Seção 5) é uma solução mais limpa aqui – ele recodifica o fluxo uma vez e fornece HLS/WebRTC de baixa latência para todos os clientes.
4.3 Entidades de detecção de movimento não disparando eventos em Home Assistant
Os eventos de movimento ONVIF são opcionais nas especificações – a câmera deve (a) ter detecção de movimento habilitada localmente e (b) ser configurada para publicar eventos ONVIF. Etapas:
- Na interface web da câmera, ative a detecção de movimento (geralmente Evento → Detecção de movimento → Ativar)
- Encontre as configurações ONVIF ou "evento inteligente" e ative "Eventos ONVIF" ou "Eventos Push"
- No Home Assistant, reinicie a integração ONVIF: Configurações → Dispositivos e serviços → ONVIF → menu de três pontos → Recarregar
Se você estiver em uma câmera Hikvision ou Hikvision-OEM e os eventos ainda não dispararem, verifique se o usuário ONVIF que você criou na §3 Etapa 1 tem as permissões "Evento" e "Mídia" — por padrão, o usuário ONVIF é somente leitura para Usuário gerenciamento, o que é correto, mas algumas versões de firmware também restringem a assinatura de eventos.
4.4 A câmera funciona por um dia e depois fica off-line até ser reiniciada
Isso quase sempre é uma expiração de concessão de DHCP (sem reserva estática) ou um tempo limite de manutenção de atividade RTSP. Confirme se a reserva de IP estático de §2.3 é aplicada no roteador, não apenas nas configurações de rede da própria câmera. Algumas câmeras homenageiam ambos; alguns ignoram seu próprio IP estático e aceitam tudo o que o roteador atribui.
5. Bônus: Adicionando Fragate NVR para detecção de objetos AI
O movimento nativo do Home Assistant ONVIF é binário: "algo se moveu" ou "nada se moveu". Isso desencadeia muitos falsos positivos devido às folhas espalhadas pelo gramado ou às sombras ao pôr do sol.
Fragata é um NVR gratuito e de código aberto que funciona como um complemento Home Assistant e faz detecção local de objetos de IA na imagem da câmera - então, em vez de "movimento", suas automações disparam em "pessoa", "carro", "pacote" ou "cachorro". Tudo roda em seu host Home Assistant; nenhum quadro sai da LAN.
Por que o iSG Box SE é poderoso o suficiente para hospedar o Fragate:
- O detector de CPU padrão do Frigate lida com 2 a 4 câmeras a 5 a 7 fps cada no iSG Box SE sem aceleração térmica.
- Se você dimensionar para 6 a 8 câmeras posteriormente, adicione um acelerador USB Google Coral de US $ 60 e a inferência de descarregamento do Fragate para a TPU - o iSG Box SE tem largura de banda USB sobressalente para isso.
- A configuração leva cerca de 15 minutos: instale o complemento Frigate da loja de complementos Home Assistant, cole seus URLs ONVIF RTSP do §3 Etapa 2 em
fragata.yaml, recarregue.
Combine isso com as automações Home Assistant ("se o Frigate detectar uma pessoa na porta da frente entre 22h e 6h, acenda a luz da varanda e pisque a lâmpada da sala três vezes") e você terá um sistema de segurança inteligente que não custa nada para ir além da conta de luz. O Caixa iSG SE é o ponto inicial de menor atrito exatamente para esta pilha.
Perguntas frequentes sobre integração Home Assistant ONVIF
O Home Assistant pode usar câmeras ONVIF sem acesso à nuvem?
Sim. O Home Assistant pode se conectar a muitas câmeras ONVIF na rede local usando o endereço IP da câmera, a porta ONVIF e as credenciais locais.
Por que uma câmera Reolink precisa de configurações RTSP com ONVIF?
O ONVIF lida com a descoberta e o controle, enquanto o RTSP geralmente carrega a transmissão de vídeo ao vivo. Se o vídeo falhar, confirme o caminho RTSP, o firmware e as permissões de LAN.
Qual gateway LinknLink é melhor para automação de câmeras locais?
Use o iSG Box SE para um gateway Home Assistant compacto ou o iSG Display Max quando você também quiser uma tela na parede para controles de câmera e sala.
7. Conclusão: comece hoje mesmo sua configuração ONVIF com iSG Box SE
A integração ONVIF é o caminho mais curto de “Eu tenho uma câmera IP” para “minhas luzes acendem quando alguém entra na garagem, meu HVAC muda quando a sala fica vazia por 20 minutos e meu telefone me avisa quando Frigate vê uma van de entrega em vez de um gato de rua”. E a maneira mais barata de chegar lá sem mexer no hardware durante todo o fim de semana é Caixa LinknLink iSG SE ($ 69,90) — Home Assistant pré-instalado, 100% local, pronto para rodar ONVIF e Fragate no momento em que você abre a caixa.
Siga as cinco etapas do §3 e você terá sua primeira câmera transmitindo dentro do Home Assistant em menos de dez minutos. Adicione a camada §5 Fragata no próximo fim de semana. Adicione o restante de suas câmeras sempre que desejar — a integração ONVIF pode ser dimensionada para mais de 8 dispositivos sem qualquer configuração adicional.