\nIn deze handleiding leg ik uit hoe je een Raspberry Pi instelt als Tailscale\u2011subnetrouter, zodat een externe locatie veilig toegang krijgt tot een Home Assistant\u2011installatie op een andere plek.
\nDeze setup is gebaseerd op een echte situatie tussen twee locaties: Thuis en vakantie adres.\n<\/p>\n
\nInstalleer Raspberry Pi OS Lite (64\u2011bit) met Raspberry Pi Imager. Schakel SSH in, stel een hostname in en configureer WiFi indien nodig.
\nInstalleer het OS direct op een SSD voor maximale stabiliteit.\n<\/p>\n
sudo apt update\nsudo apt upgrade -y\n<\/code><\/pre>\n
\n2. Tailscale installeren<\/h2>\n
Tailscale maakt een veilige VPN\u2011verbinding tussen apparaten zonder ingewikkelde firewall\u2011instellingen.<\/p>\n
Installeren:<\/p>\n
curl -fsSL https:\/\/tailscale.com\/install.sh | sh\n<\/code><\/pre>\nStarten en aanmelden:<\/p>\n
sudo tailscale up\n<\/code><\/pre>\nStatus controleren:<\/p>\n
tailscale status\n<\/code><\/pre>\nJe ziet nu een 100.x.x.x<\/strong> Tailscale\u2011IP.<\/p>\n
\n3. Subnet Router inschakelen<\/h2>\n
Een subnetrouter zorgt ervoor dat apparaten op locatie A apparaten op locatie B kunnen bereiken.<\/p>\n
IP\u2011forwarding inschakelen<\/h3>\n
Tijdelijk:<\/p>\n
sudo sysctl -w net.ipv4.ip_forward=1\n<\/code><\/pre>\nPermanent:<\/p>\n
sudo nano \/etc\/sysctl.conf\nnet.ipv4.ip_forward=1\n<\/code><\/pre>\nReboot de Pi.<\/p>\n
LAN\u2011routes adverteren<\/h3>\n
Voorbeeld LAN: 192.168.86.0\/24<\/strong><\/p>\nsudo tailscale up --advertise-routes=192.168.86.0\/24\n<\/code><\/pre>\nGa naar de Tailscale\u2011adminconsole en keur de route goed.<\/p>\n
Nu werkt de Pi als subnetrouter<\/strong>.<\/p>\n
\n4. Waarom HA Voice niet werkt via Tailscale<\/h2>\n
\nOp de externe locatie kan de PC Home Assistant bereiken via Tailscale, maar HA Voice niet.\n<\/p>\n
HA Voice kan w\u00e9l:<\/h3>\n\n- Lokale LAN\u2011IP\u2019s bereiken<\/li>\n
- Publieke internet\u2011URL\u2019s bereiken<\/li>\n<\/ul>\n
HA Voice kan niet:<\/h3>\n\n- Tailscale\u2011IP\u2019s bereiken<\/li>\n
- LAN\u2011IP\u2019s van een ander netwerk<\/li>\n
- Subnetroutes gebruiken<\/li>\n<\/ul>\n
\nDaarom werkt een adres zoals:\n<\/p>\n
http:\/\/100.x.x.x:8123\/api\/esphome\/...\n<\/code><\/pre>\n\nwel op de PC, maar niet op HA Voice.\n<\/p>\n
\n5. Oplossing: gebruik de externe URL van Home Assistant<\/h2>\n
\nHA Voice werkt overal als Home Assistant een publieke URL heeft, bijvoorbeeld:\n<\/p>\n
https:\/\/extern_url.nl<\/strong><\/p>\nInstellen in Home Assistant:<\/p>\n
Instellingen \u2192 Systeem \u2192 Netwerk \u2192 Home Assistant URL\u2019s<\/strong><\/p>\nInternal URL: http:\/\/192.168.86.85:8123\nExternal URL: https:\/\/extern_url.nl\n<\/code><\/pre>\nNu werkt HA Voice vanaf elke locatie.<\/p>\n
\n6. Music Assistant correct instellen<\/h2>\n
\n<\/p>\n
Heb je een Home Assistant Voice Preview Edition (Voice PE)<\/strong> op een externe locatie staan (bijvoorbeeld op een vakantieadres of kantoor) en wil je hierop muziek streamen vanaf je Music Assistant-server thuis?<\/p>\nAls je probeert te streamen over een VPN, loop je vaak tegen een bekend probleem aan: de stream loopt op je scherm, maar je hoort pure stilte. Dit komt omdat de Voice PE de audio-URL rechtstreeks via het lokale IP-adres van je thuisnetwerk probeert op te halen, en dat netwerk kent hij niet.<\/p>\n
Omdat je op een ESPHome-apparaat zoals de Voice PE geen Tailscale kunt installeren, lossen we dit op met een slimme netwerktruc via een lokale Raspberry Pi. In deze blog leg ik je stap voor stap uit hoe je dit inricht, zonder dat je thuisspeakers stoppen met werken!<\/strong><\/p>\n
\nDe Opstelling<\/h2>\n\n- Thuislocatie:<\/strong> Home Assistant-server met de Music Assistant add-on actief.<\/li>\n
- Externe locatie:<\/strong> Een Raspberry Pi met Tailscale (ingesteld met een subnet router) \u00e9n de Home Assistant Voice PE.<\/li>\n<\/ul>\n
\nStap 1: IP Forwarding aanzetten op de externe Raspberry Pi<\/h2>\n
Om de Raspberry Pi te veranderen in een slimme doorgeefsluis voor netwerkverkeer, moeten we eerst IP Forwarding inschakelen in Linux.<\/p>\n
Log in via SSH op de externe Raspberry Pi en voer het volgende commando uit:<\/p>\n
sudo sysctl -w net.ipv4.ip_forward=1<\/code><\/pre>\nOm te zorgen dat deze instelling ook na een stroomuitval of herstart actief blijft, zetten we hem permanent vast in de configuratie:<\/p>\n
echo \"net.ipv4.ip_forward = 1\" | sudo tee -a \/etc\/sysctl.conf<\/code><\/pre>\nStap 2: NAT\/Masquerade instellen via iptables<\/h2>\n
We gaan nu de ingebouwde firewall (iptables<\/code>) van de Raspberry Pi vertellen dat hij netwerkverkeer van de Voice PE moet accepteren en moet vermommen (masqueraden) over de Tailscale-tunnel (tailscale0<\/code>).<\/p>\nControleer eerst met ip link<\/code> of jouw bekabelde netwerkkaart inderdaad eth0<\/code> heet (vervang dit door wlan0<\/code> als je Pi op wifi werkt). Voer daarna deze drie commando’s uit:<\/p>\nsudo iptables -t nat -A POSTROUTING -o tailscale0 -j MASQUERADE\nsudo iptables -A FORWARD -i eth0 -o tailscale0 -j ACCEPT\nsudo iptables -A FORWARD -i tailscale0 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT<\/code><\/pre>\nStap 3: De Voice PE rechtstreeks naar de Pi sturen (De Gateway-truc)<\/h2>\n
Normaal gesproken stuurt de Voice PE al zijn internetverkeer naar de standaard internetrouter van de externe locatie. Die router snapt niets van jouw thuis-IP (bijv. 192.168.86.85<\/code>) en gooit het verkeer weg.<\/p>\nWe omzeilen de router volledig door de Raspberry Pi in te stellen als de ‘gateway’ van de Voice PE. Open de ESPHome YAML-configuratie<\/strong> van je Voice PE en pas het wifi:<\/code> gedeelte aan met een handmatig IP-blok:<\/p>\nwifi:\n ssid: \"Je_Wifi_Naam_Externe_Locatie\"\n password: \"Je_Wifi_Wachtwoord\"\n \n manual_ip:\n static_ip: 192.168.1.150 # Een vrij IP-adres voor je Voice PE\n subnet: 255.255.255.0 # Het subnet van de externe locatie\n gateway: 192.168.1.23 # BELANGRIJK: Vul hier het lokale IP van je externe Raspberry Pi in!\n dns: 1.1.1.1 <\/code><\/pre>\nKlik op Install<\/strong> in ESPHome om de nieuwe firmware naar de Voice PE te flashen.<\/p>\nStap 4: De netwerkregels permanent maken op de Pi<\/h2>\n
Linux wist handmatig ingevoerde iptables<\/code>-regels zodra het apparaat herstart. Om te zorgen dat alles blijft werken na een stroomstoring, installeren we een hulpprogramma dat de regels automatisch opslaat en inlaadt:<\/p>\nsudo apt-get update && sudo apt-get install iptables-persistent -y<\/code><\/pre>\nTijdens de installatie verschijnt er een blauw scherm. Kies hier twee keer voor YES<\/strong> om de huidige IPv4-instellingen op te slaan.<\/p>\n
\nHet Resultaat<\/h2>\n
Herstart de Raspberry Pi eenmalig via sudo reboot<\/code> om te testen.<\/p>\nZodra alles weer online is, gebeurt het volgende:<\/p>\n
\n- Je start een stream in Music Assistant thuis naar de externe Voice PE.<\/li>\n
- De Voice PE krijgt de opdracht de audio op te halen bij jouw thuis-IP (
192.168.86.x<\/code>).<\/li>\n- De Voice PE stuurt dit verzoek naar zijn gateway: de externe Raspberry Pi.<\/li>\n
- De Pi pakt de data op, schiet het door de beveiligde Tailscale-tunnel<\/strong>, en de muziek begint direct lossless te spelen!<\/li>\n<\/ol>\n
Omdat we de instellingen binnen Music Assistant zelf niet hebben hoeven aanpassen, blijven al je slimme speakers thuis ook gewoon perfect werken. Veel luisterplezier!<\/p>\n
\n8. Conclusie<\/h2>\n
\nMet een Raspberry Pi als Tailscale\u2011subnetrouter kun je veilig toegang krijgen tot Home Assistant vanaf een externe locatie.
\nHA Voice werkt alleen via een externe URL, en Music Assistant werkt nu met de ip table aanpassingen in de rpi.
\nAls je de instellingen voor music assistant hebt doorgevoerd, kan de interne url in HA ook weer op het interne ip adres gezet worden.
\nDit is ideaal voor vakantiehuizen, bedrijfspanden en tweede woningen.\n<\/p>\n
<\/div>\n