Ir para o conteúdo
Promovaweb

Comandos para diagnosticar o Tailscale

Revisado em

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

Terminal
tailscale status
tailscale ip -4
tailscale version

Compare 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

Terminal
tailscale ping nome-do-destino
tailscale netcheck

Substitua 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

Terminal
tailscale serve status
tailscale funnel status

Leia 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

Terminal
tailscale --help
tailscale set --help
tailscale serve --help

A 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.