Connetti Apple TV a un gateway UniFi

Quando usare questa configurazione

Usa questa configurazione quando Apple TV si trova fuori casa, per esempio in una casa vacanze, e deve riconnettersi attraverso il tuo gateway UniFi per raggiungere servizi come un media server tramite il suo indirizzo.

Questa guida non tratta il caso in cui, a casa, il traffico di Apple TV passa attraverso un client VPN sul gateway. Quella configurazione non richiede WaveSocket.

Ti servono:

• un Apple TV con l’app WaveSocket, che si connette con configurazioni WireGuard e non include un servizio VPN
• un UniFi Gateway o un UniFi Cloud Gateway con l’applicazione UniFi Network
• un indirizzo IP pubblico sul gateway, oppure una porta inoltrata al gateway da un altro router posto tra il gateway e Internet
• un telefono o un computer sulla stessa rete di Apple TV per il trasferimento

UniFi Teleport è una funzione diversa. Si basa su inviti nell’app WiFiman di Ubiquiti anziché su un file di configurazione WireGuard.

Configura il server WireGuard

Questi passaggi seguono l’articolo di Ubiquiti sul server VPN WireGuard.

1. In UniFi Network, apri Settings → VPN e crea un server VPN WireGuard. La porta predefinita è UDP 51820.
2. Se tra il gateway e Internet c’è un altro router, inoltra su quel router la porta UDP 51820 verso l’indirizzo WAN del gateway. Ubiquiti consiglia un gateway con accesso diretto a un IP pubblico.
3. Se il tuo indirizzo pubblico cambia, ottieni prima un nome host da un provider di Dynamic DNS supportato da UniFi, come Cloudflare o No-IP. Poi crea una voce Dynamic DNS in Settings → Internet, così i client possono usare il nome host. Il Dynamic DNS di Ubiquiti richiede un IP pubblico sul gateway. Dietro un altro router, usa il DDNS di quel router oppure mettilo in modalità bridge, così il gateway ottiene l’IP pubblico.

Crea il client per Apple TV

1. Nel server WireGuard, apri Clients → Add Client e inserisci un nome come Apple TV.
2. Seleziona Download Configuration File e mantieni il file privato.
3. Seleziona Add, poi Apply Changes.

Crea un client separato per ogni dispositivo. Ubiquiti non documenta valori predefiniti fissi per Endpoint, AllowedIPs e DNS, quindi controllali nel file stesso. Se Endpoint mostra un indirizzo privato, come uno in 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 o 100.64.0.0/10, oppure mostra il tuo indirizzo IP pubblico mentre usi il Dynamic DNS, sostituiscilo con il tuo indirizzo pubblico o con il nome host DDNS prima di inviare il file, e mantieni la porta. Dopo l’importazione puoi anche modificare Server in Modifica profilo mentre sei disconnesso. Per AllowedIPs, consulta Percorsi e rete domestica.

Importa su Apple TV

1. Su Apple TV, apri WaveSocket e scegli Profili → Aggiungi profilo VPN → Invia dal browser, quindi seleziona Avvia sessione di invio. Se è connessa una VPN, disconnettiti prima.
2. Su un telefono o un computer sulla stessa rete di Apple TV, scansiona il codice QR sulla TV o apri l’indirizzo visualizzato. Inserisci il codice mostrato sulla TV nel campo Codice a 4 cifre.
3. Seleziona Scegli file, indica il file .conf e seleziona Invia ad Apple TV.
4. La revisione su Apple TV mostra Server e IP consentiti: controllali. Scegli Rinomina per dare al profilo un nome chiaro, come VPN Casa, quindi scegli Salva profilo.

Usa una rete affidabile per il trasferimento. Se Apple TV si trova su una rete condivisa, come il Wi-Fi di una casa vacanze, importa il profilo a casa prima di portare lì Apple TV. La guida all’importazione spiega perché la rete deve essere affidabile.

Connettiti e controlla

Connettiti quando Apple TV si trova su una rete fuori casa. Ubiquiti fa notare che raggiungere l’indirizzo pubblico dall’interno della rete domestica può non riuscire se il gateway si trova dietro un altro router.

WaveSocket seleziona il profilo salvato e apre Connessione. Scegli Connetti. La prima volta, consenti ad Apple TV di aggiungere la configurazione VPN. Controlla che compaiano Server verificato e un tempo recente accanto a Età dell’handshake più vecchio, poi apri un servizio di casa noto tramite il suo indirizzo.

Se l’endpoint è un nome host DDNS, WaveSocket lo risolve prima di connettersi e lo controlla di nuovo durante la connessione; consulta DNS e indirizzi del server.

Tutte le funzionalità di WaveSocket sono gratuite per tre minuti a connessione, così puoi provare la configurazione prima di scegliere l’accesso a vita di WaveSocket, che rimuove il limite di tempo.

Se non si connette

• Nessun indirizzo pubblico. Un indirizzo WAN in 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 o 100.64.0.0/10 non è pubblico. Ubiquiti suggerisce di chiedere al tuo provider Internet un IP pubblico, oppure di usare la modalità bridge sul router del provider per eliminare il doppio NAT.
• Test da casa. Esegui il test dall’esterno della rete domestica; consulta l’articolo di Ubiquiti sul port forwarding.
• Stesso intervallo di indirizzi. Evita di usare lo stesso intervallo di indirizzi privati a casa e sulla rete in cui usi Apple TV.

Questi passaggi si basano sulla documentazione pubblicata da Ubiquiti, verificata il 16 ottobre 2026, e non su test propri di WaveSocket con UniFi. Seguono il suo articolo sul server VPN WireGuard e, per le etichette del client, il suo articolo su WireGuard site-to-site per UniFi Mobile Router. Le etichette in UniFi Network possono cambiare; in tal caso, segui gli articoli di assistenza aggiornati di Ubiquiti. UniFi è un marchio registrato di Ubiquiti Inc. WaveSocket è un’app indipendente, non affiliata a Ubiquiti Inc. né approvata da Ubiquiti Inc.