Tutoriales de VPS
Transferir archivos a una VPS: scp, rsync, sftp y reanudación
Elige herramientas para subir archivos, descargar copias y migrar. Revisa barras finales, filtros, límites de velocidad, borrados, permisos y automatización, con comprobación de integridad y diagnóstico de lentitud.

Subir una web, recuperar una copia o mover registros entre servidores requiere una transferencia fiable. scp, rsync sobre SSH y sftp utilizan la conexión SSH sin abrir un puerto FTP. Elige según necesites una copia rápida, sincronización incremental o exploración interactiva.
| Función | scp | rsync sobre SSH | sftp |
|---|---|---|---|
| Uso habitual | Pocos archivos | Sincronizaciones repetidas | Gestión interactiva |
| Transferencia incremental | No | Sí | Sin deltas por bloques |
| Reanudación | No nativa | Reutiliza parciales conservados | reget/reput en archivos adecuados |
| Exclusiones | Sin filtros generales | Sí | Sin filtros como rsync |
| Límite de velocidad | -l, Kbit/s | --bwlimit, normalmente KiB/s | -l, Kbit/s |
| Requisito remoto | Subsistema SFTP operativo en OpenSSH moderno | rsync compatible y ejecución de comandos SSH | Subsistema SFTP operativo |
scppara copias sencillas ocasionales.rsyncpara directorios, exclusiones y transferencias parciales.sftppara explorar y gestionar archivos.
Instala rsync compatible y con parches de seguridad en ambos extremos. En Debian/Ubuntu, el ejemplo del servidor es:
# 服务器上
sudo apt install -y rsync
Sin él puede aparecer bash: rsync: command not found. Una cuenta limitada a SFTP puede permitir scp/sftp y prohibir expresamente el comando remoto que necesita 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/
Sustituye IP de documentación, root y rutas por el destino y una cuenta con permisos mínimos. Verifica la identidad SSH. -P mayúscula elige puerto; -p conserva tiempos/permisos compatibles.
Desde OpenSSH 9.0, en 2022, scp utiliza normalmente SFTP y no el protocolo scp/rcp antiguo. Escapes destinados a la shell remota, como scp host:"/path/with\ space.txt" ., pueden comportarse de otra forma. Cita la ruta completa según la shell local:
scp '[email protected]:/srv/my app/config.yml' ./
Rutas como ~user/file dependen del soporte remoto; OpenSSH añadió [email protected] en 8.7. Usa una ruta explícita si falta esa extensión.
Para una necesidad de compatibilidad revisada, -O activa el protocolo anterior:
scp -O local.txt [email protected]:/srv/app/
-O modifica transporte y tratamiento de rutas. Utilízalo deliberadamente, sin desactivar los valores modernos por rutina.
- Archivos grandes: scp no continúa de forma nativa; una copia de 5 GB interrumpida al 90 % puede empezar de nuevo.
- Muchos archivos pequeños: las operaciones de protocolo y metadatos pesan. No necesita una sesión SSH nueva por archivo, pero puede ser poco eficiente.
- Copias repetidas de directorios: scp vuelve a enviar archivos en lugar de sincronizar diferencias.
rsync selecciona cambios normalmente por tamaño y fecha de modificación. Sobre SSH puede enviar bloques modificados, según modo y opciones; las copias locales suelen usar transferencia completa. No crea automáticamente una copia consistente de una base de datos.
# 带斜杠:把 src 里的「内容」同步到 dst
rsync -av src/ dst/
# 不带斜杠:把 src「这个目录本身」放进 dst
rsync -av src dst/
Si src/ contiene a.txt y b.txt:
| Origen | Resultado con un directorio destino existente |
|---|---|
rsync -av src/ dst/ | dst/a.txt y dst/b.txt |
rsync -av src dst/ | dst/src/a.txt y dst/src/b.txt |
La barra significa copiar el contenido; sin ella se incluye el directorio. Comprueba las rutas mediante una simulación antes de desplegar.
rsync -avz --progress ./dist/ [email protected]:/srv/app/current/
-aequivale a-rlptgoD: recursión, enlaces, permisos, tiempos, grupos, propietarios y archivos especiales, según privilegios. No incluye enlaces duros, ACL ni atributos extendidos; revisa -H/-A/-X cuando sean necesarios.-vañade detalle a la salida.-zcomprime; ayuda en ciertos textos, código o SQL, pero consume CPU sin beneficio en medios y archivos ya comprimidos.--progressmuestra progreso por archivo. Para muchos pequeños reduce la salida o utiliza progreso global compatible;-vpuede bastar.
rsync -avzP --partial-dir=.rsync-partial \
[email protected]:/backup/db-2026-09-28.sql.gz ./
La fecha del archivo es un ejemplo, no una copia actual comprobada. En un archivo ya comprimido normalmente elimina la compresión salvo que las mediciones la justifiquen.
-Pequivale a--partial --progress.--partialconserva datos parciales para reutilizarlos; no garantiza añadir bytes sin comprobar.--partial-dirsepara los parciales. Protege ese directorio y mantenlo fuera del contenido web público.
--append-verify requiere justificar su supuesto de añadir a un prefijo válido, por ejemplo con un origen estable o que solo crece. No es una opción universalmente más segura. Si el origen cambió de forma imprevisible, sincroniza normalmente desde una instantánea consistente. Reanudar archivos crudos de una base de datos activa no los convierte en una copia válida.
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 sobrescribir configuración y secretos de producción; .git evita publicar objetos del repositorio. Revisa subidas, cachés y datos de ejecución. Los filtros tienen reglas de orden y ruta: simula desde el directorio de origen correcto.
rsync -avz --bwlimit=2000 ./backup/ [email protected]:/backup/
En rsync actual, --bwlimit sin sufijo usa unidades de 1024 bytes/s. 2000 son unos 1,95 MiB/s, aproximadamente los 2 MB/s ilustrativos del original. Considera sobrecarga y sufijos de la versión. Protege tráfico de aplicación y cuotas; consulta monitorización y alertas de tráfico.
--delete exige cuidado: comienza con --dry-run. --delete elimina del ámbito sincronizado del destino lo ausente del origen; filtros y modos de borrado afectan la protección.
Antes de --delete, ejecuta --dry-run o -n:
# 先演练,只打印会做什么,不实际执行
rsync -avz --delete --dry-run ./dist/ [email protected]:/srv/app/current/
# 确认输出符合预期,再去掉 --dry-run
rsync -avz --delete ./dist/ [email protected]:/srv/app/current/
Lee la salida completa y comprueba origen, destino, filtros y una copia recuperable. Un origen inexistente normalmente produce error, pero un directorio vacío existente equivocado junto con --delete puede borrar el destino. --dry-run ayuda a detectarlo. --delete-after retrasa borrados y --max-delete=100 limita su número; no reemplazan un ámbito correcto y una copia.
scp utiliza -P para el puerto. En rsync, -P no selecciona puerto: -P significa parciales/progreso. Pasa opciones SSH con -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/
También puedes definir ~/.ssh/config siguiendo la configuración de claves y usar un alias:
rsync -avz ./dist/ myserver:/srv/app/
-a pide conservar metadatos dentro de las capacidades del receptor. Un propietario local como you:you no necesariamente es el adecuado; el servicio puede usar www-data o una cuenta propia.
rsync -avz --chown=www-data:www-data ./dist/ [email protected]:/srv/app/
--chown actúa en el receptor y necesita privilegios adecuados. Prefiere un directorio de despliegue propio con lectura revisada para el servicio a usar root sin necesidad. Un 403 también puede depender de directorios superiores o SELinux; consulta 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 actúan remotamente; lls/lcd en tu ordenador. get descarga y put sube. rm borra de verdad en el servidor: no es una simulación.
Para parciales estables adecuados:
reget backup.sql.gz # 续传下载
reput bigfile.iso # 续传上传
reget/reput suponen que el prefijo existente coincide. Comprueba integridad al terminar y no los uses si cambió el contenido. El puerto se indica con sftp -P 2222 [email protected] y -P mayúscula.
sftp [email protected] <<'EOF'
cd /srv/app
put config.yml
bye
EOF
El here-document citado evita expandir variables locales. Para automatizar, prueba la clave y la identidad del servidor, utiliza BatchMode=yes y un archivo real sftp -b cuando debas abortar fiablemente por comandos fallidos. Comprueba la salida y el código de retorno; no dependas de una contraseña interactiva.
Para usuarios externos, diseña restricciones en sshd_config, incluyendo ChrootDirectory, internal-sftp y ausencia de shell o reenvío arbitrarios. Los componentes del chroot requieren propiedad root y no ser escribibles por el usuario; crea dentro un directorio de subida separado. Los permisos SFTP normales no ocultan por sí solos todas las rutas legibles del sistema.
| Herramienta | Plataformas | Uso |
|---|---|---|
| WinSCP | Windows | Transferencia, sincronización y scripts |
| FileZilla | Windows, macOS, Linux | Explorar y transferir por SFTP |
| Termius | Escritorio/móvil compatibles | Sesiones y archivos |
| MobaXterm | Windows | Terminal y gestión de archivos |
| Cyberduck | macOS y Windows | SFTP y almacenamiento de objetos compatible |
- Selecciona SFTP, no FTP sin cifrar, que puede exponer credenciales y contenido.
- Prefiere claves verificadas; consulta claves SSH y revisa su almacenamiento o sincronización.
Algunas interfaces gráficas admiten filtros y reanudación. Para sincronización grande y repetida, rsync suele ofrecer control explícito y comandos reproducibles.
- Red/TCP: con 200 ms de latencia internacional pueden limitar ventana, pérdida o congestión. Mide antes de ajustar. Fragmentos paralelos pueden ayudar en ciertos casos, pero exigen recomposición e integridad seguras.
- CPU y cifrado: observa carga en una VPS pequeña y compara algoritmos modernos compatibles:
rsync -avz -e "ssh -c [email protected]" ./bigfile [email protected]:/data/
[email protected] aprovecha aceleración AES cuando existe; no es más rápido en todas las CPU. No debilites criptografía por una mejora supuesta.
- Disco: revisa
iostat, latencia y colas, además de%util. Utilización alta por sí sola no describe dispositivos paralelos modernos. Consulta diagnóstico de E/S. - Compresión redundante:
-zsuele aportar poco en vídeo, imágenes y zip/gz comprimidos.
Opciones prácticas:
- Utiliza
rsync -Previsando cómo conserva parciales. - Considera
gzippara SQL y registros compresibles; no se garantiza reducirlos más de la mitad. - Compara ruta directa y almacenamiento de objetos protegido para grandes movimientos, incluyendo coste, cuota y retención; consulta cuándo usar objetos.
- Compara hashes en ambos extremos:
md5sumdetecta cambios accidentales, pero prefieresha256sum. Un hash recibido de una fuente no fiable no demuestra autenticidad.
rsync -avz --delete --dry-run ./dist/ [email protected]:/srv/app/current/
# 确认无误后去掉 --dry-run
rsync -avz --delete ./dist/ [email protected]:/srv/app/current/
Revisa borrados primero. Sincronizar sobre el directorio activo no es un despliegue atómico; si necesitas continuidad, usa un directorio de versión nuevo y un cambio probado. Mantén secretos y subidas fuera del resultado reemplazado.
rsync -avzP --bwlimit=5000 \
[email protected]:/srv/backups/ ~/vps-backups/
Comprueba espacio local, protección del destino y consistencia real de la copia. Descargarla no prueba que pueda restaurarse.
# 在旧服务器上执行,直接推到新机器
rsync -avzP /srv/app/ root@新IP:/srv/app/
Ejecuta desde el origen y sustituye la IP nueva. Usa una credencial limitada y verifica la clave del destino; no copies tu privada personal a un servidor no fiable. Mide la ruta: no siempre será más rápida. Consulta migración de VPS.
rsync -avz --include='*.log' --exclude='*' \
[email protected]:/var/log/nginx/ ./logs/
El filtro selecciona los archivos coincidentes en ese nivel. Para subdirectorios, añade --include='*/' antes de excluir. Los registros pueden contener datos sensibles; limita el acceso local.
rsync -avz --files-from=<(find /srv/app -type f -mtime -7 -printf '%P\n') \
/srv/app/ [email protected]:/srv/app/
Requiere Bash y GNU find. -mtime -7 mide antigüedad de modificación, no fechas del calendario. Ejecuta donde /srv/app es el origen. Para nombres arbitrarios, utiliza separación 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/
En un equipo compartido, usa una lista protegida con nombre único. Verifica HOST y examina las rutas seleccionadas antes de ejecutar.
rsync: command not found: instala rsync actualizado en ambos extremos; sudo apt install -y rsync es el ejemplo Debian/Ubuntu.
Permission denied (publickey): resuelve autenticación con Permission denied antes de investigar transferencia.
rsync: failed to set times on ...: Operation not permitted: el receptor puede no tener permiso para conservar tiempos. --no-times cambia esa petición si no la necesitas; si sí, corrige propietario sin dar permisos excesivos.
Propietario incorrecto o 403: revisa --chown, cualquier chown -R limitado y los permisos de directorios/política del servicio. Consulta errores 403.
No space left on device: comprueba el sistema de archivos receptor:
df -h # 空间
df -i # inode(小文件特别多时会先耗尽这个)
Revisa bloques, inodes y cuotas; consulta limpieza del disco y agotamiento de inodes.
Interrupción: conserva parciales con -P, verifica integridad y estabilidad del origen. Consulta desconexiones SSH.
Pocos KB/s: revisa un --bwlimit olvidado, disco/CPU, pérdida de paquetes y límites del proveedor; consulta limitación de VPS.
¿Se cifra? Estos modos sobre SSH cifran ese tramo. Verifica identidad y protege endpoints. rsync en modo daemon es otro transporte y no queda incluido en esta afirmación.
¿Qué pasa con enlaces simbólicos? -a conserva el enlace. -L sigue su contenido; -L puede ampliar el ámbito o encontrar ciclos. Revisa enlaces no fiables y límites de copia.
¿rsync en Windows? Utiliza WSL compatible, por ejemplo wsl rsync ..., o un paquete mantenido como cwRsync. WinSCP es una alternativa con comportamiento distinto. Verifica OpenSSH Client para scp/sftp.
¿Cómo compruebo integridad? Compara hashes desde extremos fiables:
# 本地
sha256sum bigfile.tar.gz
# 服务器
sha256sum /srv/bigfile.tar.gz
En macOS usa shasum -a 256 y en Windows Get-FileHash con SHA256. -c cambia la selección de archivos a comparación de contenido y añade trabajo de disco; rsync también comprueba durante la transferencia.
¿Transferencia directa entre servidores? Ejecuta rsync en un origen autorizado:
rsync -avzP /data/ root@另一台IP:/data/
Sustituye el marcador, usa clave limitada y verifica red e identidad del host. Una ruta directa no es siempre la más rápida.
¿Sincronización programada? Script con cron/systemd timer, rutas explícitas, autenticación sin interacción y known_hosts fiable. Registra fallos y evita solapamientos; consulta tareas que no se ejecutan.
¿Sincronizar equivale a una copia? rsync --delete propaga borrados. Conserva versiones históricas, retención externa y una restauración ensayada.