Use Tailscale no Windows com WSL 2

A documentação do Tailscale recomenda executar o cliente no Windows quando você usa WSL 2. Manter outro túnel dentro da distribuição pode causar problemas de tamanho de pacote quando o tráfego passa pelos dois clientes. Comece pelo host Windows e confira seu acesso antes de instalar outro cliente.

Confira a distribuição

No PowerShell, consulte a versão do WSL usada por cada distribuição:

1
wsl -l -v

A coluna VERSION precisa indicar 2 para o procedimento descrito aqui. Para instalar o WSL, siga primeiro a documentação da Microsoft indicada nas fontes.

Conecte o Windows à tailnet

Siga a instalação no Windows e autentique o aplicativo. No PowerShell, confira o estado e teste outro dispositivo:

1
tailscale status
2
tailscale ping nome-do-destino

Substitua nome-do-destino pelo nome de uma máquina da sua tailnet. Depois, teste o serviço real que pretende usar. O ping confirma o caminho do Tailscale, mas a aplicação ainda depende da porta, da autenticação e das permissões.

Separe a conexão do host e o serviço Linux

Um serviço dentro do WSL possui endereço de escuta e configuração próprios. O cliente conectado no Windows não confirma, sozinho, que uma aplicação Linux está disponível para outras máquinas. Confira primeiro a aplicação a partir do próprio Windows e depois configure sua exposição conforme o modo de rede do WSL utilizado.

Se o acesso funciona pelo IP, mas falha pelo nome, confira o DNS do ambiente Linux antes de instalar outro cliente. Use o diagnóstico de DNS para comparar a resposta pelo endereço IP e pelo nome.

Localize o processo que precisa responder

Antes de alterar a rede, registre onde a aplicação foi iniciada. Um servidor aberto no terminal da distribuição pertence ao Linux. A lista de dispositivos exibida pelo cliente Windows não comprova que esse processo aceita conexões externas.

Dentro da distribuição, consulte as portas em escuta:

1
ss -lnt

O endereço de escuta importa. Um processo limitado a 127.0.0.1 recebe conexões pelo loopback daquele ambiente. O acesso a partir do Windows e de outra máquina depende também do modo de rede do WSL e das permissões do host. Não altere a escuta para todas as interfaces antes de definir o alcance desejado.

Faça a investigação por partes: primeiro abra o serviço no ambiente que o executa. Depois teste pelo Windows. Por último use outro dispositivo da tailnet. Se apenas o último teste falhar, confira encaminhamento e firewall. Um segundo cliente Linux não deve ser instalado apenas para tentar corrigir uma aplicação parada.

Quando você precisa de uma identidade Linux separada

A instalação dentro do WSL 2 é uma alternativa avançada documentada pelo fabricante. Faça essa configuração somente após revisar o caminho de rede e a limitação dos túneis sobrepostos. Instale o pacote Linux pelo procedimento oficial da distribuição e autentique com:

1
sudo tailscale up

Identifique a máquina como WSL no painel para diferenciá-la do host. Confira o estado dentro do Linux e registre qual cliente está ativo durante o teste. Para voltar ao uso somente no Windows, desconecte o cliente Linux com sudo tailscale down e repita a conferência no host.