--- title: "Wake on LAN" description: "Wake-on-LAN Magic Packets per UDP senden, um schlafende PCs, NAS und Server aus TapHome-Automatisierungen aufzuwecken. Einrichtung mit IP und MAC-Adresse." url: "https://taphome.com/de/compatibility/wake-on-lan/" language: de lastmod: 2026-03-29 generator: hugo ai: topics: ["data-pp","other","udp","wake-on-lan","network-utility"] questions: ["Wie wecke ich einen PC aus TapHome mit Wake on LAN?","Wie richte ich Wake on LAN in TapHome ein?","Wie ist das Format des Wake on LAN Magic Packets?","Wie finde ich die MAC-Adresse für Wake on LAN?","Kann TapHome ein NAS oder einen Server ferngesteuert aufwecken?"] --- # Wake on LAN Kommunikation: Packet Parser → UDP > Netzwerkadresse > > TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung Wake on LAN (WoL) ist ein Netzwerkstandard, der es ermöglicht, ein schlafendes oder ausgeschaltetes Gerät durch eine spezielle Netzwerknachricht namens Magic Packet aufzuwecken. Das Protokoll wurde 1995 gemeinsam von AMD und Hewlett-Packard entwickelt und wird von praktisch allen modernen Ethernet-Netzwerkadaptern unterstützt. Das TapHome-Template sendet ein WoL Magic Packet über UDP an ein Zielgerät. Es stellt einen einzelnen Taster bereit — beim Drücken wird das Magic Packet zusammengestellt und an die konfigurierte IP-Adresse gesendet. Es handelt sich um ein reines Schreib-Template ohne Polling oder Rücklesen, da Wake on LAN ein unidirektionales Protokoll ohne Zustellbestätigung ist. ## Konfiguration Beim Template-Import fordert TapHome zwei Parameter an: | Parameter | Beschreibung | Beispiel | |-----------|-------------|----------| | IP-Adresse | Broadcast-Adresse des Zielnetzwerks | `192.168.0.255` | | MAC | MAC-Adresse des Zielgeräts (hex, durch Leerzeichen getrennt) | `12 34 56 78 9a bc` | Die IP-Adresse sollte typischerweise die **Subnetz-Broadcast-Adresse** sein (z. B. `192.168.0.255` für ein `/24`-Netzwerk), nicht die Unicast-IP des Zielgeräts. Da das Gerät ausgeschaltet ist, hat es keine aktive IP — das Magic Packet wird per Broadcast gesendet und der Ziel-Netzwerkadapter erkennt seine eigene MAC-Adresse im Paketinhalt. Die MAC-Adresse wird als Modulvariable gespeichert und zum Aufbau des Magic Packets verwendet. Sie muss im durch Leerzeichen getrennten Hex-Format eingegeben werden (z. B. `12 34 56 78 9a bc`). > [!WARNING] > Das Zielgerät muss Wake on LAN in den BIOS/UEFI-Einstellungen und am Netzwerkadapter aktiviert haben. Andernfalls wird das Magic Packet zwar gesendet, das Gerät wird aber nicht aufgeweckt. ### Vorbereitung des Zielgeräts Wake on LAN erfordert eine Konfiguration am Zielgerät, bevor es auf Magic Packets reagiert: 1. **BIOS/UEFI** — Wake on LAN aktivieren (typischerweise unter Power Management oder Network Boot) 2. **Betriebssystem** — WoL am Netzwerkadapter aktivieren: - Windows: Geräte-Manager > NIC-Eigenschaften > „Wake on Magic Packet" - Linux: `ethtool -s eth0 wol g` 3. **Stromversorgung** — der Netzwerkadapter muss im ausgeschalteten Zustand Standby-Strom erhalten WoL funktioniert aus den ACPI-Schlafzuständen S1 (Standby), S3 (Sleep), S4 (Hibernate) und S5 (Shutdown). Es funktioniert nicht aus dem Zustand G3 (Mechanical Off), bei dem der Netzwerkadapter keinen Strom erhält. ## Gerätefunktionen ### Wake-Taste Das Template stellt ein einzelnes Taster-Gerät bereit. Beim Drücken wird ein UDP-Paket mit dem WoL Magic Packet an die konfigurierte IP-Adresse auf Port 9999 gesendet. Das Magic Packet besteht aus 6 Bytes `FF` (Synchronisationsstrom), gefolgt von 16 Wiederholungen der Ziel-MAC-Adresse — insgesamt 102 Bytes. Es gibt kein Rücklesen und kein Status-Polling. Die Taste ist rein schreibend — sie löst den Paketversand aus und kehrt sofort zurück. Da WoL ein unidirektionales Protokoll ist, gibt es keine Bestätigung, dass das Zielgerät tatsächlich aufgeweckt wurde. ### Weitere Möglichkeiten Der WoL-Standard definiert auch eine SecureOn-Passwort-Funktion, bei der ein 4- oder 6-Byte-Passwort nach den MAC-Wiederholungen für zusätzliche Authentifizierung angehängt wird. Subnet-Directed Broadcast (Senden an eine bestimmte Subnetz-Broadcast-Adresse wie `192.168.1.255`) kann verwendet werden, um Geräte in anderen Subnetzen zu erreichen, wenn Router für die Weiterleitung von Directed Broadcasts konfiguriert sind. Diese Funktionen können in einem zukünftigen Template-Update hinzugefügt werden. ## Fehlerbehebung ### Gerät wacht nicht auf 1. Überprüfen Sie, ob Wake on LAN in den BIOS/UEFI-Einstellungen des Zielgeräts aktiviert ist 2. Überprüfen Sie, ob der Netzwerkadapter WoL auf Betriebssystemebene aktiviert hat 3. Bestätigen Sie, dass die MAC-Adresse in TapHome dem Ethernet-Adapter des Zielgeräts entspricht (nicht Wi-Fi) 4. Prüfen Sie, ob die IP-Adresse auf die korrekte Broadcast-Adresse für das Zielsubnetz eingestellt ist 5. Stellen Sie sicher, dass die Stromversorgung des Zielgeräts dem Netzwerkadapter Standby-Strom bereitstellt ### Wi-Fi-Geräte Wake on LAN ist für kabelgebundene Ethernet-Verbindungen ausgelegt. Die meisten Wi-Fi-Adapter halten im Energiesparmodus keine Verbindung aufrecht, sodass Standard-WoL-Magic-Packets sie nicht erreichen. Einige Geräte unterstützen Wake on Wireless LAN (WoWLAN), aber dies ist ein separater Standard, der möglicherweise eine andere Konfiguration erfordert. > [!NOTE] > Wake on LAN ist ein unidirektionales Protokoll — es gibt keinen eingebauten Mechanismus zur Bestätigung, ob das Zielgerät tatsächlich aufgeweckt wurde. Zur Überprüfung können Sie eine separate Netzwerk-Ping-Prüfung hinzufügen oder die Verfügbarkeit des Geräts über eine andere TapHome-Integration überwachen. ## Verfügbare Geräte 1 Diese Geräte erscheinen nach dem Import in TapHome. Wake on LAN Modul Benutzerdefinierte Variablen | | | |----------------|------------------------------------------------------------------------------------------| | `MAC` (string) | MAC-Adresse des Zielgeräts im leerzeichengetrennten Hex-Format (z. B. 12 34 56 78 9a bc) | Wake on LAN Taster Lesen und Schreiben Sendet ein Magic Packet zum Aufwecken eines schlafenden Netzwerkgeräts — zum Senden drücken, keine Statusrückmeldung action Tastenstatus schreiben ```taphome VAR magicPacket := BYTECOLLECTION("FF FF FF FF FF FF " + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC + MAC); SENDDATA(magicPacket); ``` **Verbindung:** Packet Parser → UDP Mögliche Verbesserungen (2) - SecureOn Password — Some NICs support a 6-byte SecureOn password appended after the 16x MAC repetitions for additional security - Subnet-Directed Broadcast — Template sends to a specific IP address; subnet-directed broadcast (e.g. 192.168.0.255) could reach devices whose IP is unknown after shutdown ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |----------------------|---------------------| | IP-Adresse | `192.168.0.1` | | MAC | `12 34 56 78 9a bc` | ## Quellen - Wake-on-LAN — Wikipedia [en.wikipedia.org](https://en.wikipedia.org/wiki/Wake-on-LAN) 2026-03-29 - WakeOnLAN — Wireshark Protocol Reference [wiki.wireshark.org](https://wiki.wireshark.org/WakeOnLAN) 2026-03-29 - Wake on LAN — Home Assistant Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/wake_on_lan/) 2026-03-29 - Wake on LAN — ManageEngine Technical Overview [www.manageengine.com](https://www.manageengine.com/products/oputils/tech-topics/what-is-wake-on-lan.html) 2026-03-29 ## Verwandte Dokumentation - [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/) - [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/) - [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)