Conecte o Apple TV a um gateway UniFi

Quando usar esta configuração

Use esta configuração quando o Apple TV estiver longe de casa, por exemplo em um imóvel de temporada, e precisar se conectar de volta pelo seu gateway UniFi para acessar serviços, como um servidor de mídia, pelo endereço deles.

Este guia não trata de enviar o tráfego do Apple TV, em casa, por um cliente VPN no gateway. Esse tipo de configuração não precisa do WaveSocket.

Você precisa de:

• um Apple TV com o aplicativo WaveSocket, que se conecta usando configurações WireGuard e não inclui um serviço VPN
• um UniFi Gateway ou UniFi Cloud Gateway com o aplicativo UniFi Network
• um endereço IP público no gateway ou uma porta encaminhada até ele por outro roteador entre o gateway e a Internet
• um telefone ou computador na mesma rede do Apple TV para a transferência

O UniFi Teleport é um recurso diferente. Ele usa convites no aplicativo WiFiman da Ubiquiti em vez de um arquivo de configuração WireGuard.

Configure o servidor WireGuard

Estas etapas 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 padrão é UDP 51820.
2. Se houver outro roteador entre o gateway e a Internet, encaminhe nesse roteador 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, primeiro obtenha um nome de host com um provedor de DNS dinâmico compatível com o UniFi, como Cloudflare ou No-IP. Depois, crie uma entrada de DNS dinâmico em Settings → Internet para que os clientes possam usar o nome de host. O DNS dinâmico da Ubiquiti exige um IP público no gateway. Atrás de outro roteador, use o DDNS desse roteador ou coloque esse roteador em modo bridge para que o gateway receba o IP público.

Crie o cliente do Apple TV

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

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

Importe no Apple TV

1. No Apple TV, abra o WaveSocket, escolha Perfis → Adicionar perfil VPN → Enviar pelo navegador e selecione Iniciar sessão de envio. Se houver uma VPN conectada, desconecte-a primeiro.
2. Em um telefone ou computador na mesma rede do Apple TV, escaneie o código QR exibido na TV ou abra o endereço mostrado. Digite o código exibido na TV no campo Código de 4 dígitos.
3. Use Escolher arquivo para selecionar o arquivo .conf e depois selecione Enviar ao Apple TV.
4. A revisão no Apple TV mostra Servidor e IPs permitidos; confira os dois. Escolha Renomear para dar ao perfil um nome claro, como VPN Casa, e depois escolha Salvar perfil.

Use uma rede confiável para a transferência. Se o Apple TV for usado em uma rede compartilhada, como o Wi-Fi de um imóvel de temporada, importe o perfil em casa antes de levar o Apple TV para lá. O guia de importação explica por que a rede precisa ser confiável.

Conecte-se e verifique

Conecte-se quando o Apple TV estiver em uma rede fora da sua casa. A Ubiquiti observa que acessar o endereço público de dentro da sua rede doméstica pode falhar atrás de outro roteador.

O WaveSocket seleciona o perfil salvo e abre Conexão. Escolha Conectar. Na primeira vez, permita que o Apple TV adicione a configuração VPN. Procure Servidor verificado e um tempo recente ao lado de Idade do handshake mais antigo e, depois, abra um serviço doméstico conhecido pelo endereço dele.

Quando o endpoint é um nome de host DDNS, o WaveSocket o resolve antes de conectar e volta a verificá-lo durante a conexão; consulte DNS e endereços de servidor.

Todos os recursos do WaveSocket são grátis por três minutos a cada conexão, então você pode experimentar a configuração antes de escolher o acesso vitalício do WaveSocket, que remove o limite de tempo.

Se não conectar

• 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 provedor de Internet ou usar o modo bridge no roteador do provedor para eliminar o NAT duplo.
• Teste feito de casa. Faça o teste de fora da sua rede doméstica; consulte o artigo da Ubiquiti sobre encaminhamento de portas.
• Mesmo intervalo de endereços. Evite usar o mesmo intervalo de endereços privados em casa e na rede em que o Apple TV é usado.

Estas etapas se baseiam na documentação publicada pela Ubiquiti, conferida em 16 de outubro de 2026, e não em testes do próprio WaveSocket com o UniFi. Elas seguem o artigo da Ubiquiti sobre o servidor VPN WireGuard e, para os rótulos do cliente, o artigo sobre WireGuard site a site para o UniFi Mobile Router. Os rótulos no UniFi Network podem mudar; se isso acontecer, siga os artigos de ajuda atuais da Ubiquiti. UniFi é uma marca registrada da Ubiquiti Inc. O WaveSocket é um aplicativo independente e não é afiliado ou endossado pela Ubiquiti Inc.