WireGuard-server op UniFi voor Apple TV

Wanneer deze opstelling geschikt is

Gebruik deze opstelling als Apple TV niet thuis is, bijvoorbeeld in een vakantiewoning, en via uw UniFi-gateway verbinding moet maken met uw thuisnetwerk om diensten zoals een mediaserver op hun adres te bereiken.

Deze handleiding behandelt niet hoe u het verkeer van Apple TV thuis via een VPN-client op de gateway stuurt. Voor die opstelling is WaveSocket niet nodig.

U heeft nodig:

een Apple TV met de WaveSocket-app, die verbinding maakt met WireGuard-configuraties en geen VPN-dienst bevat
een UniFi Gateway of UniFi Cloud Gateway met de UniFi Network-applicatie
een openbaar IP-adres op de gateway, of een poort die een andere router tussen de gateway en internet naar de gateway doorstuurt
voor de overdracht een telefoon of computer op hetzelfde netwerk als Apple TV

UniFi Teleport is een andere functie. Die werkt met uitnodigingen in de WiFiman-app van Ubiquiti in plaats van met een WireGuard-configuratiebestand.

Stel de WireGuard-server in

Deze stappen volgen het artikel van Ubiquiti over de WireGuard-VPN-server.

Open in UniFi Network Settings → VPN en maak een WireGuard-VPN-server aan. De standaardpoort is UDP 51820.
Zit er een andere router tussen de gateway en internet, stuur dan op die router UDP-poort 51820 door naar het WAN-adres van de gateway. Ubiquiti raadt een gateway aan met directe toegang tot een openbaar IP-adres.
Als uw openbare adres verandert, vraag dan eerst een hostnaam aan bij een Dynamic DNS-provider die UniFi ondersteunt, zoals Cloudflare of No-IP. Maak daarna in Settings → Internet een Dynamic DNS-item aan, zodat clients de hostnaam kunnen gebruiken. Dynamic DNS van Ubiquiti vereist een openbaar IP-adres op de gateway. Achter een andere router gebruikt u de DDNS van die router, of zet u die router in bridgemodus, zodat de gateway het openbare IP-adres krijgt.

Maak de Apple TV-client aan

Open in de WireGuard-server Clients → Add Client en voer een naam in, zoals Apple TV.
Selecteer Download Configuration File en houd het bestand privé.
Selecteer Add en daarna Apply Changes.

Maak voor elk apparaat een aparte client aan. Ubiquiti documenteert geen vaste standaardwaarden voor Endpoint, AllowedIPs en DNS, dus controleer ze in het bestand zelf. Toont Endpoint een privéadres, zoals een adres in 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 of 100.64.0.0/10, of uw openbare IP-adres terwijl u Dynamic DNS gebruikt, vervang het dan door uw openbare adres of DDNS-hostnaam voordat u het bestand verstuurt, en behoud de poort. Na het importeren kunt u Server ook wijzigen in Bewerk profiel terwijl de verbinding verbroken is. Zie voor AllowedIPs routes en uw thuisnetwerk.

Importeer op Apple TV

Open WaveSocket op Apple TV, kies Profielen → Voeg VPN-profiel toe → Upload vanuit browser en selecteer daarna Start uploadsessie. Als er een VPN verbonden is, verbreek dan eerst de verbinding.
Scan op een telefoon of computer op hetzelfde netwerk als Apple TV de QR-code op de tv of open het getoonde adres. Voer de code die op de tv staat in het veld Viercijferige code in.
Selecteer met Kies bestand het .conf-bestand en selecteer daarna Verstuur naar Apple TV.
Het controlescherm op Apple TV toont Server en Toegestane IP’s; controleer ze. Kies Hernoem om het profiel een duidelijke naam te geven, zoals Thuis-VPN, en kies daarna Bewaar profiel.

Gebruik een vertrouwd netwerk voor de overdracht. Gebruikt Apple TV een gedeeld netwerk, zoals de wifi van een vakantiewoning, importeer het profiel dan thuis voordat u Apple TV daarheen meeneemt. De importhandleiding legt uit waarom het netwerk vertrouwd moet zijn.

Maak verbinding en controleer

Maak verbinding wanneer Apple TV op een netwerk buitenshuis zit. Ubiquiti merkt op dat het bereiken van het openbare adres vanuit uw thuisnetwerk kan mislukken achter een andere router.

WaveSocket selecteert het opgeslagen profiel en opent Verbinding. Kies Verbind. Sta de eerste keer toe dat Apple TV de VPN-configuratie toevoegt. Kijk of Server geverifieerd verschijnt en naast Leeftijd van oudste peer-handshake een recent tijdstip staat, en open daarna een bekende dienst thuis via het adres ervan.

Met een DDNS-hostnaam als eindpunt zet WaveSocket die hostnaam om voordat er verbinding wordt gemaakt en controleert hem opnieuw terwijl er verbinding is; zie DNS en serveradressen.

Elke functie van WaveSocket is drie minuten per verbinding gratis, zodat u de opstelling kunt uitproberen voordat u kiest voor de levenslange toegang van WaveSocket, waarmee de tijdslimiet vervalt.

Als er geen verbinding komt

Geen openbaar adres. Een WAN-adres in 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 of 100.64.0.0/10 is niet openbaar. Ubiquiti stelt voor uw internetprovider om een openbaar IP-adres te vragen, of de router van de provider in bridgemodus te zetten om dubbele NAT weg te nemen.
Thuis testen. Test van buiten uw thuisnetwerk; zie het artikel van Ubiquiti over port forwarding.
Hetzelfde adresbereik. Gebruik thuis niet hetzelfde privéadresbereik als op het netwerk waar Apple TV wordt gebruikt.

Deze stappen zijn gebaseerd op de gepubliceerde documentatie van Ubiquiti zoals gecontroleerd op 16 oktober 2026, niet op eigen tests van WaveSocket met UniFi. Ze volgen het artikel van Ubiquiti over de WireGuard-VPN-server en, voor de clientlabels, het artikel over site-to-site WireGuard voor de UniFi Mobile Router. Labels in UniFi Network kunnen veranderen; volg in dat geval de actuele helpartikelen van Ubiquiti. UniFi is een geregistreerd handelsmerk van Ubiquiti Inc. WaveSocket is een onafhankelijke app en is niet gelieerd aan of goedgekeurd door Ubiquiti Inc.