O SFTP e o rsync copiam ficheiros para um servidor através de SSH, mas resolvem problemas diferentes. O SFTP basta para enviar ou descarregar ficheiros individuais e navegar por diretórios. O rsync -avz -e ssh é a ferramenta certa para sincronizar pastas inteiras de forma repetida, porque envia apenas o que mudou e, com --delete, também espelha as eliminações no destino.

SFTP e rsync: o que faz cada um ao copiar ficheiros por SSH

O SFTP é um subsistema do SSH: funciona sobre a mesma ligação, na porta TCP 22 por predefinição, e autentica-se com as mesmas chaves. Oferece uma sessão interativa com comandos como put, get, ls e rename, e copia cada ficheiro na íntegra. Desde o OpenSSH 9.0 (abril de 2022), o scp também usa o protocolo SFTP por predefinição, pelo que ambos partilham a mesma base.

O rsync é uma ferramenta diferente: compara a origem e o destino e envia apenas as diferenças. Com -e ssh abre uma ligação SSH e inicia o rsync no servidor, por isso precisa do rsync instalado nas duas pontas. O SFTP só precisa de que o servidor SSH tenha o subsistema SFTP ativado.

Tabela comparativa SFTP vs rsync para copiar ficheiros

O SFTP volta a enviar cada ficheiro completo em cada cópia; o rsync envia apenas o que mudou desde a última sincronização. As restantes diferenças são estas:

CritérioSFTPrsync -avz -e ssh
O que é transferidoFicheiros completosApenas as diferenças entre origem e destino
Requisito no servidorSubsistema SFTP do servidor SSHrsync instalado nas duas pontas
Uso interativoSim: navegar, listar, renomear, eliminarNão: um comando por sincronização
Espelhar eliminaçõesNão, elimina-se à mãoSim, com --delete
Retomar transferênciasreget e reput--partial, incluído em -P
Manter permissões e datasput -p e get -p-a (modo arquivo)
A partir do telemóvelNavegador SFTP integrado no clienteExecuta-se num servidor a partir da sessão SSH

rsync -avz -e ssh: comando base e o que faz cada flag

O comando base para copiar uma pasta local para um servidor com rsync por SSH é rsync -avz -e ssh source/ user@server:destination/. Estas são as variantes mais comuns:

# Base copy
rsync -avz -e ssh ./web/ user@server:/var/www/web/

# SSH port other than 22
rsync -avz -e "ssh -p 2222" ./web/ user@server:/var/www/web/

# With progress and partial-file resume
rsync -avzP -e ssh ./backups/ user@server:/srv/backups/
  • -a: modo arquivo. Cópia recursiva que mantém permissões, datas e ligações simbólicas; o proprietário e o grupo só quando é executado com privilégios.
  • -v: lista os ficheiros que estão a ser transferidos.
  • -z: comprime os dados em trânsito. Ajuda em ligações lentas; acrescenta pouco em ficheiros já comprimidos.
  • -e ssh: define o SSH como transporte e permite passar-lhe opções, como a porta.
  • -P: equivale a --partial --progress; mantém o que já foi enviado se a ligação cair.

A barra final na origem muda o resultado: ./web/ copia o conteúdo da pasta, enquanto ./web cria um diretório web dentro do destino.

rsync --delete: como espelhar eliminações sem perder ficheiros do servidor

A opção --delete elimina no destino os ficheiros que já não existem na origem, deixando o servidor como uma cópia exata. É a flag que transforma uma cópia num espelho, por isso ensaie-a sempre primeiro com -n (--dry-run):

# Dry run: lists what would be copied and what would be deleted
rsync -avzn --delete -e ssh ./web/ user@server:/var/www/web/

# Real run, protecting files that only exist on the server
rsync -avz --delete --exclude 'uploads/' -e ssh ./web/ user@server:/var/www/web/

Os ficheiros excluídos com --exclude não são eliminados no destino, a menos que acrescente --delete-excluded. Estes quatro erros com rsync --delete são os que mais dados custam:

  1. Apontar para o diretório pai. Sincronizar ./web/ com /var/www/ elimina tudo o que está em /var/www e não está em web.
  2. Saltar o ensaio. Sem -n, descobre o que foi eliminado depois, e não antes.
  3. Trocar a origem e o destino. Com o servidor como origem, o --delete elimina ficheiros da sua cópia local.
  4. Não excluir os ficheiros gerados pelo servidor. Os uploads dos utilizadores, as caches ou um .env que só existe no servidor desaparecem se não forem excluídos.

Quando o SFTP basta para copiar ficheiros para o servidor

O SFTP basta quando a tarefa é pontual: enviar um ficheiro de configuração, descarregar um registo ou verificar um diretório antes de lhe mexer. Não precisa de rsync no servidor, e a sessão interativa permite verificar cada passo:

sftp user@server
sftp> cd /etc/nginx/sites-available
sftp> get default default.bak
sftp> put default
sftp> put -r certs
sftp> reget backup.tar.gz
sftp> bye

O SFTP é também a única opção em contas restringidas com ForceCommand internal-sftp, onde o rsync não consegue iniciar o seu processo remoto. Todos os comandos disponíveis estão listados no manual oficial do sftp do OpenSSH. Se a tarefa se repete diariamente ou envolve centenas de ficheiros, o rsync poupa tempo e erros.

SFTP e rsync a partir do telemóvel com o termi1

O termi1 tem SFTP integrado para ver, enviar e descarregar ficheiros sem sair da sessão SSH, que é precisamente o caso em que o SFTP basta. Para o rsync, a abordagem habitual no telemóvel é ligar-se a um servidor e executar a sincronização a partir daí para outra máquina.

  • Sessões longas: o termi1 mantém a sessão ativa com Mosh ao passar do wifi para os dados móveis e usa tmux, por isso um rsync iniciado dentro do tmux continua a correr quando volta.
  • Teclado: o teclado próprio do termi1 inclui Ctrl, Esc, Tab e as teclas de seta para cancelar com Ctrl+C ou completar caminhos com Tab.
  • IA que nunca carrega em Enter em comandos arriscados: descreva a cópia numa frase e a IA escreve o comando no prompt. Nas ligações marcadas como produção, nada recebe Enter automaticamente e tudo o que elimina fica retido.
  • Chaves: geradas no telemóvel; a chave privada nunca sai do dispositivo.

O terminal SSH e SFTP termi1 funciona sem conta e é gratuito; pode descarregar o termi1 para iPhone ou encontrá-lo no Google Play.

Perguntas frequentes

O rsync funciona sobre SFTP?

O rsync não usa o protocolo SFTP: usa o SSH como transporte e inicia o seu próprio processo rsync no servidor. É por isso que precisa do rsync instalado nas duas pontas e falha em contas restringidas a internal-sftp, onde só o SFTP está disponível.

O que faz exatamente o rsync --delete?

O rsync --delete elimina no destino os ficheiros que não existem na origem, deixando uma cópia exata. Execute-o primeiro com -n para ver a lista de eliminações e proteja os ficheiros que só existem no servidor com --exclude antes de o executar a sério.

É melhor o scp ou o SFTP para copiar ficheiros?

O scp e o SFTP partilham o mesmo protocolo no OpenSSH moderno, porque desde o OpenSSH 9.0 o scp usa SFTP por predefinição. O scp serve para uma cópia rápida numa linha; o SFTP acrescenta uma sessão interativa para navegar, renomear e retomar transferências com reget.

É possível usar o rsync a partir do telemóvel?

O rsync pode ser usado a partir do telemóvel abrindo uma sessão SSH num servidor e executando-o aí. Iniciá-lo dentro do tmux evita que uma sincronização longa seja interrompida se a rede mudar ou se a aplicação for fechada.