Connecter l’Apple TV à une passerelle UniFi

Quand utiliser cette configuration

Utilisez cette configuration lorsque l’Apple TV se trouve loin de chez vous, par exemple dans une location de vacances, et doit se connecter à distance en passant par votre passerelle UniFi pour accéder par leur adresse à des services, comme un serveur multimédia.

Ce guide ne traite pas du cas où, chez vous, le trafic de l’Apple TV passe par un client VPN installé sur la passerelle. Cette configuration ne nécessite pas WaveSocket.

Il vous faut :

• un Apple TV doté de l’application WaveSocket, qui se connecte avec des configurations WireGuard et n’inclut aucun service VPN
• une UniFi Gateway ou une UniFi Cloud Gateway avec l’application UniFi Network
• une adresse IP publique sur la passerelle, ou un port redirigé vers elle par un autre routeur situé entre la passerelle et Internet
• un téléphone ou un ordinateur connecté au même réseau que l’Apple TV pour le transfert

UniFi Teleport est une fonctionnalité différente. Elle utilise des invitations dans l’application WiFiman d’Ubiquiti plutôt qu’un fichier de configuration WireGuard.

Configurer le serveur WireGuard

Ces étapes suivent l’article d’Ubiquiti sur le serveur VPN WireGuard.

1. Dans UniFi Network, ouvrez Settings → VPN et créez un serveur VPN WireGuard. Le port par défaut est UDP 51820.
2. Si un autre routeur se trouve entre la passerelle et Internet, redirigez le port UDP 51820 de ce routeur vers l’adresse WAN de la passerelle. Ubiquiti recommande une passerelle disposant d’un accès direct à une IP publique.
3. Si votre adresse publique change, obtenez d’abord un nom d’hôte auprès d’un fournisseur de DNS dynamique pris en charge par UniFi, comme Cloudflare ou No-IP. Créez ensuite une entrée de DNS dynamique dans Settings → Internet pour que les clients puissent utiliser ce nom d’hôte. Le DNS dynamique d’Ubiquiti nécessite une IP publique sur la passerelle. Derrière un autre routeur, utilisez le DDNS de ce routeur, ou passez ce routeur en mode pont pour que la passerelle obtienne l’IP publique.

Créer le client Apple TV

1. Dans le serveur WireGuard, ouvrez Clients → Add Client et saisissez un nom comme Apple TV.
2. Sélectionnez Download Configuration File et gardez le fichier confidentiel.
3. Sélectionnez Add, puis Apply Changes.

Créez un client distinct pour chaque appareil. Ubiquiti ne documente pas de valeurs par défaut fixes pour Endpoint, AllowedIPs et DNS : vérifiez-les donc dans le fichier lui-même. Si Endpoint indique une adresse privée, par exemple dans 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 ou 100.64.0.0/10, ou votre adresse IP publique alors que vous utilisez un DNS dynamique, remplacez-la par votre adresse publique ou votre nom d’hôte DDNS avant d’envoyer le fichier, en conservant le port. Après l’importation, vous pouvez aussi modifier Serveur dans Modifier le profil lorsque vous êtes déconnecté. Pour AllowedIPs, voir les routes et votre réseau domestique.

Importer sur Apple TV

1. Sur Apple TV, ouvrez WaveSocket et choisissez Profils → Ajouter un profil VPN → Envoyer depuis le navigateur, puis sélectionnez Lancer une session d’envoi. Si un VPN est connecté, déconnectez-le d’abord.
2. Sur un téléphone ou un ordinateur connecté au même réseau que l’Apple TV, scannez le code QR du téléviseur ou ouvrez l’adresse affichée. Saisissez le code affiché sur le téléviseur dans le champ Code à 4 chiffres.
3. Sélectionnez Choisir un fichier, choisissez le fichier .conf, puis sélectionnez Envoyer à Apple TV.
4. L’écran de vérification sur Apple TV affiche Serveur et IP autorisées ; contrôlez ces valeurs. Choisissez Renommer pour donner au profil un nom clair, par exemple VPN Domicile, puis choisissez Enregistrer le profil.

Utilisez un réseau de confiance pour le transfert. Si l’Apple TV est connecté à un réseau partagé, comme le Wi-Fi d’une location de vacances, importez le profil chez vous avant de l’y emporter. Le guide d’importation explique pourquoi ce réseau doit être de confiance.

Se connecter et vérifier

Connectez-vous lorsque l’Apple TV se trouve sur un réseau hors de chez vous. Ubiquiti signale que, derrière un autre routeur, l’accès à l’adresse publique depuis votre réseau domestique peut échouer.

WaveSocket sélectionne le profil enregistré et ouvre Connexion. Choisissez Se connecter. La première fois, autorisez l’Apple TV à ajouter la configuration VPN. Vérifiez que Serveur validé s’affiche, avec une valeur récente à côté de la mention Âge de la négociation la plus ancienne, puis ouvrez un service connu de votre réseau domestique à son adresse.

Si le point de terminaison est un nom d’hôte DDNS, WaveSocket le résout avant de se connecter et le vérifie à nouveau pendant la connexion ; voir DNS et adresses des serveurs.

Toutes les fonctionnalités de WaveSocket sont gratuites pendant trois minutes par connexion : vous pouvez ainsi essayer cette configuration avant de choisir l’accès à vie de WaveSocket, qui supprime la limite de temps.

Si la connexion échoue

• Pas d’adresse publique. Une adresse WAN comprise dans 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 ou 100.64.0.0/10 n’est pas publique. Ubiquiti suggère de demander une IP publique à votre fournisseur d’accès à Internet, ou d’utiliser le mode pont sur le routeur du fournisseur pour supprimer le double NAT.
• Test depuis chez vous. Testez depuis l’extérieur de votre réseau domestique ; voir l’article d’Ubiquiti sur la redirection de port.
• Même plage d’adresses. Évitez d’utiliser la même plage d’adresses privées chez vous et sur le réseau où l’Apple TV est utilisé.

Ces étapes s’appuient sur la documentation publiée par Ubiquiti, vérifiée le 16 octobre 2026, et non sur des tests effectués par WaveSocket avec UniFi. Elles suivent son article sur le serveur VPN WireGuard et, pour les libellés du client, son article sur WireGuard site à site pour l’UniFi Mobile Router. Les libellés d’UniFi Network peuvent changer ; le cas échéant, suivez les articles d’aide actuels d’Ubiquiti. UniFi est une marque déposée d’Ubiquiti Inc. WaveSocket est une application indépendante, qui n’est ni affiliée à Ubiquiti Inc. ni approuvée par Ubiquiti Inc.