Tutoriais de VPS
Transferir arquivos para VPS: scp, rsync, sftp e retomada segura
Escolha ferramentas para uploads, backups e migração. Confira barra final, filtros, limites de banda, exclusões, permissões e automação, com verificação de integridade e diagnóstico de transferências lentas.

Enviar um site, buscar um backup ou mover logs entre servidores exige transferência confiável. scp, rsync sobre SSH e sftp usam a conexão SSH, sem abrir uma porta FTP. Escolha conforme precise de cópia rápida, sincronização incremental ou navegação interativa.
| Recurso | scp | rsync sobre SSH | sftp |
|---|---|---|---|
| Uso comum | Poucos arquivos | Sincronizações repetidas | Gestão interativa |
| Transferência incremental | Não | Sim | Sem deltas por blocos |
| Retomada | Sem recurso nativo | Reutiliza dados parciais preservados | reget/reput em arquivos adequados |
| Exclusões | Sem filtros gerais | Sim | Sem filtros como os do rsync |
| Limite de velocidade | -l, Kbit/s | --bwlimit, normalmente KiB/s | -l, Kbit/s |
| Requisito remoto | Subsistema SFTP funcionando no OpenSSH moderno | rsync compatível e comandos SSH permitidos | Subsistema SFTP funcionando |
- Use
scppara cópias simples ocasionais. - Use
rsyncpara diretórios, filtros e transferências parciais. - Use
sftppara explorar e administrar arquivos.
Instale rsync compatível e com correções de segurança nos dois lados. Em Debian/Ubuntu, o exemplo no servidor é:
# 服务器上
sudo apt install -y rsync
Sem ele pode aparecer bash: rsync: command not found. Uma conta exclusivamente SFTP pode aceitar scp/sftp e proibir o comando remoto exigido pelo rsync.
# 上传文件
scp local.txt [email protected]:/srv/app/
# 上传目录(-r 递归)
scp -r ./dist [email protected]:/srv/app/
# 下载
scp [email protected]:/var/log/nginx/error.log ./
# 端口是大写 P(小写 p 是保留权限,别搞混)
scp -P 2222 local.txt [email protected]:/srv/app/
# 用指定密钥
scp -i ~/.ssh/id_ed25519 local.txt [email protected]:/srv/app/
Troque IPs de documentação, root e caminhos pelos reais e use uma conta com os privilégios necessários. Verifique a identidade SSH. -P maiúsculo escolhe a porta; -p preserva horários/permissões compatíveis.
Desde OpenSSH 9.0, de 2022, scp normalmente usa SFTP em vez do antigo scp/rcp. Escapes destinados ao shell remoto, como scp host:"/path/with\ space.txt" ., podem ter outro comportamento. Coloque o caminho completo entre aspas apropriadas ao shell local:
scp '[email protected]:/srv/my app/config.yml' ./
Caminhos como ~user/file dependem do suporte remoto; OpenSSH acrescentou [email protected] em 8.7. Prefira caminho explícito se essa extensão não existir.
Para uma necessidade de compatibilidade revisada, -O ativa o protocolo antigo:
scp -O local.txt [email protected]:/srv/app/
-O muda transporte e interpretação de caminhos. Use deliberadamente, sem desativar os padrões modernos por hábito.
- Arquivos grandes: scp não retoma nativamente; uma cópia de 5 GB interrompida em 90% pode precisar recomeçar.
- Muitos arquivos pequenos: protocolo e metadados pesam. Não exige uma nova sessão SSH por arquivo, mas ainda pode ser ineficiente.
- Cópias repetidas de diretórios: scp reenvia os arquivos selecionados em vez de sincronizar mudanças.
rsync normalmente seleciona mudanças por tamanho e data de modificação. Sobre SSH pode transmitir blocos alterados, conforme modo e opções; cópias locais geralmente transferem arquivos inteiros. Não cria automaticamente um backup consistente de banco.
# 带斜杠:把 src 里的「内容」同步到 dst
rsync -av src/ dst/
# 不带斜杠:把 src「这个目录本身」放进 dst
rsync -av src dst/
Se src/ contém a.txt e b.txt:
| Origem | Resultado com diretório de destino existente |
|---|---|
rsync -av src/ dst/ | dst/a.txt e dst/b.txt |
rsync -av src dst/ | dst/src/a.txt e dst/src/b.txt |
A barra significa copiar o conteúdo; sem ela, inclui o diretório. Confira o destino e faça uma simulação antes de implantar.
rsync -avz --progress ./dist/ [email protected]:/srv/app/current/
-aequivale a-rlptgoD: recursão, links, permissões, horários, grupos, donos e arquivos especiais, conforme privilégios. Não inclui hard links, ACLs e atributos estendidos; revise -H/-A/-X quando necessário.-vdetalha a saída.-zcomprime. Pode ajudar texto, código e SQL, mas desperdiçar CPU em mídia e arquivos já comprimidos.--progressmostra progresso por arquivo. Para muitos pequenos, reduza saída ou use progresso agregado compatível;-vpode bastar.
rsync -avzP --partial-dir=.rsync-partial \
[email protected]:/backup/db-2026-09-28.sql.gz ./
A data do arquivo é um exemplo, não um backup atual verificado. Em arquivo já comprimido, normalmente remova compressão, salvo benefício medido.
-Psignifica--partial --progress.--partialpreserva dados parciais para reutilização; não garante acrescentar bytes sem conferir.--partial-dirsepara os parciais. Proteja esse diretório e mantenha-o fora do conteúdo público do site.
--append-verify exige justificar a premissa de acrescentar a um prefixo correto, por exemplo em origem estável ou que apenas cresce. Não é uma opção universalmente mais segura. Se a origem mudou de forma imprevisível, sincronize normalmente a partir de uma cópia consistente. Retomar arquivos brutos de banco ativo não os torna um backup válido.
rsync -avz \
--exclude='.git' \
--exclude='node_modules' \
--exclude='*.log' \
--exclude='cache/' \
./project/ [email protected]:/srv/app/
Para guardar filtros:
# .rsyncignore
.git/
node_modules/
*.log
cache/
.env
rsync -avz --exclude-from='.rsyncignore' ./project/ [email protected]:/srv/app/
Excluir .env evita substituir configuração e segredos de produção; .git evita publicar objetos do repositório. Revise uploads, caches e dados de execução. Filtros têm ordem e semântica de caminhos; teste a partir da raiz de origem correta.
rsync -avz --bwlimit=2000 ./backup/ [email protected]:/backup/
No rsync atual, --bwlimit sem sufixo usa unidades de 1024 bytes/s. 2000 corresponde a cerca de 1,95 MiB/s, aproximadamente os 2 MB/s ilustrativos do original. Considere overhead e sufixos da versão. Preserve tráfego da aplicação e cotas; veja monitoramento e alertas de tráfego.
--delete merece cuidado; comece com --dry-run. --delete apaga do escopo sincronizado do destino o que não existe na origem. Filtros e modos de exclusão alteram a proteção.
Antes de --delete, execute --dry-run ou -n:
# 先演练,只打印会做什么,不实际执行
rsync -avz --delete --dry-run ./dist/ [email protected]:/srv/app/current/
# 确认输出符合预期,再去掉 --dry-run
rsync -avz --delete ./dist/ [email protected]:/srv/app/current/
Leia toda a saída e verifique origem, destino, filtros e backup recuperável. Uma origem inexistente normalmente gera erro, mas um diretório vazio existente e errado com --delete pode apagar o destino. --dry-run ajuda a detectar isso. --delete-after adia exclusões e --max-delete=100 limita a quantidade; nenhum substitui escopo correto e backup.
scp usa -P para porta. No rsync, -P não escolhe porta: -P significa parciais/progresso. Passe opções SSH com -e:
rsync -avz -e "ssh -p 2222" ./dist/ [email protected]:/srv/app/
rsync -avz -e "ssh -p 2222 -i ~/.ssh/id_ed25519" ./dist/ [email protected]:/srv/app/
Ou defina ~/.ssh/config seguindo a configuração de chaves e use o alias:
rsync -avz ./dist/ myserver:/srv/app/
-a pede preservação de metadados dentro das permissões do receptor. Um dono local como you:you pode não ser adequado; o serviço usa www-data ou uma conta própria.
rsync -avz --chown=www-data:www-data ./dist/ [email protected]:/srv/app/
--chown atua no lado receptor e exige privilégios adequados. Prefira diretório do usuário de implantação com leitura revisada para o serviço a SSH root desnecessário. Um 403 também pode envolver diretórios superiores e SELinux; veja diagnóstico 403.
sftp [email protected]
# 进去之后
ls # 列远端目录
lls # 列本地目录(前面加 l 表示 local)
cd /srv/app # 切换远端目录
lcd ~/Downloads # 切换本地目录
get backup.sql.gz # 下载
put config.yml # 上传
get -r logs/ # 递归下载目录
mkdir newdir # 建目录
rm oldfile # 删文件
bye # 退出
ls/cd atuam remotamente; lls/lcd no seu computador. get baixa e put envia. rm remove realmente no servidor, não é simulação.
Para parciais estáveis adequados:
reget backup.sql.gz # 续传下载
reput bigfile.iso # 续传上传
reget/reput presumem que o prefixo existente corresponde. Confira integridade após retomar e não use se o conteúdo mudou. A porta é definida com sftp -P 2222 [email protected] e -P maiúsculo.
sftp [email protected] <<'EOF'
cd /srv/app
put config.yml
bye
EOF
O here-document entre aspas impede expansão de variáveis locais. Para automação, teste chave e identidade do servidor, use BatchMode=yes e um arquivo sftp -b real quando falhas de comandos precisarem abortar de forma confiável. Confira o status de saída; não dependa de senha interativa.
Para usuários externos, desenhe restrições em sshd_config, como ChrootDirectory, internal-sftp e ausência de shell/encaminhamento arbitrário. Os componentes do chroot exigem propriedade root e não podem ser graváveis pelo usuário; crie um diretório interno de upload separado. Permissões SFTP comuns não escondem sozinhas todos os caminhos legíveis do sistema.
| Ferramenta | Plataformas | Uso |
|---|---|---|
| WinSCP | Windows | Transferência, sincronização e scripts |
| FileZilla | Windows, macOS, Linux | Navegação e transferência SFTP |
| Termius | Desktop/mobile compatíveis | Sessões e arquivos |
| MobaXterm | Windows | Terminal e gestão de arquivos |
| Cyberduck | macOS e Windows | SFTP e object storage compatível |
- Selecione SFTP, não FTP sem criptografia, que pode expor credenciais e conteúdo.
- Prefira chaves verificadas; veja chaves SSH e confira armazenamento/sincronização das privadas.
Algumas interfaces gráficas suportam filtros e retomada. Para sincronização grande e repetida, rsync costuma oferecer controle explícito e comandos reproduzíveis.
- Rede/TCP: com 200 ms de latência internacional, janela, perda e congestionamento podem limitar a velocidade. Meça antes de ajustar. Fragmentos paralelos ajudam alguns casos, mas exigem recomposição e integridade seguras.
- CPU e cifra: observe a carga da VPS pequena e compare cifras modernas compatíveis:
rsync -avz -e "ssh -c [email protected]" ./bigfile [email protected]:/data/
[email protected] aproveita aceleração AES quando disponível; não é mais rápido em toda CPU. Não enfraqueça criptografia por um ganho presumido.
- Disco: confira
iostat, latência e filas além de%util. Utilização alta sozinha não caracteriza dispositivos paralelos modernos. Veja diagnóstico de I/O. - Compressão redundante:
-zcostuma ajudar pouco em vídeos, imagens e zip/gz já comprimidos.
Escolhas práticas:
- Use
rsync -Previsando a preservação de parciais. - Considere
gzippara SQL/logs compressíveis; não há garantia de reduzir mais da metade. - Compare rota direta com object storage protegido em grandes mudanças, incluindo custo, cotas e retenção; veja quando usar object storage.
- Compare hashes nos dois lados.
md5sumdetecta mudanças acidentais, mas prefirasha256sum. Hash de fonte não confiável não prova autenticidade.
rsync -avz --delete --dry-run ./dist/ [email protected]:/srv/app/current/
# 确认无误后去掉 --dry-run
rsync -avz --delete ./dist/ [email protected]:/srv/app/current/
Revise exclusões primeiro. Sincronizar o diretório ativo não é implantação atômica; se precisa de continuidade, use um novo diretório de versão e uma troca testada. Mantenha segredos e uploads fora do build substituído.
rsync -avzP --bwlimit=5000 \
[email protected]:/srv/backups/ ~/vps-backups/
Confira espaço local, proteção do destino e consistência do backup. Baixá-lo não testa sua restauração.
# 在旧服务器上执行,直接推到新机器
rsync -avzP /srv/app/ root@新IP:/srv/app/
Execute na origem e substitua a nova IP. Use credencial restrita e verifique a chave do destino; não copie sua privada pessoal para servidor não confiável. Meça a rota, pois nem sempre será mais rápida. Veja migração de VPS.
rsync -avz --include='*.log' --exclude='*' \
[email protected]:/var/log/nginx/ ./logs/
O filtro seleciona arquivos correspondentes nesse nível. Para subdiretórios, acrescente --include='*/' antes da exclusão. Logs podem conter dados sensíveis; restrinja o acesso ao destino.
rsync -avz --files-from=<(find /srv/app -type f -mtime -7 -printf '%P\n') \
/srv/app/ [email protected]:/srv/app/
Exige Bash e GNU find. -mtime -7 usa idade de modificação, não datas do calendário. Execute onde /srv/app é a origem. Para nomes arbitrários, prefira separação NUL:
find /srv/app -type f -mtime -7 -printf '%P\0' > /tmp/app-recent-files.list
rsync -av --from0 --files-from=/tmp/app-recent-files.list /srv/app/ deploy@HOST:/srv/app/
Em ambiente compartilhado, use uma lista protegida e nome único. Confira HOST e caminhos selecionados antes de executar.
rsync: command not found: instale rsync atualizado nos dois lados. sudo apt install -y rsync é o exemplo Debian/Ubuntu.
Permission denied (publickey): resolva autenticação com Permission denied antes de investigar transferência.
rsync: failed to set times on ...: Operation not permitted: o receptor pode não ter permissão para preservar horários. --no-times altera esse pedido se desnecessário; caso contrário, corrija propriedade sem privilégios amplos.
Dono errado ou 403: revise --chown, qualquer chown -R bem delimitado e permissões/política do serviço. Veja falhas 403.
No space left on device: confira o sistema de arquivos receptor:
df -h # 空间
df -i # inode(小文件特别多时会先耗尽这个)
Veja blocos, inodes e cotas; consulte limpeza do disco e inodes esgotados.
Interrupção: preserve parciais com -P, confira integridade e estabilidade da origem. Veja desconexões SSH.
Poucos KB/s: confira um --bwlimit esquecido, disputa por disco/CPU, perda de pacotes e limites do provedor; veja limitação da VPS.
É criptografado? Esses modos sobre SSH criptografam esse trecho. Verifique identidade e proteja endpoints. rsync em modo daemon é outro transporte e não está incluído nessa afirmação.
E links simbólicos? -a preserva o link. -L segue seu conteúdo; -L pode ampliar o escopo ou encontrar ciclos. Revise links não confiáveis e os limites da cópia.
rsync no Windows? Use WSL compatível, por exemplo wsl rsync ..., ou pacote mantido como cwRsync. WinSCP é outro fluxo com comportamento próprio. Confira OpenSSH Client para scp/sftp.
Como verificar integridade? Compare hashes de endpoints confiáveis:
# 本地
sha256sum bigfile.tar.gz
# 服务器
sha256sum /srv/bigfile.tar.gz
No macOS use shasum -a 256; no Windows, Get-FileHash com SHA256. -c muda a seleção de arquivos para comparação por conteúdo e adiciona trabalho de disco; rsync também verifica durante a transferência.
Transferência direta entre servidores? Execute rsync na origem autorizada:
rsync -avzP /data/ root@另一台IP:/data/
Substitua o marcador, use chave restrita e confira rede/identidade do destino. A rota direta nem sempre é a mais rápida.
Sincronização agendada? Script com cron/systemd timer, caminhos explícitos, autenticação sem interação e known_hosts confiável. Registre falhas e evite sobreposição; veja tarefas que não executam.
Sincronizar é fazer backup? rsync --delete propaga exclusões. Preserve versões históricas, retenção externa e uma restauração ensaiada.