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ério | SFTP | rsync -avz -e ssh |
|---|---|---|
| O que é transferido | Ficheiros completos | Apenas as diferenças entre origem e destino |
| Requisito no servidor | Subsistema SFTP do servidor SSH | rsync instalado nas duas pontas |
| Uso interativo | Sim: navegar, listar, renomear, eliminar | Não: um comando por sincronização |
| Espelhar eliminações | Não, elimina-se à mão | Sim, com --delete |
| Retomar transferências | reget e reput | --partial, incluído em -P |
| Manter permissões e datas | put -p e get -p | -a (modo arquivo) |
| A partir do telemóvel | Navegador SFTP integrado no cliente | Executa-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:
- Apontar para o diretório pai. Sincronizar
./web/com/var/www/elimina tudo o que está em/var/wwwe não está emweb. - Saltar o ensaio. Sem
-n, descobre o que foi eliminado depois, e não antes. - Trocar a origem e o destino. Com o servidor como origem, o
--deleteelimina ficheiros da sua cópia local. - Não excluir os ficheiros gerados pelo servidor. Os uploads dos utilizadores, as caches ou um
.envque 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> byeO 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.