Como configurar um cron job no VPS fora do cPanel usando crontab direto no terminal

Como configurar um cron job no VPS fora do cPanel usando crontab direto no terminal

Olá, viajante da tecnologia! Seja bem-vindo ao seu novo guia de confiança da GeHost, onde aprendemos juntos com paciência e calor humano. Hoje vamos mergulhar no mundo dos crontabs — sim, aquele "cronometro" do servidor que faz tarefas automáticas sem precisar de você estar lá.

Se você tem um VPS (servidor virtual) na GeHost e quer automatizar algo — como limpar logs, atualizar dados ou rodar um script — sem depender do cPanel, este guia é para você. Vamos fazer isso diretamente no terminal, com segurança e clareza.

Sensei diz: "O terminal é o coração do servidor. Quando você o entende, ele te responde com precisão."

Antes de começar: verifique se seu plano permite acesso SSH

Para usar o terminal diretamente no VPS, você precisa ter acesso via SSH. Isso está disponível em planos VPS da GeHost — mas confira no seu painel (painel.gehost.com.br) se esse recurso está ativo no seu servidor.

Se não tiver certeza, entre no painel, vá em Seu Servidor e verifique se há opções como "Acesso SSH" ou "Terminal". Se não aparecer, entre em contato com nosso suporte — e vamos resolver juntos.

Passo a passo: configurar um cron job via terminal

1. Conecte-se ao seu VPS via SSH

   Abra seu terminal (Linux/Mac) ou use o Putty (Windows). Conecte-se com os dados fornecidos pelo painel da GeHost:

   • Host: seu servidor (ex: vps.gehost.com.br)
   • Porta: 22 (padrão)
   • Usuário: root ou o usuário criado (ex: geuser)
   • Senha: a senha do servidor

   Exemplo de comando no terminal:

   ssh root@vps.gehost.com.br

   Depois de digitar sua senha, você estará dentro do servidor.

2. Abra o crontab do usuário

   Para editar os cron jobs do usuário atual, digite:

   crontab -e

   Se estiver usando o usuário root, use:

   sudo crontab -e

   Se for a primeira vez, o sistema pode pedir para escolher um editor. Escolha nano (mais simples) ou vim (mais poderoso). Para o leigo, recomendamos nano.

3. Entenda a estrutura do cron job

   Um cron job tem 5 campos separados por espaços, seguidos do comando que será executado:

       * * * * * comando_a_executar
       | | | | | 
       | | | | +--- Dia da semana (0-7, onde 0 e 7 são domingo)
       | | | +----- Mês (1-12)
       | | +------- Dia do mês (1-31)
       | +--------- Hora (0-23)
       +----------- Minuto (0-59)
       

   Exemplo: 0 2 * * * /home/geuser/limpa_logs.sh — executa o script às 02:00 todos os dias.

4. Adicione seu cron job

   Na tela do editor (como nano), digite uma linha com o cron job. Por exemplo:

   0 3 * * * /home/geuser/backup_db.sh

   Isso executa o script backup_db.sh às 03:00 todos os dias.

   ⚠️ Dica importante: o caminho do script precisa ser completo. Use pwd no terminal para ver o diretório atual, ou ls para listar arquivos.

5. Salve e saia

   Se estiver usando nano:

   • Pressione Ctrl + O (para salvar)
   • Pressione Enter para confirmar o nome do arquivo
   • Pressione Ctrl + X para sair

   O sistema já salva automaticamente o crontab.

6. Verifique se o cron job foi salvo

   Para ver todos os cron jobs do usuário, digite:

   crontab -l

   Se aparecer a linha que você escreveu, está tudo certo!

Exemplo prático: rodar um script diário

Suponha que você tenha um script chamado limpa_cache.php no diretório /home/geuser/scripts/. Quer rodar ele todos os dias às 01:00?

Use este comando no crontab:

0 1 * * * /usr/bin/php /home/geuser/scripts/limpa_cache.php

Isso diz: "Execute o PHP com o script de limpeza às 01:00 todos os dias".

Sensei diz: "Cada linha no crontab é uma promessa ao servidor. Cumpra-a com precisão."

Erros comuns (e como evitar)

• Comando não encontrado: Verifique se o caminho do script ou do comando (como php, python) está certo. Use which php para descobrir.
• Não roda no horário certo: Verifique se o servidor está com a hora correta. Use date no terminal.
• Permissão negada: Certifique-se de que o script tem permissão de execução. Use chmod +x nome_do_script.sh.

Quer ver se está funcionando?

Depois de configurar, espere o horário marcado e verifique os logs. Se o script gera um arquivo de saída, veja se ele foi criado. Exemplo:

tail -f /home/geuser/logs/backup.log

Isso mostra as últimas linhas do arquivo de log em tempo real.

Pronto! Você está no controle

Parabéns, amigo! Você agora sabe como configurar um cron job diretamente no terminal, sem depender do cPanel. É um passo importante no caminho de quem quer dominar seu servidor.

Se tiver dúvidas, não hesite em nos procurar. Estamos aqui, com um sorriso e um café no terminal. 🫶

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