Tuya LED-Strips lokal steuern mit Home Assistant & UniFi (Cloud-frei)

Günstige Smart-Home-Komponenten von Tuya (wie z.B. die MEGALIGHT LED-Strips) sind verlockend, haben aber einen Haken: Sie telefonieren ständig nach China. Wer seine Daten lieber zu Hause behält und keine Lust auf Cloud-Verzögerungen hat, kann diese Geräte auch Cloud-frei betreiben.

In diesem Tutorial zeige ich dir, wie du Tuya-Geräte in Home Assistant lokal einbindest und ihnen anschließend im UniFi-Netzwerk den Internetzugang sperrst.

Was wir vorhaben

1. Ersteinrichtung: Tuya-Geräte ins Wifi holen (hier wird die Cloud benötigt)
2. Local Key auslesen: Wir holen uns den digitalen Schlüssel des Geräts aus der Tuya-Cloud.
3. Home Assistant Integration: Wir nutzen »Tuya Local« via HACS.
4. Firewall-Sperre: Wir verbieten dem Gerät via Netzwerkeinstellungen (in meinem Fall UniFi Controller) das Internet.

Voraussetzungen

• Ein installiertes Home Assistant OS.
• HACS (Home Assistant Community Store) ist installiert.
• Ein Tuya-Gerät (bereits in der „Smart Life“ oder „Tuya“ App angelernt).
• Netzwerk-Zugriff (hier am Beispiel von UniFi Network, geht aber auch mit FritzBox & Co.).

Schritt 1: Die Erst-Einrichtung (Das Gerät ins WLAN bringen)

Bevor wir das Gerät befreien und lokal steuern können, muss es erst einmal wissen, wie dein WLAN heißt und sich verbinden. Das erledigen wir über den ganz offiziellen Weg.

1. App laden: Installiere dir die App »Smart Life« (empfohlen) oder »Tuya Smart« aus dem App Store / Play Store.
2. Kopplungs-Modus: Versetze deinen LED-Strip in den Anlern-Modus.
   • Meistens: Den Knopf am Controller ca. 5 Sekunden gedrückt halten, bis der Strip schnell blinkt.
   • Alternativ: Den Stromstecker 3x schnell hintereinander ein- und ausstecken (An-Aus-An-Aus-An).
3. Hinzufügen: Klicke in der App oben rechts auf das „+“ (Gerät hinzufügen). Die App findet blinkende Geräte oft automatisch (»Geräte werden gesucht…«). Falls nicht: Wähle manuell Beleuchtung > Lichtquelle (Wi-Fi).
4. WLAN-Daten: Gib dein WLAN-Passwort ein.
   • Wichtig: Tuya-Geräte funktionieren fast ausschließlich im 2,4 GHz WLAN. Achte darauf, dass dein Smartphone während der Einrichtung nicht im 5 GHz Netz ist, sonst schlägt die Verbindung oft fehl.
5. Test: Sobald das Gerät hinzugefügt ist, teste kurz, ob du es per App schalten kannst. Wenn ja, ist es erfolgreich im Netzwerk.

Pro-Tipp: Sollte die App dich direkt nach der Einrichtung zu einem Firmware-Update drängen -> Lehne es ab oder ignoriere es vorerst. Wir wollen den aktuellen, offenen Zustand nutzen. Updates kannst du später immer noch machen, falls nötig.

Schritt 2: Den »Local Key« besorgen (Der nervige Teil)

Um lokal mit dem Gerät zu sprechen, brauchen wir den Local Key. Den gibt uns die App leider nicht freiwillig. Wir müssen einen kleinen Umweg über das Entwickler-Portal gehen.

1. Gehe am PC auf iot.tuya.com und erstelle einen kostenlosen Developer-Account.
2. Klicke links auf Cloud > Development und dann auf Create Cloud Project.
   • Name: Egal (z.B. »HomeAssistant«).
   • Data Center: Wähle zwingend Central Europe.
   • Development Method: Smart Home.
3. Im neuen Projekt gehst du auf den Reiter Devices > Link Tuya App Account.
4. Klicke auf Add App Account und scanne den QR-Code mit deiner Smart Life / Tuya App (Profil > Scan-Symbol oben rechts).
5. Bestätige den Zugriff auf dem Handy.

Jetzt ist dein Account verknüpft. Um den Key final zu sehen:

1. Kopiere dir unter Devices die Device ID deines LED-Strips.

2. Gehe links im Menü auf Cloud > API Explorer.

3. Wähle: Smart Home Device System > Device Management > Query Device Details.

4. Füge deine ID ein und klicke „Submit Request“.
5. Rechts im Code-Fenster findest du nun den Eintrag "local_key": "DEIN_KEY". Notiere den für später. Ich hab gleich 15 SmartLight RGB Strips eingerichtet. Ich hab alles in einem Tabellenblatt notiert.

Schritt 3: Einbindung in Home Assistant

Wir nutzen die Integration Tuya Local (Empfehlung: die Version vom Entwickler make-all), da sie zuverlässiger laufen soll, als das ältere »LocalTuya«.

1. Öffne HACS in Home Assistant.
2. Suche nach Tuya Local und installiere es.
3. Starte Home Assistant neu.
4. Gehe zu Einstellungen > Geräte & Dienste > Integration hinzufügen und wähle Tuya Local.
5. Wähle bei der Einrichtung »Manual« (Manuell).
6. Trage die Daten ein:
   • Device ID: (Aus Schritt 2)
   • Local Key: (Aus Schritt 2)
   • IP Host: Die IP-Adresse des Geräts in deinem Netzwerk.

7. Wähle im nächsten Schritt den Gerätetyp (bei LED-Strips meistens »Light« oder ein passendes RGB-Preset).

Tipp: Teste jetzt kurz, ob du das Licht über Home Assistant steuern kannst. Wenn ja: Weiter zu Schritt 4.

Schritt 4: Internet sperren mit UniFi (Der »Kill Switch«)

Jetzt machen wir das Gerät cloud-frei. Da Home Assistant nun lokal mit dem Strip spricht, braucht der Strip kein Internet mehr. Ich mache das hier exemplarisch mit Unify, aber das geht natürlich auch mit anderen Netzwerk-Komponenten.

A) Statische IP vergeben (Wichtig!)

Damit Home Assistant den Strip immer findet, darf sich dessen IP-Adresse nicht ändern.

1. Öffne dein UniFi Network Dashboard.
2. Gehe zu Client Devices und suche den Strip.
3. Klicke auf das Gerät > Settings > IP Settings.
4. Aktiviere Fixed IP Address und speichere (»Apply Changes«).

B) Traffic Rule erstellen

Jetzt drehen wir den Hahn zu.

1. Gehe zu Settings > Security > Traffic Rules (oder im neuen Interface direkt beim Client).
2. Erstelle eine neue Regel (Create Entry):
   • Action: Block
   • Category: Internet
   • Target: Wähle deinen LED-Strip aus (z.B. UG-SR-LED-02 ...).
   • Schedule: Always
3. Speichern.

Fazit

Herzlichen Glückwunsch! Dein LED-Strip ist jetzt ein lokaler Bürger deines Netzwerks.

• Datenschutz: Keine Daten gehen mehr nach China.
• Geschwindigkeit: Die Steuerung reagiert sofort, ohne Cloud-Roundtrip.
• Zuverlässigkeit: Das Licht lässt sich auch steuern, wenn das Internet mal ausfällt.

Troubleshooting: Sollte der Strip nach der Sperre alle paar Minuten kurz »nicht verfügbar« sein, versucht er panisch, die Cloud zu erreichen und startet neu. In diesem Fall hilft es oft, statt »Traffic Block« nur »Domain Name Blocking« für die Tuya-Server zu aktivieren, aber bei 90% der Geräte funktioniert die Komplettsperre problemlos.

Der erste Strip beleuchtet übrigens erstmal den Serverschrank. Jetzt könnte man über Automationen nachdenken, die Temperatur oder Stromverbrauch farblich visualisieren :)

---

Wenn dir das Projekt gefallen hat und du von weiteren interessanten Projekten inspiriert werden willst, sieh dir doch mal mein neues E-Book »Arduino Projekte Volume 1« an!

• Die beliebtesten Arduino-Projekte von StartHardware
• Inklusive Schaltplan, Beschreibung und Code
• Arduino-Schnellstart-Kapitel
• Kompakter Programmierkurs

Jetzt ansehen!

---