Ligue a Apple TV a um gateway UniFi

Quando utilizar esta configuração

Utilize esta configuração quando a Apple TV estiver fora de casa, por exemplo num alojamento de férias, e precisar de se ligar a casa através do seu gateway UniFi para aceder, pelo endereço, a serviços como um servidor multimédia.

Este guia não aborda o envio do tráfego da Apple TV, em casa, através de um cliente VPN no gateway. Essa configuração não precisa do WaveSocket.

Necessita de:

• uma Apple TV com a aplicação WaveSocket, que se liga com configurações WireGuard e não inclui um serviço VPN
• um UniFi Gateway ou UniFi Cloud Gateway com a aplicação UniFi Network
• um endereço IP público no gateway ou uma porta reencaminhada para ele por outro router situado entre o gateway e a Internet
• para a transferência, um telemóvel ou computador na mesma rede que a Apple TV

O UniFi Teleport é uma funcionalidade diferente. Usa convites na aplicação WiFiman da Ubiquiti, em vez de um ficheiro de configuração WireGuard.

Configure o servidor WireGuard

Estes passos seguem o artigo da Ubiquiti sobre o servidor VPN WireGuard.

1. No UniFi Network, abra Settings → VPN e crie um servidor VPN WireGuard. A porta predefinida é UDP 51820.
2. Se houver outro router entre o gateway e a Internet, reencaminhe nesse router a porta UDP 51820 para o endereço WAN do gateway. A Ubiquiti recomenda um gateway com acesso direto a um IP público.
3. Se o seu endereço público mudar, obtenha primeiro um nome de host num fornecedor de DNS dinâmico suportado pelo UniFi, como a Cloudflare ou o No-IP. Depois, crie uma entrada de DNS dinâmico em Settings → Internet para que os clientes possam usar esse nome de host. O DNS dinâmico da Ubiquiti requer um IP público no gateway. Atrás de outro router, use o DDNS desse router ou coloque-o em modo bridge para que o gateway receba o IP público.

Crie o cliente para a Apple TV

1. No servidor WireGuard, abra Clients → Add Client e introduza um nome como Apple TV.
2. Selecione Download Configuration File e mantenha o ficheiro privado.
3. Selecione Add e depois Apply Changes.

Crie um cliente separado para cada dispositivo. A Ubiquiti não documenta valores predefinidos fixos para Endpoint, AllowedIPs e DNS, por isso verifique-os no próprio ficheiro. Se Endpoint mostrar um endereço privado, por exemplo em 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 ou 100.64.0.0/10, ou mostrar o seu endereço IP público quando usa DNS dinâmico, substitua-o pelo seu endereço público ou nome de host DDNS antes de enviar o ficheiro e mantenha a porta. Depois de importar, também pode alterar Servidor em Editar perfil enquanto estiver desligado. Para AllowedIPs, consulte rotas e a sua rede doméstica.

Importe na Apple TV

1. Na Apple TV, abra o WaveSocket, escolha Perfis → Adicionar perfil VPN → Enviar pelo navegador e selecione Iniciar sessão de envio. Se houver uma VPN ligada, desligue-a primeiro.
2. Num telemóvel ou computador na mesma rede que a Apple TV, leia o código QR apresentado na TV ou abra o endereço indicado. Introduza o código apresentado na TV no campo Código de 4 dígitos.
3. Selecione Escolher ficheiro, indique o ficheiro .conf e selecione Enviar para a Apple TV.
4. A revisão na Apple TV mostra Servidor e IPs permitidos; verifique-os. Escolha Alterar nome para dar ao perfil um nome claro, como VPN Casa, e depois escolha Guardar perfil.

Utilize uma rede de confiança para a transferência. Se a Apple TV estiver numa rede partilhada, como o Wi-Fi de um alojamento de férias, importe o perfil em casa antes de levar a Apple TV para lá. O guia de importação explica porque é que a rede tem de ser de confiança.

Ligue-se e verifique

Ligue-se quando a Apple TV estiver numa rede fora de casa. A Ubiquiti refere que aceder ao endereço público a partir da sua rede doméstica pode falhar quando o gateway está atrás de outro router.

O WaveSocket seleciona o perfil guardado e abre Ligação. Escolha Ligar. Na primeira vez, permita que a Apple TV adicione a configuração VPN. Procure Servidor verificado e um valor recente junto a Idade do handshake mais antigo e, depois, abra um serviço doméstico conhecido através do respetivo endereço.

Se o endpoint for um nome de host DDNS, o WaveSocket resolve-o antes de ligar e volta a verificá-lo durante a ligação; consulte DNS e endereços de servidor.

Todas as funcionalidades do WaveSocket são gratuitas durante três minutos por ligação, pelo que pode experimentar a configuração antes de escolher o acesso vitalício do WaveSocket, que remove o limite de tempo.

Se a VPN não ligar

• Sem endereço público. Um endereço WAN em 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 ou 100.64.0.0/10 não é público. A Ubiquiti sugere pedir um IP público ao seu fornecedor de Internet ou usar o modo bridge no router do fornecedor para eliminar o NAT duplo.
• Teste feito em casa. Teste a partir de fora da sua rede doméstica; consulte o artigo da Ubiquiti sobre reencaminhamento de portas.
• Mesmo intervalo de endereços. Evite usar o mesmo intervalo de endereços privados em casa e na rede onde a Apple TV é utilizada.

Estes passos baseiam-se na documentação publicada pela Ubiquiti, consultada a 16 de outubro de 2026, e não em testes próprios do WaveSocket com o UniFi. Seguem o artigo da Ubiquiti sobre o servidor VPN WireGuard e, para os nomes das opções do cliente, o artigo sobre WireGuard site-to-site para o UniFi Mobile Router. Os nomes das opções no UniFi Network podem mudar; se isso acontecer, siga os artigos de ajuda atuais da Ubiquiti. UniFi é uma marca registada da Ubiquiti Inc. O WaveSocket é uma aplicação independente, não afiliada à Ubiquiti Inc. nem endossada por ela.