Como copiar arquivos entre computador e servidor com SCP

O scp (secure copy) transfere arquivos usando a conexão SSH. Se você consegue entrar no servidor por SSH, consegue copiar arquivos com scp, sem instalar mais nada. Ele vem no Linux, no macOS e no Windows 10 e 11 (no cliente OpenSSH, pelo PowerShell ou pelo Prompt de Comando).

O formato é sempre scp origem destino, com o lado remoto escrito como usuario@servidor:caminho. Para copiar uma pasta inteira, acrescente -r; para outra porta, -P maiúsculo.

A sintaxe básica

scp [opções] origem destino

O lado local é só o caminho, e o remoto leva o usuário e o servidor antes dos dois-pontos. A ordem define a direção: o primeiro é a origem, o segundo é o destino.

Enviar um arquivo para o servidor

scp backup.sql usuario@203.0.113.10:/home/usuario/

Baixar um arquivo do servidor

scp usuario@203.0.113.10:/var/log/app/erro.log .

Copiar uma pasta inteira

Use -r para copiar diretórios de forma recursiva:

scp -r ./site/ usuario@203.0.113.10:/var/www/

Servidor com SSH em outra porta

No scp a porta vai com P maiúsculo (no comando ssh é p minúsculo, o que costuma confundir):

scp -P 2222 arquivo.zip usuario@203.0.113.10:/tmp/

Usar uma chave privada específica

scp -i ~/.ssh/id_ed25519 arquivo.zip usuario@203.0.113.10:/tmp/

Se você usa sempre o mesmo servidor, configure um apelido no ~/.ssh/config com HostName, User, Port e IdentityFile. Depois basta escrever scp arquivo.zip apelido:/tmp/.

Copiar de um servidor para outro

É possível indicar dois lados remotos. Desde o OpenSSH 8.7, de 2021, os dados passam pelo seu computador por padrão, o que evita configurar acesso de um servidor ao outro. Em clientes mais antigos, a opção -3 faz o mesmo; para a cópia direta entre os servidores, use -R, e aí o servidor de origem precisa conseguir entrar no de destino.

scp -3 usuario@servidor-a:/backup/site.tar.gz usuario@servidor-b:/restore/

Opções úteis

• -C comprime durante a transferência, útil para arquivos de texto grandes em conexões lentas.
• -p preserva datas de modificação e permissões.
• -l limita a banda, em kbit/s (por exemplo, -l 8000 para cerca de 1 MB/s).
• -v mostra detalhes da conexão, útil para descobrir por que a autenticação falha.
• -O usa o protocolo SCP antigo, para servidores que não aceitam o modo atual (veja abaixo).

Desde o OpenSSH 9.0, de 2022, o scp usa por baixo o protocolo SFTP, e não mais o protocolo SCP antigo. Para quem digita, nada muda. Se a cópia falhar com um servidor muito antigo ou com o subsistema SFTP desligado, tente de novo com -O.

Quando usar rsync em vez de scp

Para sincronizar pastas grandes ou retomar uma cópia interrompida, o rsync é melhor: ele envia só o que mudou e pode continuar de onde parou. Ele também funciona sobre SSH:

rsync -avz --progress ./site/ usuario@203.0.113.10:/var/www/site/

Perguntas frequentes

Como copiar uma pasta inteira com scp?

Use a opção -r, que copia o diretório com tudo o que há dentro: scp -r ./site/ usuario@203.0.113.10:/var/www/. Para pastas grandes ou cópias que podem ser interrompidas, o rsync é mais indicado, porque retoma de onde parou.

Como usar o scp com uma porta diferente da 22?

Informe a porta com -P maiúsculo, antes da origem e do destino: scp -P 2222 arquivo.zip usuario@203.0.113.10:/tmp/. No comando ssh, a mesma opção é -p minúsculo.

O scp funciona no Windows?

Sim. O Windows 10 e o 11 trazem o cliente OpenSSH, com os comandos ssh e scp disponíveis no PowerShell e no Prompt de Comando. Caminhos locais do Windows funcionam normalmente, como C:\Users\usuario\Desktop\arquivo.zip.

Qual a diferença entre scp, sftp e rsync?

Os três usam o SSH. O scp copia arquivos de uma vez, com um comando só; o sftp abre uma sessão interativa para navegar e transferir; o rsync sincroniza pastas, envia só o que mudou e retoma cópias interrompidas.