Como Transferir Arquivos pelo Terminal Usando SCP e SFTP
Olá! Aqui é a Sensei da GeHost 🥋 Hoje vamos aprender uma habilidade que separa quem só usa o computador de quem realmente domina ele: transferir arquivos direto pelo terminal, sem precisar abrir programa nenhum de interface gráfica. Pode parecer assustador no começo, mas prometo que depois desse guia você vai se sentir craque.
Dica da Sensei: se você já usa um programa de FTP com interface gráfica (tipo FileZilla) e está satisfeito, não tem problema nenhum continuar usando! Este guia é para quem quer aprender o caminho pelo terminal — mais rápido para quem já tem prática, e ótimo para automatizar tarefas.
O que são SCP e SFTP (e qual a diferença)?
Os dois servem para a mesma coisa: mover arquivos entre o seu computador e o servidor de hospedagem, de forma segura (criptografada). A diferença está em como cada um funciona:
- SCP (Secure Copy Protocol): é como um "copiar e colar" rápido. Você digita um comando, o arquivo viaja, e pronto — a conexão se encerra sozinha.
- SFTP (SSH File Transfer Protocol): abre uma "sessão" interativa, parecida com um explorador de arquivos por texto. Você entra, navega pelas pastas, sobe e baixa vários arquivos, e só sai quando quiser.
Na prática: use SCP para transferências rápidas e pontuais, e SFTP quando for mexer em várias pastas e arquivos ao longo de uma sessão.
Antes de começar: o que você precisa ter em mãos
Ambos os métodos usam o protocolo SSH por baixo dos panos, então você vai precisar de:
- Acesso SSH habilitado na sua conta de hospedagem. Verifique no painel.gehost.com.br ou, se preferir, fale com nosso suporte para confirmar se o seu plano tem esse recurso disponível e como ativá-lo.
- Usuário, senha (ou chave SSH) e endereço do servidor — essas informações ficam disponíveis no seu painel de cliente. Nunca compartilhe esses dados com terceiros.
- Um terminal. No Mac e no Linux já vem pronto (procure por "Terminal"). No Windows, você pode usar o PowerShell, o Prompt de Comando (em versões mais novas já vem com SSH embutido) ou um programa como o PuTTY/WinSCP.
Dica da Sensei: se for a primeira vez que você acessa via SSH, o terminal pode perguntar se confia na "impressão digital" (fingerprint) do servidor. É normal — digite "yes" e siga em frente.
Parte 1: Transferindo arquivos com SCP
O comando SCP segue sempre esta lógica: scp origem destino. Um dos dois lados é sempre o seu computador, e o outro é o servidor.
Enviando um arquivo do seu computador para o servidor
scp caminho/do/arquivo.txt seuusuario@seudominio.com:/public_html/
Traduzindo: pegue o arquivo.txt que está no seu computador e envie para a pasta public_html do servidor, usando o login seuusuario.
Baixando um arquivo do servidor para o seu computador
scp seuusuario@seudominio.com:/public_html/arquivo.txt ./
Aqui é o caminho inverso: pegue o arquivo que está no servidor e traga para a pasta atual do seu computador (o ./ significa "aqui mesmo").
Enviando uma pasta inteira
Para copiar uma pasta com tudo dentro dela, adicione a opção -r (de "recursivo"):
scp -r minha_pasta seuusuario@seudominio.com:/public_html/
Dica da Sensei: o comando vai pedir sua senha SSH assim que você apertar Enter. Não se preocupe se não aparecer nenhum caractere enquanto você digita — é normal, o terminal esconde a senha por segurança.
Parte 2: Transferindo arquivos com SFTP
Se você prefere navegar pelas pastas com calma, o SFTP é o seu caminho. Vamos abrir uma sessão:
- No terminal, digite:
sftp seuusuario@seudominio.com
- Depois de digitar sua senha, você vai ver um prompt assim:
sftp>. Isso significa que você está "dentro" da sessão, conversando direto com o servidor. - Agora é só usar os comandos abaixo para navegar e transferir:
- ls — lista os arquivos da pasta atual no servidor.
- lls — lista os arquivos da pasta atual no seu computador (repare no "l" extra de "local").
- cd nome_da_pasta — entra em uma pasta do servidor.
- lcd nome_da_pasta — entra em uma pasta do seu computador.
- put arquivo.txt — envia um arquivo do seu computador para o servidor.
- get arquivo.txt — baixa um arquivo do servidor para o seu computador.
- mkdir nome — cria uma pasta nova no servidor.
- exit ou bye — encerra a sessão.
Um exemplo de sequência bem comum: você entra na sessão, navega até public_html, envia um arquivo atualizado do site e sai:
sftp seuusuario@seudominio.com sftp> cd public_html sftp> put index.html sftp> exit
Erros comuns (e como resolver)
- "Connection refused" ou "Connection timed out": confira se digitou corretamente o endereço do servidor e se o acesso SSH está realmente habilitado na sua conta — dá uma olhada no painel ou chame o suporte.
- "Permission denied": geralmente é usuário ou senha errados, ou o arquivo/pasta de destino não pertence ao seu usuário. Confira as credenciais no painel.
- Comando "scp" ou "sftp" não reconhecido (Windows): em versões mais antigas do Windows pode faltar o cliente SSH. Instale um programa como o PuTTY (que inclui o PSCP e o PSFTP) ou atualize seu sistema.
Dica da Sensei: sempre faça um backup antes de mexer em arquivos importantes do site. Você pode gerar backups direto pelo cPanel, na área de Backup do seu painel — assim, se algo sair do esperado, é fácil voltar atrás.
Resumo rápido
SCP é o comando certeiro para uma transferência única e direta. SFTP é a sessão ideal quando você vai organizar, mover e conferir vários arquivos de uma vez. Os dois são seguros, rápidos e, depois de praticados algumas vezes, viram parte natural do seu fluxo de trabalho.
Ficou com alguma dúvida no meio do caminho? É só chamar o suporte da GeHost — estamos aqui para ajudar você a evoluir nessa jornada. 🥋
