Como usar screen ou tmux para manter processos rodando após fechar o terminal SSH

Como usar screen ou tmux para manter processos rodando após fechar o terminal SSH

Olá, viajante do servidor! 👋 Se você já usou o SSH para conectar ao seu servidor GeHost e parou de trabalhar no meio de uma tarefa — como um script de backup, um servidor de desenvolvimento ou um processo de importação de dados — provavelmente já sentiu aquela frustração: "Ei, o que aconteceu com meu processo?"

Calma! A solução está em ferramentas como screen ou tmux. Elas são como um "colete de segurança" para seus processos no servidor: mesmo que você feche o terminal ou perca a conexão, o trabalho continua rodando.

Por que isso acontece?

Quando você executa um comando no terminal SSH, ele está ligado à sua sessão. Se você fecha o terminal, a sessão termina — e com ela, todos os processos que estavam rodando nela.

Com screen ou tmux, você cria uma sessão independente, como um "container" de trabalho que vive no servidor mesmo quando você não está conectado.

Passo a passo: Como usar screen (recomendado para iniciantes)

Vamos usar screen primeiro — é mais simples e perfeito para quem está começando.

1. Conecte-se ao seu servidor via SSH. Se você não sabe como fazer isso, consulte nosso guia “Como acessar o servidor via SSH” no painel da GeHost.

2. Verifique se o screen está instalado. Digite no terminal:

   screen -v

   Se aparecer uma versão, tudo certo! Se não, o sistema vai avisar. Não se preocupe — ele já vem instalado em todos os servidores GeHost.

3. Inicie uma nova sessão do screen. Digite:

   screen -S meu_processo

   Substitua meu_processo por um nome que lembre o que você está fazendo (ex: backup_site, server_node, importacao_dados). Isso ajuda a identificar a sessão depois.

4. Execute o comando que você quer manter rodando. Por exemplo:

   python3 meu_script.py

   Ou:

   npm run dev

   Seu processo começou! Ele está rodando dentro da sessão screen.

5. Para sair da sessão sem parar o processo, pressione:

   Ctrl + A, depois pressione D

   Isso "desconecta" a sessão, mas mantém o processo vivo no servidor. Você verá uma mensagem como:

   Detached from session meu_processo

   Pronto! Você pode fechar o terminal com segurança agora.

6. Quando quiser voltar a ver o que está acontecendo, digite:

   screen -r meu_processo

   Se tiver mais de uma sessão ativa, use:

   screen -ls

   para listar todas as sessões, e depois use screen -r [ID] para retomar.

Alternativa: tmux (para quem quer mais controle)

Se você gosta de ferramentas mais poderosas, o tmux é uma ótima escolha. Funciona de forma parecida, mas com mais recursos.

1. Inicie uma sessão:

   tmux new -s meu_processo

2. Execute seu comando.

3. Para "desconectar" sem parar: Ctrl + B, depois D.

4. Para voltar: tmux attach -t meu_processo.

5. Listar sessões: tmux ls.

Dicas do Sensei da GeHost

• Use nomes claros para suas sessões. Evite nomes como sessao1. Prefira algo como backup_2025 ou app_nodejs.

• Não use o terminal do cPanel para comandos longos. Ele é feito para tarefas rápidas. Use SSH mesmo.

• Se o processo for crítico, considere salvar a saída em um arquivo para depois verificar:

  python3 meu_script.py > log_saida.txt 2>&1

  Isso salva tanto a saída quanto os erros em um arquivo.

• Se precisar de ajuda, entre em contato com nosso suporte. Estamos aqui para te ajudar — mesmo que o processo tenha parado por um erro.

Imagem de apoio: Conexão via SSH no terminal

Antes de começar, certifique-se de que você está conectado ao servidor via SSH. O terminal deve mostrar algo como:

Seu processo está seguro no servidor. Você pode ir embora, dormir, tomar um café — e quando voltar, retome o trabalho onde parou. É assim que os mestres do servidor trabalham.

Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (entexp.com.br) — Raphael Neves Koga (desde 2015)*