Como aumentar o timeout de conexão SSH para evitar quedas em tarefas longas
Olá, amigo(a) desenvolvedor(a) ou administrador(a) de servidor! Se você já teve que executar uma tarefa no SSH — como um backup grande, uma atualização de sistema ou uma migração de dados — e a conexão caiu antes de terminar, é provável que o problema seja o timeout de conexão. Não se preocupe: com uma pequena configuração, você pode manter a sessão ativa por muito mais tempo.
Na GeHost, como estamos sempre aqui para te ajudar com carinho e clareza, vamos te mostrar como ajustar isso de forma simples, segura e eficaz. Vamos lá, meu aluno!
Por que o SSH cai durante tarefas longas?
Por padrão, o SSH (Secure Shell) fecha a conexão após um tempo sem atividade, para economizar recursos. Esse tempo é chamado de timeout. Se você estiver rodando um comando que leva mais tempo que esse limite, a conexão é interrompida — e tudo o que estava acontecendo é perdido.
Dica Sensei: Isso é comum em tarefas como:
• Backup de grandes bancos de dados
• Migração de arquivos grandes
• Instalação de pacotes pesados (ex: Composer, Node.js)
• Scripts de limpeza ou processamento em massa.
Como resolver: ajuste o timeout no cliente SSH
Na verdade, o timeout não é definido no servidor da GeHost — ele é controlado pelo seu computador (cliente SSH). Então, o ajuste vem de seu lado, e é bem simples!
Veja como fazer isso em diferentes sistemas:
Passo a passo (para Windows, macOS e Linux)
- Abra seu terminal ou cliente SSH (como PuTTY no Windows, Terminal no macOS/Linux).
- Conecte-se ao servidor com um parâmetro especial: Use o comando abaixo, substituindo
seu_usuario@seu_servidorpelos seus dados reais (não vamos exibir aqui por segurança). - Adicione os parâmetros de timeout ao comando de conexão:
ssh -o ServerAliveInterval=60 -o ServerAliveCountMax=10 seu_usuario@seu_servidorO que esses parâmetros significam?
ServerAliveInterval=60— envia um sinal de "estou vivo" a cada 60 segundos.ServerAliveCountMax=10— permite até 10 tentativas sem resposta antes de encerrar a conexão.
Com isso, mesmo que o servidor não responda imediatamente, a conexão não será fechada por timeout. Você pode ajustar os números conforme necessário — por exemplo, 120 segundos se precisar de mais tempo.
Se você usa o PuTTY (Windows)
Se você está no Windows com o PuTTY, não precisa de comando. Basta configurar no painel de conexão:
- Abra o PuTTY.
- No campo Host Name (or IP address), digite o endereço do seu servidor (não vamos exibir aqui).
- Vá em Connection → SSH → Keepalive.
- Marque Send TCP keepalives e defina o intervalo para 60 segundos.
- Salve a sessão (opcional, mas recomendado).
- Conecte-se normalmente.
Dica Sensei: Se você usa o PuTTY com frequência, salve a configuração como "GeHost Long Task" para não precisar configurar de novo.
Importante: O que NÃO fazer
Não tente mudar o timeout diretamente no servidor da GeHost. Isso não é possível nos planos de hospedagem cPanel — e nem deveria ser, por segurança. O controle está no seu lado, e é assim que deve ser.
Se você precisar de ajuda com o comando ou configuração, entre em contato com o suporte da GeHost — estamos aqui para te ajudar, com um sorriso e um café virtual. 🫶
Conclusão
Com apenas alguns ajustes simples no seu cliente SSH, você evita quedas chatas durante tarefas longas. É como dar um "pulo de qualidade" na sua produtividade!
Se esse guia te ajudou, compartilhe com outros devs que precisam. E lembre-se: você não está sozinho. A GeHost está aqui com você, a cada passo.
Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*