Ir para o conteúdo
Promovaweb

O que é Tailscale e como a tailnet funciona

Revisado em

O Tailscale coloca seus dispositivos numa rede privada chamada tailnet. Cada aparelho entra com uma identidade, recebe um endereço próprio e conversa com os outros por túneis WireGuard, mesmo quando cada um está numa conexão de internet diferente.

Em telas pequenas, role as tabelas para o lado para consultar todas as colunas.

Os clientes de uma tailnet usam WireGuard para conversar diretamente ou por relay. O serviço de coordenação informa como localizar os pares. Com dois aparelhos pessoais autenticados pela mesma identidade, você também pode transferir arquivos pelo Taildrop.

Os exemplos usam comandos da CLI do Linux e telas do painel administrativo. Eles mostram o comportamento de cada peça. A instalação em cada sistema fica na página de instalação do Tailscale.

A tailnet, o cliente e o caminho do tráfego

O Tailscale cria uma rede privada entre dispositivos autorizados. Você instala o cliente, faz login e usa o endereço Tailscale do destino para abrir um serviço, como SSH ou uma aplicação web.

Os componentes da tailnet

A tailnet reúne usuários, dispositivos e permissões. O cliente usa WireGuard para proteger o tráfego entre os dispositivos. O serviço de coordenação informa aos clientes como localizar os pares, mas o caminho do tráfego pode ser direto ou passar por um relay.

Um endereço da tailnet identifica o dispositivo nessa rede. Ele não substitui a porta da aplicação. Quando o seu servidor web escuta na porta 3000, você ainda precisa informar essa porta ou configurar um proxy.

O recurso certo para cada destino

Um exemplo de uso é acessar, pelo notebook de casa, um painel administrativo instalado na VPS. Com o Tailscale nos dois, você tem um caminho privado até o servidor. O painel ainda precisa estar em execução e aceitar conexões pela interface utilizada. Seu login no painel continua sendo uma etapa da aplicação.

Você pretende acessar Recurso a consultar
Outro dispositivo com Tailscale Conexão entre os dois clientes
Um equipamento da LAN sem cliente Subnet router
Um serviço web dentro da tailnet Serve
Um serviço web pela internet Funnel
A internet pela conexão de outra máquina Exit node

Esses usos têm alcances diferentes. Antes de configurar uma rota ou publicar uma URL, escreva qual dispositivo inicia a conexão e qual serviço deve responder. Essa descrição serve depois para limitar as permissões, porque instalar o cliente, por si só, não define quais portas cada usuário deve acessar.

Conexão e aplicação são camadas diferentes

Um dispositivo aparecer conectado não comprova que uma aplicação esteja funcionando. Para acessar SSH, por exemplo, o destino precisa ter um servidor SSH ativo, um usuário válido e permissões de rede para a porta utilizada.

A instalação também não transforma automaticamente a máquina em exit node. O acesso à internet continua pelo caminho habitual até você configurar e selecionar esse recurso.

Dois dispositivos na mesma tailnet

O menor exemplo de tailnet tem dois aparelhos sob sua administração, como um notebook e um celular. O computador serve de ponto de consulta e o celular permite conferir o acesso fora do Wi-Fi de casa. Rotas de rede e saída de internet ficam para depois, porque o primeiro resultado a observar é a comunicação entre os dois dispositivos.

Instalação e autenticação nos dois aparelhos

O cliente de cada sistema sai da página oficial de downloads. No celular, o aplicativo vem da loja indicada no site oficial. Os dois aparelhos entram com a mesma identidade. O celular solicita a aceitação da configuração de VPN do sistema.

Na página Machines do painel administrativo aparecem os dois nomes. A ficha de cada aparelho mostra usuário, sistema e endereço. Quando a tailnet exige aprovação de dispositivos, um administrador aprova a entrada antes do uso.

Ao participar de mais de uma tailnet, confira a seleção em cada cliente. Dois dispositivos autenticados em redes diferentes não entram automaticamente na mesma rede privada.

Endereços e o primeiro teste

No computador com CLI disponível, estes comandos mostram o estado do cliente:

Terminal
tailscale status
tailscale ip -4

O primeiro comando lista os pares conhecidos. O segundo informa o endereço IPv4 do computador atual. O endereço do celular aparece no aplicativo ou no painel. O teste usa o nome do aparelho:

Terminal
tailscale ping nome-do-celular

Uma resposta de tailscale ping informa que o cliente encontrou um caminho até o outro dispositivo. A indicação de relay não invalida esse teste: o tráfego pode seguir por uma retransmissão quando o caminho direto ainda não foi estabelecido. Anote o nome consultado para não confundir o seu celular com outro aparelho da tailnet.

Quando nenhum par aparece, a primeira conferência é a identidade usada no login e a tailnet selecionada. Um aparelho desconectado precisa do aplicativo aberto e conectado nele mesmo. Uma aprovação pendente se resolve no painel.

O teste fora do Wi-Fi

Com o Wi-Fi do celular desligado e a conexão móvel e o Tailscale ativos, um serviço que você já tenha no computador abre pelo endereço Tailscale e pela porta correta. O teste do caminho Tailscale não substitui o teste da aplicação. Um ping respondido pode coexistir com uma porta fechada ou um serviço parado. Nesse caso, o processo no destino é o próximo ponto a conferir, antes de qualquer mudança nas permissões da tailnet.

Para um exemplo com aplicação web, o Serve gera uma URL que o celular abre pela tailnet. O endereço localhost no navegador do celular aponta para o próprio celular e não identifica o computador. Desconectar o aplicativo depois do teste não remove o cadastro do aparelho.

Taildrop para arquivos entre seus aparelhos

O Taildrop transfere arquivos entre dispositivos pessoais autenticados com a mesma identidade. Na documentação consultada, o recurso está em alpha e precisa ser habilitado na tailnet. Dispositivos de outro usuário e máquinas identificadas por tags ficam fora desse uso.

Ativação e dispositivos aceitos

No painel administrativo, a opção Send Files fica em Settings, General. Os dois aplicativos precisam estar conectados à mesma tailnet e pertencer ao mesmo usuário. No Linux, tailscale status mostra os nomes disponíveis como destino.

Um arquivo pequeno no primeiro envio permite conferir a chegada antes de transferir uma pasta compactada ou outro arquivo maior. O nome notebook nos comandos abaixo é um exemplo e deve ser trocado pelo nome do seu destino.

Envio e recebimento pelo terminal

O comando de envio recebe o caminho do arquivo e um destino terminado por dois-pontos:

Terminal
tailscale file cp ./documento.pdf notebook:

Nos aplicativos gráficos, o envio sai pela opção de arquivos do Tailscale ou pelo menu de compartilhamento do sistema. No macOS, a extensão de compartilhamento precisa estar ativa nas configurações do sistema antes do primeiro envio.

No Linux de destino, o arquivo fica numa fila até ser retirado para uma pasta existente:

Terminal
mkdir -p ~/Recebidos-Taildrop
tailscale file get ~/Recebidos-Taildrop

Conferência do arquivo recebido

O envio concluído e a abertura do arquivo são verificações diferentes. No Linux, o arquivo pode estar aguardando retirada pela CLI. Por isso, a pasta passada ao comando de recebimento e suas permissões são a primeira conferência antes de enviar o mesmo documento novamente.

Para arquivos técnicos, o SHA-256 calculado nas duas máquinas Linux mostra se o conteúdo chegou igual:

Terminal
sha256sum ./documento.pdf
sha256sum ~/Recebidos-Taildrop/documento.pdf

O primeiro comando roda na origem e o segundo no destino. As sequências precisam ser iguais, porque nomes iguais não comprovam que o conteúdo permaneceu o mesmo. Se os hashes diferirem, preserve o original e confira qual arquivo foi selecionado em cada máquina antes de repetir a transferência.

A transferência não executa o arquivo nem garante que ele abra em qualquer aplicativo, já que o formato precisa ser compatível com o programa instalado no destino. O Taildrop também não é um procedimento de backup.

Quando o destino não aparece

A conexão, a identidade e a ausência de tags nos dois dispositivos explicam a maior parte dos casos. O Taildrop tem autorização própria para transferências entre seus dispositivos e pode funcionar mesmo quando a política restringe outros acessos. Para enviar arquivos a outro usuário, escolha um serviço com autenticação e permissões apropriadas, como SFTP sobre SSH convencional.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.