Asystent domowy + integracja z Wyze: Pełna instrukcja konfiguracji krok po kroku
20 min czytania

Asystent domowy + integracja z Wyze: Pełna instrukcja konfiguracji krok po kroku

Spis treści

Kupiłeś kilka kamer i wtyczek Wyze, ponieważ były tanie, działały, a aplikacja była znośna. Teraz chcesz je w Home Assistant — jeden dashboard, jeden silnik automatyzacji, bez przeskakiwania między czterema aplikacjami na telefonie, aby przyciemnić żarówkę. Integracja home assistant wyze jest możliwa już dziś, ale ścieżka jest utrzymywana przez społeczność, częściowo uzależniona od chmury i łatwiej jest się w niej pomylić, niż sugerują samouczki na YouTube. Ten przewodnik przeprowadzi Cię przez działającą konfigurację, tryby awarii i szczere kompromisy — w tym momencie, gdy Wyze przestaje mieć sens w Twoim stosie.

A hero shot of a tidy home office desk. On the left: a Wyze Cam v3 and a Wyze plug. On the right: a laptop displaying Home Assistant's Lovelace dashboard with a live camera feed tile and a plug toggle. A small Raspberry Pi 4 in a case sits between th

Dlaczego Wyze + Home Assistant działa (i gdzie integracja cicho się łamie)

Zacznij od rzeczywistości praktyka: nie istnieje oficjalna integracja home assistant wyze. Każda działająca konfiguracja dzisiaj opiera się na projektach utrzymywanych przez społeczność — przede wszystkim ha-wyzeapi (autorstwa SecKatie) do wtyczek, żarówek, zamków, czujników i termostatów, oraz Docker Wyze Bridge do strumieni RTSP kamer. Zgodnie z odpowiedzią na forum Wyze, Wyze „skupia wysiłki na MATTER" zamiast budować natywną integrację HA. To zdanie mówi wszystko o obecnym stanie: Wyze nie nadchodzi do Home Assistant. Home Assistant trafia do Wyze tylnymi drzwiami, z zaciekami społeczności.

Istnieją dwie ścieżki integracji i robią różne rzeczy:

  • Ścieżka Cloud API (ha-wyzeapi). Kontroluje wtyczki, żarówki, zamki, czujniki i termostat Wyze przez prywatny internetowy API Wyze. Home Assistant musi osiągnąć Internet do każdego polecenia. Tokeny automatycznie odświeżają się w tle. Konfiguracja zajmuje około pięciu minut, gdy HACS jest na miejscu.
  • Ścieżka RTSP / bridge (Docker Wyze Bridge). Udostępnia strumienie kamer lokalnie jako rtsp://<ha-ip>:8554/<camera-name>. Wideo płynie przez LAN, gdy bridge został uwierzytelniony. Krótka awaria WAN zwykle nie przerywa ustalonego strumienia, ale początkowe uwierzytelnianie i utrzymanie sesji nadal wymagają osiągalności chmury Wyze.

Prawie na pewno uruchomisz oba równolegle: API do przełączników i żarówek, Bridge do kamer, które chcesz transmitować na dysk zamiast do Seattle.

Teraz rzeczywistość prywatności. Przegląd Privacy Not Included Fundacji Mozilla dla Wyze Cam v3 daje kamerze ostrzeżenie „Privacy Not Included", cytując, że Wyze zbiera „audio, wideo, dane użytkowania urządzenia i lokalizację" oraz udostępnia dane dostawcom analityki i reklamy stron trzecich. Zawinięcie Home Assistant wokół kamery nie zmienia tego, co Wyze zbiera. Daje ci lokalny interfejs na górze danych przechowywanych w chmurze. Jeśli powodem przejścia do Home Assistant była prywatność, urządzenia Wyze są kompromisem, a nie rozwiązaniem.

Warto to trzymać obok deklarowanej filozofii Home Assistant. Paulus Schoutsen, założyciel Home Assistant, napisał w State of the Open Home: „Uważamy, że Twój inteligentny dom powinien być domyślnie lokalny i prywatny. Chmura powinna być opcją, a nie wymaganiem." Urządzenia Wyze są opcją, która wymaga chmury. Żyją poza filozofią projektowania HA. Przydatne, ale hybrydowe — nie forteca.

Wyze plus Home Assistant to nie rozwiązanie offline. Integracja mówi z chmurą Wyze — Home Assistant po prostu daje ci ładniejszy dashboard na górze tej rozmowy.

Koszt niezawodności jest mierzalny. Według Joudaki et al. (IMC 2020), 39% awarii automatyzacji inteligentnego domu wynika z utraty łączności internetowej. Dlatego integracje oparte na API chmury łamią automatyzacje podczas awarii ISP, podczas gdy urządzenia Zigbee i Z-Wave nadal działają. Jeśli taśma brzegowa drzwi przednich zależy od wtyczki Wyze, a ISP ma zły wtorek, ta taśma jest włączona lub wyłączona na podstawie stanu, w jakim była, gdy połączenie zerwało się — nie na ruchu, nie na harmonogramie, nie na niczym.

W Set Smart Home instalujemy konfiguracje Wyze + HA dla klientów, którzy już posiadają urządzenia i chcą szybkich wyników w oświetleniu i monitorowaniu. Nie rekomendujemy Wyze dla niczego krytycznego dla bezpieczeństwa — zamków, alarmów, dostępu wyzwalanego obecnością. Te znajdują się na Zigbee, Z-Wave lub Matter. Przejdziemy do tego porównania w sekcji ostatniej. Najpierw konfiguracja.

Wymagania wstępne i kompatybilność urządzenia po urządzeniu

Przed dotknięciem interfejsu Home Assistant przejdź przez tę listę kontrolną. Brak któregokolwiek z nich zablokuje integrację lub spowoduje, że ulegnie awarii sporadycznie tydzień później — co jest znacznie trudniejsze do debugowania niż natychmiastowa awaria.

  1. Home Assistant Core lub OS, wersja 2023.x lub nowsza. Starsze wersje brakuje stabilnej obsługi HACS i natrafisz na błędy zależności, które żaden post na forum nie rozwiąże czyszczej.
  2. HACS (Home Assistant Community Store) zainstalowany. Integracja Wyze jest utrzymywana przez społeczność i nie jest w oficjalnym rejestrze integracji. Przewodnik instalacji: hacs.xyz/docs/setup/download.
  3. Email i hasło konta Wyze. Te same dane logowania, których używasz w aplikacji mobilnej. Rozważ utworzenie dedykowanego konta podrzędnego dla HA — omówione w sekcji wzmacniania.
  4. Sprawdzenie statusu 2FA. ha-wyzeapi historycznie miał problemy z 2FA TOTP i SMS. Bieżące wersje wspierają TOTP przez ekstrakcję tajnych, ale najczystszą ścieżką jest dedykowane konto podrzędne Wyze bez 2FA dla HA tylko, z 2FA nadal aktywnym na koncie osobistym.
  5. Klucz API Wyze i identyfikator klucza. Wyze wymaga teraz od deweloperów wygenerowania klucza API i identyfikatora klucza w developer-api-console.wyze.com. Bezpłatnie, wymaga istniejącego konta Wyze. Jeden klucz na instancję HA wystarczy.
  6. Stabilny internet do konfiguracji. Nawet bridge RTSP potrzebuje dostępu WAN do początkowego uwierzytelniania kamery i okresowego keepalive.
  7. W szczególności dla kamer: albo oprogramowanie sprzętowe beta RTSP zainstalowane na kamerze, albo add-on Docker Wyze Bridge zainstalowany. Oprogramowanie sprzętowe RTSP jest dostępne w Obsłudze Wyze.

Teraz macierz kompatybilności. Nie każde urządzenie Wyze działa równie dobrze w Home Assistant, a jedno z nich — kamera v1 — nie powinno być w ogóle w Twoim domu.

Urządzenie WyzeMetoda integracjiKontrola lokalna?Notatki konfiguracji
Wyze Cam v2 / v3Docker Wyze Bridge (RTSP)Częściowa — tylko wideo LANAuth nadal trafia do chmury Wyze
Wyze Cam v1NiezalecaneN/AEOL 2021; nienaprawiona luka RCE
Wyze Cam Pan v2Docker Wyze BridgeCzęściowaKontrola pan/tilt tylko przez chmurę
Wyze Plug / Plug Outdoorha-wyzeapi (cloud)NieWłączenie/wyłączenie zależne od chmury
Wyze Bulb White / Colorha-wyzeapi (cloud)NieJasność + kolor przez API
Wyze Lockha-wyzeapi (cloud)NieKontrola chmury — unikaj dla bezpieczeństwa krytycznego
Wyze Thermostatha-wyzeapi (cloud)NieTemperatura + tryb przez API
Wyze Sense v1 (USB bridge)ha-wyzesense (HACS)Tak — lokalnieWymaga USB bridge podłączonego do hosta HA
Wyze Sense v2Nieobsługiwane w HAN/ABrak działającej integracji społeczności

Wykluczenie v1 zasługuje na akapit. Według Bitdefender Labs, Wyze Cam v1 miała lukę w zdalnym wykonywaniu kodu pozwalającą atakującym na dostęp do transmisji kamer i zawartości karty SD. The Verge poinformował, że Wyze wiedziała o tym przez prawie trzy lata zanim ujawnił się w marcu 2022 — w tym momencie aktualizacje się skończyły. Jeśli nadal masz v1 w użyciu, kwestia integracji jest bez znaczenia. Zastąp ją.

Dla wiersza Wyze Lock: integracja działa, ale jedyną rzeczą stojącą między Twoimi drzwiami przednimi a czasem działania chmury Wyze jest czas działania chmury Wyze. Dla zamków, gdzie trybem awarii jest „ktoś nie może wejść" lub „ktoś może", to nie jest wymiana, którą robimy w domach klientów. Traktuj Wyze Lock jako encję wygody na pulpicie, nigdy jako składnik nośny architektury bezpieczeństwa inteligentnego domu.

Jeden punkt danych społeczności warty poznania: użytkownik Wyze „carverofchoice" szacuje na forum Wyze, że łączenie Docker Wyze Bridge, ha-wyzeapi i Alexa obejmuje około 90% urządzeń Wyze w HA. Traktuj to jako szacunek społeczności, a nie specyfikację — Twoje wyniki zależy od tego, które urządzenia posiadasz.

Instalacja ha-wyzeapi przez HACS — ścieżka Cloud API do wtyczek, żarówek, zamków i termostatów

To jest integracja, którą większość czytających chce najpierw: przełącz wtyczkę, przyciemnij żarówkę, zobacz czujnik w HA. Postępuj zgodnie z krokami w kolejności. Przeskakiwanie — zwłaszcza na klucz API — jest jedynym najczęstszym powodem błędów „Invalid credentials" w ostatnim kroku.

Krok 1 — Wygeneruj poświadczenia API Wyze

  • Otwórz developer-api-console.wyze.com
  • Zaloguj się na swoim koncie Wyze
  • Kliknij „Create API Key"
  • Skopiuj zarówno API Key (długi łańcuch) jak i Key ID (format UUID) do menedżera haseł
  • Wyze ogranicza szybkość kluczy API na konto; jeden klucz na instancję HA wystarczy

Krok 2 — Zainstaluj HACS (pomiń, jeśli już zrobione)

  • Otwórz dodatek Terminal & SSH HA
  • Uruchom: wget -O - https://get.hacs.xyz | bash -
  • Uruchom ponownie Home Assistant
  • Settings → Devices & Services → Add Integration → wyszukaj „HACS" → autoryzuj przez GitHub

Krok 3 — Dodaj ha-wyzeapi jako niestandardowe repozytorium

  • Otwórz HACS na pasku bocznym HA
  • Kliknij menu trzy kropki (prawy górny róg) → Custom Repositories
  • URL repozytorium: https://github.com/SecKatie/ha-wyzeapi
  • Kategoria: Integration
  • Kliknij „Add"
Screenshot of the Home Assistant "Add Integration" dialog with "Wyze" typed in the search box and the community Wyze integration result highlighted. UI in light mode for readability.

Krok 4 — Zainstaluj integrację

  • W HACS wyszukaj „Wyze Home Assistant Integration"
  • Kliknij wynik → Download → wybierz najnowszą wersję → Download
  • Uruchom ponownie Home Assistant (Settings → System → Restart)

Krok 5 — Skonfiguruj integrację

  • Settings → Devices & Services → Add Integration → wyszukaj „Wyze"
  • Wprowadź:
    • Email (email konta Wyze)
    • Password (hasło konta Wyze)
    • API Key (z kroku 1)
    • Key ID (z kroku 1)
    • TOTP secret — tylko jeśli włączony jest 2FA, wyodrębniony z wpisu Wyze w aplikacji autentyfikatora
  • Kliknij Submit

Krok 6 — Zweryfikuj import urządzeń

  • HA automatycznie odkrywa wszystkie urządzenia na koncie Wyze
  • Settings → Devices & Services → Wyze → wyświetl listę urządzeń
  • Każde urządzenie pojawia się z identyfikatorami encji takimi jak light.living_room_bulb, switch.kitchen_plug, lock.front_door
  • Przetestuj przełączając wtyczkę z pulpitu HA. Odpowiedź powinna przybyć w ciągu 1–3 sekund.

Krok 7 — Przetestuj tryb awarii (zrób to raz, celowo)

  • Odłącz kabel WAN routera, utrzymując LAN
  • Spróbuj przełączyć wtyczkę Wyze z HA → będzie to nie powiodło się z błędem timeout
  • Podłącz WAN z powrotem → kontrola wznawia się w ciągu około 30 sekund
  • Udokumentuj to oczekiwane zachowanie gdzieś w swoich notatkach, aby nie zaskoczyło Cię podczas rzeczywistej awarii

Ten tryb awarii to dokładnie to, co badanie IMC 2020 określiło na 39% awarii automatyzacji. Zobaczysz to. Pytanie brzmi, czy automatyzacje, które budujesz na ha-wyzeapi, mogą to tolerować.

Dodawanie kamer Wyze lokalnie przez Docker Wyze Bridge i RTSP

Kamery to jedna kategoria Wyze, gdzie możesz uzyskać wideo płynące przez LAN bez wysyłania każdej klatki do chmury Wyze. Istnieją dwie metody. Most jest właściwą odpowiedzią dla prawie każdego.

Metoda A: Oprogramowanie sprzętowe beta RTSP Wyze (prostsze, ale ograniczone)

Wyze zapewnia oprogramowanie sprzętowe beta, które udostępnia bezpośredni strumień RTSP z kamery do 1080p. Działa na Wyze Cam v2, v3 i Pan v2. Pobierz z Obsługi Wyze. Wyze wyraźnie ostrzega, że RTSP jest „funkcją beta", która „może zmniejszyć wydajność i wyłączyć niektóre funkcje aplikacji Wyze". Po zainstalowaniu, ustawiasz poświadczenia RTSP w aplikacji Wyze w ustawieniach kamery → Advanced Settings → RTSP.

Skonfiguruj w configuration.yaml HA:

camera:
  - platform: generic
    name: Front Door Cam
    stream_source: rtsp://<rtsp_user>:<rtsp_pass>@192.168.1.50/live
stream:
ffmpeg:
  ffmpeg_bin: /usr/bin/ffmpeg

Pracujący przykład YAML z przewodnika konfiguracji Variax.

Minusem jest, że instalujesz oprogramowanie sprzętowe beta, które wyłącza niektóre funkcje aplikacji Wyze. Jeśli kiedyś będziesz musiał przywrócić, proces jest trudny.

Metoda B: Add-on Docker Wyze Bridge (rekomendowany)

To działa bez flashowania oprogramowania sprzętowego, obsługuje więcej modeli kamer i jest aktywnie utrzymywane przez mrlt8 w github.com/mrlt8/docker-wyze-bridge. Instaluje się jako dodatek Home Assistant.

Kroki:

  1. Settings → Add-ons → Add-on Store → menu trzy kropki → Repositories → dodaj https://github.com/mrlt8/docker-wyze-bridge
  2. Zainstaluj „Docker Wyze Bridge" z magazynu dodatków
  3. Na karcie Configuration wprowadź email Wyze, hasło, API Key i Key ID
  4. Uruchom dodatek i obserwuj logi dla Connected to camera <name>
  5. Most udostępnia RTSP w rtsp://<ha-ip>:8554/<camera-slug> (slug = nazwa kamery Wyze z małych liter i łącznikami)

Dodaj strumienie do configuration.yaml:

camera:
  - platform: generic
    name: Backdoor
    stream_source: rtsp://192.168.0.84:8554/backdoor
  - platform: generic
    name: Garage
    stream_source: rtsp://192.168.0.84:8554/garage
stream:
ffmpeg:

RTSP sam w sobie nie jest specyficzny dla Wyze. Protokół jest zdefiniowany w RFC 2326, standardzie IETF z 1998 r. używanym przez praktycznie wszystkie sieciowe kamery do transmisji na żywo. Dlatego platforma Generic Camera Home Assistant obsługuje strumienie Wyze bez specjalnych sterowników — po prostu wskazujesz HA na standardowy punkt końcowy RTSP, który przypadkowo jest obsługiwany przez most.

Co „lokalnie" tu naprawdę oznacza

Po uwierzytelnieniu się mostu z chmurą Wyze — początkowe uzgodnienie plus okresowe keepalive — sam strumień wideo płynie bezpośrednio z kamery do HA przez LAN. Podczas krótkotrwałej awarii WAN, istniejące strumienie zazwyczaj nadal działają. Podczas przedłużonej awarii (godziny, nie minuty), most może stracić token sesji i mieć potrzebę ponownego uwierzytelnienia, co bez internetu nie powiodło się. Kamery wracają do trybu online, gdy WAN to robi.

To jest tak blisko lokalnym kamerom Wyze, jak możesz się dostać bez wymiany sprzętu. Dla całkowicie offline kamer, potrzebowałbyś kamer IP PoE z obsługą ONVIF — Reolink, Amcrest, Hikvision — co jest poza zakresem tego przewodnika, ale warte poznania jako naturalna ścieżka ulepszenia.

Praktyczne automatyzacje, które możesz zbudować po połączeniu Wyze

Sześć przepisów, każdy z jednowierszkowym opisem, pracującym YAML i uczciwaną notatką na temat, które części zależą od chmury Wyze. Skopiuj je, zmień identyfikatory encji, aby pasowały do Twojej konfiguracji, i wklej do automations.yaml lub zbuduj je w interfejsie HA Automations.

Przepis 1: Oświetlenie korytarza wyzwalane ruchem

Wyze Cam v3 wykrywa ruch → HA włącza żarówkę Wyze (lub dowolne oświetlenie kontrolowane przez HA) na pięć minut.

automation:
  - alias: "Hallway motion light"
    trigger:
      - platform: state
        entity_id: binary_sensor.hallway_cam_motion
        to: "on"
    action:
      - service: light.turn_on
        target:
          entity_id: light.hallway_bulb
      - delay: "00:05:00"
      - service: light.turn_off
        target:
          entity_id: light.hallway_bulb

Zależność od chmury: Zdarzenie ruchu płynie z kamery Wyze → chmura Wyze → ha-wyzeapi → HA. Opóźnienie wynosi zazwyczaj 2–5 sekund. Nie nadaje się do „włącz światło zanim nadepnę na coś".

Przepis 2: Harmonogram wtyczki oparty na zachodzie słońca

Wtyczka Wyze włącza się w krajobrazie o zachodzie słońca, wyłącza się o 23:00.

automation:
  - alias: "Landscape lights sunset"
    trigger:
      - platform: sun
        event: sunset
    action:
      - service: switch.turn_on
        entity_id: switch.landscape_plug

Zależność od chmury: Pełna. Polecenia wtyczek trasują się przez API Wyze. Jeśli internet wypadnie o zachodzie słońca, automatyzacja cicho zawiedzie i oświetlenie krajobrazowe będzie wyłączone, dopóki nie zauważysz.

Przepis 3: Migawka kamery przy ruchu zapisana lokalnie

Gdy ruch Wyze się pojawia, zapisz zdjęcie JPG do lokalnego folderu /config/www/snapshots/ HA.

automation:
  - alias: "Snapshot on motion"
    trigger:
      - platform: state
        entity_id: binary_sensor.backdoor_cam_motion
        to: "on"
    action:
      - service: camera.snapshot
        target:
          entity_id: camera.backdoor
        data:
          filename: "/config/www/snapshots/backdoor_{{ now().strftime('%Y%m%d_%H%M%S') }}.jpg"

Zależność od chmury: Wyzwalacz ruchu jest trasowany chmurą; sama migawka pochodzi ze strumienia lokalnego RTSP, jeśli ustawiłeś Docker Wyze Bridge. Tak więc wyzwalacz może się nie powieść, ale jeśli się pojawi, migawka jest lokalna.

Przepis 4: Uzbrojenie kamery oparte na obecności

Wyłącz powiadomienia o ruchu, gdy mieszkańcy są w domu; włącz ponownie, gdy wszyscy wychodzą.

automation:
  - alias: "Arm cameras when away"
    trigger:
      - platform: state
        entity_id: group.family
        to: "not_home"
    action:
      - service: switch.turn_on
        entity_id: switch.backdoor_cam_motion_detection

Zależność od chmury: Przełączanie stanu detektora ruchu przechodzi przez chmurę Wyze.

Przepis 5: Dostosowanie termostatu ze względu na zajętość

Obniż punkt zadany termostatu Wyze o kilka stopni, gdy nikt nie jest w domu przez piętnaście minut. Dostosowania oparte na obecności działają dobrze w gospodarstwach domowych z przewidywalną rutyną i są podstawą dla bardziej wyrafinowanych automatyzacji dla gospodarstw domowych ze zwierzętami, gdzie chcesz inne zasady, gdy ludzie wychodzą, ale pies zostaje.

automation:
  - alias: "Eco mode when away"
    trigger:
      - platform: state
        entity_id: group.family
        to: "not_home"
        for: "00:15:00"
    action:
      - service: climate.set_temperature
        target:
          entity_id: climate.wyze_thermostat
        data:
          temperature: 17

Zależność od chmury: Pełna.

Przepis 6: Warunkowa scena mieszająca Wyze z urządzeniami spoza Wyze

Scena „Movie night" łącząca żarówkę kolorową Wyze z ściemniaczem Zigbee i inteligentnym telewizorem.

scene:
  - name: Movie Night
    entities:
      light.living_room_wyze_bulb:
        state: on
        brightness: 40
        rgb_color: [180, 0, 255]
      light.ceiling_zigbee_dimmer:
        state: off
      media_player.living_room_tv:
        state: on

Zależność od chmury: Polecenie żarówki Wyze jest trasowane chmurą; ściemniacz Zigbee jest całkowicie lokalny. Sceny mieszanego protokołu to miejsce, gdzie HA wykonuje ciężką pracę, której własna aplikacja Wyze nie potrafi.

Home Assistant nie zastępuje chmury Wyze — aranżuje wokół niej. Kupujesz elastyczność i ujednolicony pulpit, a nie niezależność.
Screenshot of a Home Assistant Lovelace dashboard showing a Wyze camera tile with live feed, three Wyze plug toggles, two color bulb cards with brightness sliders, and a thermostat card. Dark mode.

Jedna dyrektywa przed przejściem dalej: dla każdej automatyzacji obejmującej bezpieczeństwo fizyczne — zamki, alarmy, odblokowywanie drzwi wyzwalane obecnością, alarmy dymu lub wody — nie polegaj na Wyze. Używaj urządzeń Zigbee lub Z-Wave dla tych wyzwalaczy i akcji. Następne dwie sekcje wyjaśniają dlaczego i jak.

Rozwiązywanie problemów — pięć trybów awarii, na które rzeczywiście trafisz

To pięć problemów, na które natrafisz, w mniej więcej kolejności, w której je napotkacie. Każdy wiersz tabeli mapuje objaw na przyczynę główną i naprawę.

#ObjawPrzyczyna głównaDiagnostykaNaprawa
1„Invalid credentials" przy konfiguracjiBrak klucza API/identyfikatora klucza lub 2FA blokujeZweryfikuj logowanie do aplikacji Wyze; potwierdź klucz w konsoli deweloperaWygeneruj ponownie klucz API; wyodrębnij tajny TOTP, jeśli 2FA włączony
2Urządzenia nieresponsywne po 1–2 godzinachOgraniczenie szybkości API Wyze lub token sesji wygasłHA Settings → System → Logs, wyszukaj „wyzeapi"Przeładuj integrację: Devices & Services → Wyze → Reload
3Strumień RTSP się jeczy lub zamieniaBrakuje konfiguracji ffmpeg lub wąskie gardło przepustowościWyświetl logi dodatku; przetestuj strumień w VLCDodaj bloki stream: i ffmpeg:; użyj substrumienia
4Automatyzacje przestają działać w nocyOdświeżenie tokenu nie powiodło się przy restarcie HA lub zmiana API WyzeSprawdź forum statusu Wyze; sprawdź logi HA w momencie restartuPonownie uwierzytelniaj integrację; zaktualizuj ha-wyzeapi przez HACS
5Wyze Lock pokazuje zły stanOpóźnienie pamięci podręcznej chmury Wyze — HA odzwierciedla ostatni znany stanSprawdź krzyżowo stan w aplikacji mobilnej WyzeWymuś odświeżenie: Developer Tools → Services → homeassistant.update_entity

Kilka notek na temat tego, jak te awarie wyglądają w praktyce.

Tryb awarii 4 jest najbardziej podstępny. Pojawia się sporadycznie — automatyzacje działają dobrze przez dni, potem cicho się zatrzymują w nocy. Rzeczywistą przyczyną jest prawie zawsze zmiana API Wyze, która złamała ha-wyzeapi, a naprawą jest aktualizacja HACS integracji w ciągu jednego do dwóch tygodni od awarii. Utrzymuj powiadomienia HACS włączone w aplikacji mobilnej HA i sprawdzaj problemy GitHub ha-wyzeapi, gdy widzisz niewyjaśnione spadki.

Tryb awarii 3 ma sufit sprzętu. Ładowanie transcodingu ffmpeg szybko nasycą Raspberry Pi 4, jeśli jednocześnie uruchamiasz cztery lub więcej strumieni kamer. Naprawą jest albo przełączenie się na tryb Substream (niższa rozdzielczość) w konfiguracji Docker Wyze Bridge, albo przeniesienie HA na sprzęt x86 — odnowiony Intel NUC obsługuje 8+ kamer Wyze bez wysiłku za mniej niż 200 dolarów.

Szerszy kontekst warty pamiętania podczas debugowania: rozwiązywanie problemu z integracją Wyze nie dotyczy tylko przywracania kontroli. Każde wywołanie API wychodzące jest obserwowalne. Badania autorstwa Apthorpe et al. wykazały, że nawet zaszyfrowany ruch inteligentnego domu wycieknie informacje behawioralne — „obserwatorzy sieci mogą wysnuć wrażliwe wnioski na temat zachowania użytkownika, takie jak kiedy jest w domu, śpi lub używa pewnych urządzeń." Gdy naprawiasz Tryb Awarii 2 przeładowując integrację, przywracasz strumień metadanych o Twoim domu, który tam nie był podczas awarii. To nie jest powód, aby tego nie naprawiać. To jest powód, aby podejmować decyzje dotyczące tego, które urządzenia w ogóle należą do tego strumienia.

Wzmacnianie konfiguracji Wyze + Home Assistant przed realistycznymi zagrożeniami

Model zagrożeń dla Wyze + Home Assistant to nie haker w kapturze po drugiej stronie świata. To dostawca opóźniający ujawnienie wad, które już istnieją w Twoim sprzęcie. Dan Goodin w Ars Technica poinformował w 2022 r., że „Wyze... nie ujawnił przez trzy lata lukę bezpieczeństwa, która pozwoliła atakującym na zdalny dostęp do transmisji wideo i zawartości karty SD." To jest realistyczny kształt ryzyka: znana luka, czekająca, w kamerach, które kupiłeś, ponieważ były tanie.

Jen Caltrider, która kieruje programem Privacy Not Included Mozilli, jasno przedstawia ekonomikę: „Jeśli podłączone urządzenie jest tanie, jest duża szansa, że firma zarabia na Twoich danych w jakiś sposób." Wyze Cam v3 kosztuje około 36 dolarów. Warstwa monetyzacji danych jest częścią modelu ceny. Home Assistant tego nie zmienia — po prostu pozwala ci zobaczyć urządzenie obok wszystkiego innego.

Wzmacnianie zmniejsza promień wybuchu. Nie zmienia praktyk dotyczących danych Wyze. Z tym sformułowaniem, oto lista kontrolna ośmiu pozycji dla wdrożenia Wyze + HA, które nie pogorszą sytuacji:

  1. Użyj dedykowanego konta podrzędnego Wyze dla Home Assistant. Nie udostępniaj poświadczeń głównego konta integracji. Jeśli host HA kiedykolwiek zostanie skompromitowany, możesz odwołać to konto podrzędne bez utraty dostępu na telefonie.
  2. Przechowuj poświadczenia w secrets.yaml, nie w configuration.yaml. HA czyta z secrets.yaml (trzymane poza każdą migawką kopii zapasowej lub repo, które dzielisz) i odwołuje się przez !secret wyze_password.
  3. Włącz 2FA na głównym koncie Wyze. Chociaż komplikuje to integrację HA, pozostawienie 2FA wyłączonego na koncie używanym przez człowieka to większe ryzyko.
  4. Izoluj kamery Wyze VLAN-iem. Umieść wszystkie urządzenia Wyze na oddzielnym VLAN bez dostępu do osobistego LAN. Nadal potrzebują WAN do uwierzytelniania chmury, ale nie mogą się obrócić do Twoich komputerów lub NAS, jeśli zostaną skompromitowane. To jest standardowa praktyka dla każdego urządzenia, które telefonuje do domu, i jest fundamentem architektury bezpieczeństwa inteligentnego urządzenia.
  5. Blokuj ruch wychodzący z kamer do niepotrzebnych miejsc docelowych. Kamery Wyze muszą docierać tylko do punktów końcowych API Wyze. Jeśli Twój router obsługuje białą listę na podstawie DNS, ogranicz do tych domen.
  6. Ogranicz dostęp do pulpitu HA. Settings → People → utwórz oddzielnych użytkowników z rolą Viewer dla członków rodziny, którzy nie powinni wyłączać kamer lub odblokowywać drzwi. Wymuś silne hasła na każdym koncie.
  7. Nie udostępniaj Home Assistant bezpośrednio do internetu. Użyj Nabu Casa Cloud (6,50 USD/miesiąc, od firmy macierzystej HA) lub samodzielonego tunelu Tailscale. Przekierowanie portów HA do otwartego internetu to jedynym najczęstszym wektorem kompromisu HA.
  8. Monitoruj zdarzenia nieudanego uwierzytelnienia. Obserwaj logi HA w poszukiwaniu powtarzających się błędów uwierzytelniania wyzeapi — ten wzór może wskazywać na przejęcie konta Wyze lub po prostu wygasłe poświadczenia, ale w każdym razie chcesz wiedzieć wcześnie.

To, czego wzmacnianie nie może naprawić: nawet przy wszystkich powyższych, ramy wideo kamery Wyze są nadal przetwarzane w chmurze Wyze dla funkcji takich jak detekcja osób. Badanie pomiaru Apthorpe et al. (ACM 2019) badało 81 inteligentnych urządzeń domowych i stwierdziło, że 72 z nich kontaktowało się co najmniej z jednym punktem końcowym strony trzeciej poza dostawcą — a zaszyfrowany ruch nadal wycieka wzorce behawioralne. Wzmacnianie zmniejsza powierzchnię. Tego nie eliminuje.

Wzmacnianie konfiguracji Wyze zmniejsza promień wybuchu kompromisu. Nie zmienia faktu, że Twoje ramy wideo są przetwarzane w chmurze Wyze — to jest umowa, którą Wyze ci sprzedaje.

Wyze a Zigbee, Z-Wave i Matter — kiedy zachować Wyze, kiedy go zastąpić

Wyze została jasna na temat tego, gdzie się kieruje. Ich własna odpowiedź na forum o integracji Home Assistant mówi, że „skupiają wysiłki na MATTER." To mówi, gdzie przesuwa się krążek. Lokalne protokoły są przyszłością, na którą stawiają sami Wyze. Pytanie dla ciebie to, czy czekać na rollout Matter Wyze, czy migrować teraz.

Cztery protokoły do porównania:

  • Cloud API Wyze — to, co właśnie ustawiłeś
  • Zigbee 3.0 — lokalnie sieć, hub wymagany, bez zależności od chmury (CSA)
  • Z-Wave — lokalna sieć, hub wymagany, bez zależności od chmury
  • Matter 1.0 — oparte na IP, aplikacja z możliwościami lokalnymi, opcjonalna chmura (CSA)
KryteriumWyze (Cloud API)Zigbee 3.0Z-WaveMatter 1.0
Czas konfiguracji na urządzenie~5 min~3–5 min~3–5 min~2 min
Praca offlineNieTakTakTak
Hub wymaganyNie (HA + internet)Tak (~30–80 USD)Tak (~50 USD patyk)Nie
Koszt urządzenia wejściowego20–50 USD15–40 USD30–60 USD25–70 USD
Zależność niezawodnościWyze API + ISPLokalna siećLokalna siećLokalnie sieć IP
Postawa prywatnościHybrydowa (chmura)Całkowicie lokalnaCałkowicie lokalnaCałkowicie lokalna
Zamknięcie dostawcyWysokieNiskieNiskieBardzo niskie
Obsługa urządzeń WyzeWszystkie produkty WyzeBrakBrakCzęściowa; wdrażanie niekompletne

Kiedy Wyze + HA ma sens:

  • Już posiadasz urządzenia Wyze i chcesz ujednolicony pulpit szybko.
  • Urządzenia nie są krytyczne: oświetlenie nastroju, wtyczki podlewające rośliny, dodatkowe kamery do garażu.
  • Jesteś na wczesnym etapie podróży Home Assistant i chcesz szybki wynik zanim zobowiążesz się do koordynatora Zigbee.

Kiedy migrować lub uruchomić hybrydę:

  • Każde urządzenie zaangażowane w bezpieczeństwo fizyczne — zamki drzwi, alarmy wyzwalane ruchem, detekcja obecności wyzwalająca odblokowywanie drzwi.
  • Nieruchomości z niezawodnym ISP. Stawka awarii związanej z internetem 39% staje się Twoją codzienną rzeczywistością, a nie statystyką.
  • Wdrażania wielodostępniowe — hotele, wynajem, biura — gdzie dane urządzenia gościa nigdy nie powinny opuszczać właściwości.

Migracja nie musi być wszystko albo nic. Home Assistant z przyjemnością uruchamia ha-wyzeapi i koordynatora Zigbee (Sonoff ZBDongle-P lub podobny, około 30 USD) w tym samym czasie. Wspólny wzór: zamień Wyze Lock na zamek Zigbee (Aqara, Yale) w pierwszym roku. Zachowaj kamery Wyze dla monitorowania o niskim udziale. Stopniowo zamieniaj wtyczki Wyze na wtyczki Zigbee (Ikea Tradfri, ~10 USD każda), gdy oryginały zawodzą lub gdy automatyzacje rosną bardziej wymagające i chcesz rozszerzać się w automatyzację inteligentnej kuchni i urządzeń, która musi działać przez awarie ISP.

Jeśli postąpiłeś zgodnie z sekcjami konfiguracji, Twoje urządzenia Wyze znajdują się teraz w Home Assistant. Następna decyzja jest uczciwa i urządzenie po urządzeniu: które z Twoich automatyzacji są krytyczne dla bezpieczeństwa i dla każdej z nich, czy zaakceptowałbyś 39% szansę, że automatyzacja cicho zawiedzie podczas awarii ISP? Odpowiedzi — napisane, za każde urządzenie — są mapą drogi migracji. Jeśli chciałbyś, aby ten audyt został przeprowadzony formalnie dla mieszkania lub nieruchomości w Polsce, Set Smart Home go przeprowadza jako część bezpłatnej konsultacji: mapujemy Twoje obecne urządzenia Wyze na ich tryby awarii i proponujemy plan migracji Zigbee, Z-Wave lub Matter z harmonogramami i kosztami.