Ir para o conteúdo
Promovaweb

Transfira arquivos com SFTP

Revisado em

Antes de começar

Transfira um arquivo de estudo nos dois sentidos.

  • Termius instalado e uma VPS de estudo com acesso autorizado.
  • Endereço, porta e credencial fornecidos pelo administrador.

Use um arquivo de texto descartável na primeira transferência. Isso permite conferir o sentido da cópia e o diretório de destino antes de trabalhar com configurações do servidor.

Abra os painéis

No desktop, abra SFTP e selecione um host em um dos painéis. Autentique se o aplicativo solicitar. Mantenha o sistema local no outro painel e leia o caminho exibido em ambos antes de arrastar qualquer arquivo.

Se o armazenamento local não aparecer, confira a origem da instalação. As versões da Mac App Store e Snap têm limitações de acesso ao sistema de arquivos. O site oficial oferece outras distribuições para sistemas compatíveis.

Faça uma transferência de estudo

No computador, crie um arquivo chamado teste-sftp.txt com uma frase curta. No painel remoto, abra o diretório pessoal da sua conta. Transfira o arquivo para esse diretório e aguarde a conclusão.

Depois, baixe o arquivo remoto para outra pasta local e compare o conteúdo. Esse teste confere upload e download. Se já existir um arquivo com o mesmo nome no destino, escolha um nome novo para preservar o anterior.

Confira permissões e arquivos ocultos

O SFTP usa as permissões da conta remota. Quando o acesso SSH funciona e a escrita em uma pasta falha, confira o proprietário e as permissões. Prefira transferir para o diretório pessoal e seguir o procedimento de implantação do projeto.

Para visualizar arquivos ocultos, use Actions → Show Hidden Files. Arquivos como .env podem conter segredos: confira o destino antes de copiar e mantenha-os fora dos repositórios públicos.

Entenda upload, download e diretório

Upload envia um arquivo do computador para o servidor. Download traz o arquivo remoto para o computador. Os dois painéis do SFTP ajudam a escolher origem e destino, mas a posição de um painel na tela não basta para identificar o sentido: leia o host e o caminho exibidos antes de transferir.

No exercício, você pode usar uma pasta local chamada estudos-termius e o diretório pessoal do usuário remoto. Se esse usuário for aluno e sua pasta pessoal for /home/aluno, é ali que o arquivo deve aparecer. Esse caminho é um exemplo e precisa corresponder à conta da sua VPS.

Confira o conteúdo pelo terminal remoto

Depois de enviar teste-sftp.txt para o diretório pessoal, abra uma sessão SSH com o mesmo usuário e consulte o arquivo:

Terminal
ls -l ~/teste-sftp.txt
cat ~/teste-sftp.txt

O primeiro comando mostra informações do arquivo, incluindo o tamanho e o proprietário. O segundo exibe seu conteúdo. O símbolo ~ representa o diretório pessoal do usuário da sessão. Use esse exemplo apenas para o arquivo de texto descartável, sem segredos.

Se o comando informar que o arquivo não existe, volte ao painel SFTP e leia o caminho completo do destino. Talvez você tenha transferido para outra pasta ou conectado com outro usuário. Baixar o arquivo para uma pasta diferente no computador também evita confundir a cópia recebida com o original.

Se a transferência for recusada, consulte permissões no SFTP antes de alterar o acesso à pasta.

Confira o resultado

O arquivo baixado tem o mesmo conteúdo do original e ficou no diretório escolhido.

Fontes consultadas

Procedimento conferido na documentação oficial. A execução no aplicativo e em uma VPS não foi realizada nesta revisão.