Como Executar Scripts Remotamente via SSH
Olá! 👋 Aqui é a Sensei da GeHost. Você vai aprender como se conectar ao seu servidor via SSH e executar scripts de forma segura e profissional. Pode parecer complexo à primeira vista, mas vou te guiar passo a passo. Vamos nessa!
O que é SSH?
SSH (Secure Shell) é como um "telecomando seguro" do seu servidor. Ao invés de usar a interface web do cPanel, você acessa a linha de comando (terminal) do seu servidor de forma criptografada. Isso permite executar tarefas mais avançadas, rodar scripts automáticos, gerenciar arquivos rapidamente e muito mais.
Por que usar SSH? Porque é mais rápido, mais seguro e oferece controle total. Perfeito para tarefas que a interface web não consegue fazer.
Pré-requisitos
Antes de começar, verifique se você tem:
- SSH ativado na sua conta (vem ativado por padrão — se não tiver, abra um ticket).
- Um cliente SSH no seu computador:
- Mac/Linux: Terminal nativo (já vem instalado)
- Windows: PuTTY, MobaXterm ou WSL (Windows Subsystem for Linux)
- Suas credenciais de acesso SSH (você as recebeu junto com o painel de hospedagem).
Passo 1: Abra o Terminal/Cliente SSH
No Mac ou Linux: Abra o "Terminal" (procure pelo ícone de tela preta).
No Windows: Baixe e instale PuTTY (gratuito) ou use MobaXterm. Abra o programa.
Passo 2: Conecte ao Servidor
No terminal (Mac/Linux) ou no cliente SSH (Windows), digite o comando abaixo, substituindo SEU_USUARIO pelos dados que você recebeu:
ssh SEU_USUARIO@seu-servidor.com.br
Exemplo:
ssh joao123@seu-servidor.com.br
Pressione Enter. Na primeira conexão, o sistema pode pedir confirmação de segurança (algo como "Are you sure you want to continue connecting?"). Digite yes e pressione Enter.
Agora, digite sua senha e pressione Enter. A senha não aparece na tela (é normal, é por segurança).
✅ Pronto! Você agora está conectado ao servidor. Deve aparecer algo como:
[joao123@seu-servidor ~]$
Este é o seu "prompt" — o lugar onde você digita comandos.
Passo 3: Navegue até Seu Script
Os scripts geralmente ficam na pasta public_html (seu site) ou em uma pasta que você criou. Para saber onde você está agora, digite:
pwd
Pressione Enter. Isso mostra o "caminho" (path) atual.
Para entrar na pasta do seu site, digite:
cd public_html
Para ver quais arquivos estão lá, digite:
ls -la
Pressione Enter. Você verá uma lista de arquivos e pastas.
Passo 4: Execute Seu Script
Agora vem o principal! Para executar um script (por exemplo, um arquivo chamado backup.php), você usa o comando:
php backup.php
Variações comuns:
- Script Python:
python3 seu_script.py - Script Bash:
bash seu_script.sh - Script Node.js:
node seu_script.js
Pressione Enter e o script começará a rodar. Você verá o resultado na tela (ou mensagens de progresso/erro).
Passo 5: Veja o Resultado
O script executou? Ótimo! Você verá uma das duas coisas:
- Sucesso: Mensagem de confirmação (ex.: "Backup concluído") e o prompt reaparece.
- Erro: Mensagem de erro. Leia com calma — geralmente diz o que deu errado.
Dicas e Boas Práticas
💡 Executar scripts em segundo plano: Se seu script demora muito, você pode deixá-lo rodando mesmo que saia do terminal. Use:
nohup php seu_script.php &O
&no final faz o script rodar "de fundo". Usejobspara ver os processos rodando.
📅 Agendar scripts para rodar automaticamente: Quer que um script rode todo dia à uma hora específica? Use Cron. Digite:
crontab -eIsso abre um editor. Procure por documentação de Cron para a sintaxe exata, ou abra um ticket — a gente te ajuda!
🔒 Segurança com Chaves SSH: Usar senha toda vez é cômodo, mas menos seguro. Considere gerar chaves SSH (pública e privada) para uma autenticação mais robusta. Chave privada fica com você (protegida com uma frase-passe), e a pública fica no servidor. Muito mais seguro! Solicite ajuda se precisar configurar.
📝 Redirecionar a saída para um arquivo: Se você quer salvar o resultado do script em um arquivo, use:
php seu_script.php > resultado.logIsso cria um arquivo
resultado.logcom a saída. Útil para debug!
Troubleshooting — Se der erro
"Permissão negada": Seu script pode não ter permissão de execução. Digite:
chmod +x seu_script.sh
Isso dá permissão de execução. (Vale para scripts .sh; .php não precisa.)
"Comando não encontrado": O PHP, Python ou Node.js pode não estar no caminho padrão. Tente:
/usr/bin/php seu_script.php
ou procure onde está instalado: which php
"Timeout ou script muito lento": SSH tem um tempo máximo de conexão. Se seu script vai demorar muito, use a técnica de segundo plano (veja em "Dicas" acima).
"Variáveis de ambiente não funcionam": Às vezes scripts dependem de variáveis (como PATH ou banco de dados). Se funciona no cPanel mas não no SSH, você pode precisar declarar essas variáveis manualmente no script ou no terminal.
Desconectando
Quando terminar, simplesmente digite:
exit
Pressione Enter. Você saiu do servidor e voltou ao seu computador.
Precisa de Ajuda?
SSH é poderoso, mas exige um pouco de conhecimento. Se você:
- Não consegue conectar
- Seu script dá erro e você não sabe como consertar
- Quer agendar algo via Cron e precisa de ajuda com a sintaxe
- Precisa de chaves SSH configuradas
Abra um ticket com a gente! Acesse o suporte. A equipe GeHost está aqui pra te ajudar, sem pressão. 😊
Boa sorte com seus scripts! Você é craque! 🚀