Ir para o conteúdo
Promovaweb

Recupere um dispositivo com chave expirada

Revisado em

Antes de começar

Confira a expiração da chave do dispositivo no Tailscale e renove a autenticação por um acesso alternativo, preservando a administração do servidor remoto.

  • Identificação do dispositivo e confirmação da expiração no painel.
  • Console local ou do provedor disponível antes da reautenticação.
  • Identidade autorizada e registro das preferências de rede do cliente.

Sintomas

  • O painel mostra chave expirada.
  • O cliente solicita novo login.

Uma chave de dispositivo expirada pode interromper conexões da tailnet. A chave utilizada para registrar o dispositivo e a chave que mantém sua identidade não têm o mesmo ciclo de validade.

Confirme a expiração

Abra Machines e consulte a ficha do dispositivo. Confira o aviso de expiração e o usuário ou a tag associados. Verifique também se o cliente solicita autenticação.

Se a máquina é remota, abra o console do provedor ou outro acesso independente da tailnet antes de iniciar a renovação.

Confirme qual credencial precisa de renovação

Uma auth key autoriza o cadastro inicial. A chave do dispositivo autentica o cliente já registrado. A chave SSH convencional pertence a outro mecanismo de autenticação. Verifique a mensagem e o painel antes de gerar qualquer credencial nova.

No console do dispositivo, registre o estado disponível:

Terminal
tailscale status
tailscale ip -4

O cliente pode informar que precisa autenticar novamente. Faça essa recuperação pelo acesso alternativo descrito anteriormente. Reautenticar pela única sessão remota pode interromper justamente a conexão necessária para completar o procedimento.

Após o login, confira nome, identidade e tags no painel. Compare também o endereço com seu registro anterior. Se aparecer uma máquina adicional, investigue se o estado local foi removido ou se outro ambiente foi autenticado, como um container recém-criado.

Retome cada função utilizada pelo dispositivo: SSH, Serve, sub-redes ou saída de internet. A presença no painel comprova o cadastro, mas deixa essas funções sem teste. Ajustar a política de expiração exige considerar como o servidor será mantido e recuperado.

Reautentique pelo acesso alternativo

No aplicativo, siga o fluxo de login solicitado. Em um cliente com CLI, a documentação prevê tailscale up –force-reauth, com sudo quando necessário.

Esse comando pode interromper a conexão da tailnet. Não o execute pela única sessão SSH ou RDP que permite administrar o destino. Confira também as preferências existentes, pois up pode exigir que opções anteriores sejam reapresentadas.

Confira a nova conexão

Depois do login, confira a máquina no painel e abra uma nova conexão a partir do seu computador. Teste a aplicação utilizada antes da expiração, incluindo rotas se o dispositivo funciona como roteador.

Se a conexão não retornar, confira a tailnet selecionada e a aprovação do dispositivo. Não cadastre sucessivas cópias da máquina sem entender o estado atual.

Prepare a manutenção

Registre a configuração de expiração dos servidores e acompanhe os avisos. Dispositivos com tags têm comportamento próprio, que deve ser conferido após a autenticação.

Desativar expiração é uma escolha de administração para um dispositivo específico. Considere a rotina de atualização, remoção e controle de acesso antes de aplicá-la a todos os servidores.

Confira o resultado

O dispositivo autentica novamente, mantém a identidade esperada e retoma os serviços e rotas usados antes da expiração.

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.