Recupere um dispositivo com chave expirada
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:
tailscale statustailscale ip -4O 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.
