Comandos para diagnosticar o Tailscale
Antes de começar
Consulte estado, endereço, versão e caminho de conexão do Tailscale. Use os comandos de diagnóstico para localizar a falha antes de alterar configurações.
- Cliente Tailscale instalado com CLI disponível.
- Nome ou endereço do par que você pretende investigar.
Em telas pequenas, role as tabelas para o lado para consultar todas as colunas.
Comece pelos comandos de consulta. Eles ajudam a identificar o dispositivo, o caminho e a versão antes de qualquer mudança na configuração.
Estado e identidade
tailscale statustailscale ip -4tailscale versionCompare o endereço e o nome com a ficha da máquina no painel administrativo. Para automação, consulte tailscale status –json. Leia os campos JSON conforme a versão da CLI. A posição das linhas da saída de texto pode variar.
Caminho e rede
tailscale ping nome-do-destinotailscale netcheckSubstitua o nome pelo destino real. O primeiro comando mostra o caminho entre pares. O segundo consulta características da conectividade local. Nenhum dos dois comprova que uma aplicação específica está atendendo na porta esperada.
Estado dos serviços publicados
tailscale serve statustailscale funnel statusLeia o alcance informado e o destino do proxy. Compare a porta local com a configuração da aplicação. Não execute reset apenas para consultar: ele remove configuração.
Escolha o comando pela informação necessária
| Comando | Consulta | Limite da interpretação |
|---|---|---|
| tailscale version | Versão deste cliente | Não informa a versão de todos os pares |
| tailscale ip -4 | IPv4 deste dispositivo | Não é o IP público de saída |
| tailscale status | Estado e pares conhecidos | Não comprova que uma aplicação responde |
| tailscale ping DESTINO | Caminho até o par indicado | Não valida o login no serviço |
| tailscale netcheck | Condições da rede local | Não é teste de velocidade da aplicação |
Execute os comandos no ambiente correspondente. No Docker, consulte dentro do container. No WSL, identifique se você está no Windows ou na distribuição. Misturar essas saídas pode fazer dois clientes diferentes parecerem um único dispositivo com comportamento instável.
Para automatizar a leitura de status, consulte a opção JSON documentada para a versão instalada. Trate a ausência de um par ou de um campo como situação prevista pelo programa, em vez de presumir que toda consulta terá o mesmo conteúdo. Guarde apenas as informações necessárias ao diagnóstico.
Referência da versão instalada
tailscale --helptailscale set --helptailscale serve --helpA referência local acompanha a versão instalada. Consulte-a antes de copiar opções de um guia antigo. Para compartilhar um diagnóstico, inclua versão, sistema, operação esperada e mensagem recebida, retirando identificadores privados e qualquer segredo.
Confira o resultado
Você reúne versão, estado e caminho do par, distingue essas consultas do teste da aplicação e retira informações privadas dos registros compartilhados.
Fontes e conferência
Procedimento revisado a partir da documentação oficial em 2 de novembro de 2026. Não executado em uma tailnet de laboratório nesta edição.
