A conexão SSH é essencial para administrar servidores remotos, mas pode ser desconectada automaticamente devido a inatividade, configurações do servidor ou políticas de rede. Para evitar esse problema, é possível configurar um mecanismo de keep-alive, que mantém a conexão ativa enviando pacotes periódicos ao servidor.
1. Configurando Keep-Alive no Cliente SSH do Linux
O cliente SSH nativo do Linux permite configurar o keep-alive de duas formas: temporariamente, via linha de comando, ou permanentemente, no arquivo de configuração.
1.1 Configuração Temporária (Linha de Comando)
Se quiser ativar o keep-alive apenas para uma sessão específica, utilize o seguinte comando ao conectar:
ssh -o ServerAliveInterval=60 -o ServerAliveCountMax=3 usuario@servidor
Explicação dos parâmetros:
ServerAliveInterval=60– O cliente SSH enviará um pacote ao servidor a cada 60 segundos.ServerAliveCountMax=3– Se o servidor não responder após 3 tentativas, a conexão será encerrada.
Essa abordagem é útil para testar se o keep-alive funciona antes de aplicar a configuração permanente.
1.2 Configuração Permanente (Arquivo ssh_config)
Para manter a configuração em todas as conexões, edite o arquivo de configuração do cliente SSH:
sudo nano /etc/ssh/ssh_config
Ou, para configurações específicas do usuário:
nano ~/.ssh/config
Adicione as seguintes linhas ao arquivo:
Host *
ServerAliveInterval 60
ServerAliveCountMax 3
Explicação:
- O
Host *aplica a configuração a todos os hosts. - O
ServerAliveIntervaldefine o intervalo de envio dos pacotes keep-alive. - O
ServerAliveCountMaxdetermina quantas tentativas de keep-alive serão feitas antes de a conexão ser encerrada.
Após salvar o arquivo (CTRL + X, Y, ENTER no nano), a configuração entrará em vigor na próxima conexão SSH.
2. Configurando Keep-Alive no PuTTY (Windows)
O PuTTY, um cliente SSH popular no Windows, também pode ser configurado para enviar pacotes keep-alive.
2.1 Configuração no PuTTY
- Abra o PuTTY.
- No menu esquerdo, vá para Connection.
- No campo Seconds between keepalives (0 to turn off), digite
60. - Se desejar aplicar essa configuração sempre, volte ao menu principal do PuTTY e clique em Session.
- Selecione uma sessão salva ou insira o IP do servidor.
- Clique em Save para armazenar as configurações.
2.2 Salvando Configuração para Sessões Futuros
Se quiser garantir que todas as sessões usem o keep-alive sem precisar configurar manualmente a cada vez:
- Configure o keep-alive como explicado na seção anterior.
- Volte à tela Session.
- Digite um nome no campo Saved Sessions.
- Clique em Save.
Agora, sempre que carregar essa sessão, o PuTTY usará o keep-alive.
Configurar keep-alive no cliente SSH do Linux ou no PuTTY evita desconexões inesperadas ao manter a comunicação ativa com o servidor remoto. No Linux, o ServerAliveInterval é a principal opção, enquanto no PuTTY, basta definir o intervalo em segundos na interface gráfica.
Essas configurações são úteis para administradores de sistemas, desenvolvedores e qualquer pessoa que precise manter sessões SSH estáveis por longos períodos.
Configuração no Lado do Servidor (sshd_config) vs Cliente
O ServerAliveInterval configura o cliente SSH (sua máquina local enviando keep-alive para o servidor). Quando você deseja que o próprio servidor remoto feche sessões realmente zumbis ou mantenha NAT/firewalls ativos pelo outro lado, ajuste também /etc/ssh/sshd_config:
# /etc/ssh/sshd_config (lado do servidor)
ClientAliveInterval 60
ClientAliveCountMax 3
Com esses dois parâmetros, o daemon sshd envia pacotes criptografados dentro do canal SSH a cada 60 segundos se não houver dados trafegando. Se o cliente deixar de responder a 3 checagens seguidas (180 segundos), a sessão é encerrada de forma limpa sem deixar processos presos.
Boas Práticas: Multiplexing e Segurança com Keep-Alive
| Diretiva | Arquivo | Comportamento |
|---|---|---|
ServerAliveInterval 60 | ~/.ssh/config | Cliente envia sonda pelo túnel criptografado a cada 60s de inatividade |
ServerAliveCountMax 3 | ~/.ssh/config | Desconecta cliente se 3 sondas falharem (~3 min fora do ar) |
TCPKeepAlive yes | ~/.ssh/config | Sonda em nível TCP (pode sofrer spoof/timeout em proxies; combine com ServerAlive) |
ControlMaster auto | ~/.ssh/config | Reaproveita conexão SSH aberta e acelera novas abas/scp |
- Valide sempre antes de reiniciar o SSH remoto: rode
sudo sshd -t && sudo systemctl reload sshd(oussh) para evitar perda de acesso por erro de sintaxe. - Para sessões críticas e longas (upgrades ou compilações): nunca dependa apenas de keep-alive SSH; execute dentro de
tmuxouscreenno servidor remoto. Confira nosso guia completo do tmux no Linux.


