Cómo subir archivos con SFTP

schedule 8 min de lectura signal_cellular_alt Principiante

SFTP mueve archivos entre tu ordenador y tu proyecto. Úsalo cuando el sitio tenga muchos archivos, cuando edites en local y quieras subir al guardar, o cuando el gestor de archivos del navegador se quede corto. Todo lo que subes cae en el mismo directorio que sirve la web, así que no hay un paso de despliegue aparte.

Esta guía cubre los datos de conexión, los dos clientes que más se usan, dónde deben ir los archivos y los errores que impiden conectarse.

info Antes de empezar

lightbulb

SFTP solo transfiere archivos. No hay shell, ni sesión ssh, ni ejecución de comandos. Lo que necesite una terminal en el servidor tiene que correr en tu máquina o desde PHP.

1 folder Abre tu proyecto

Ve al panel, busca tu proyecto y abre los datos SFTP de ese proyecto.

Datos SFTP de ejemplo. Usa tu propio usuario y mantén la contraseña privada.
Datos SFTP de ejemplo. Usa tu propio usuario y mantén la contraseña privada.

2 toggle_on Activa SFTP si está desactivado

Si el panel de ajustes muestra Activar SFTP, pulsa antes de intentar conectar. Hasta que lo hagas, el host y el usuario parecen correctos pero ninguna contraseña autentica.

Si entras con correo y contraseña, el panel puede usar la contraseña de tu cuenta. Si entras con Google, genera una. En cualquier caso, guarda lo que muestre el panel: la contraseña generada se muestra al crearla y no está garantizado que vuelva a aparecer.

3 key Copia los datos de conexión

Host:      sftp.nysr.host
Puerto:    2026
Usuario:   tu-cuenta.tu-proyecto
Contraseña: la que muestra el proyecto

Tres datos causan casi todas las conexiones fallidas:

4 computer Conecta con FileZilla o VS Code

Pega el host, el puerto, el usuario y la contraseña. Después de conectar, sube tus archivos a la carpeta raíz del proyecto.

Ajustes de conexión ilustrativos para FileZilla u otro cliente SFTP; no es una conexión real.
Ajustes de conexión ilustrativos para FileZilla u otro cliente SFTP; no es una conexión real.

En FileZilla, elige SFTP - SSH File Transfer Protocol como protocolo. La opción de FTP normal no conecta, ni siquiera con el host y la contraseña correctos.

En VS Code, una extensión SFTP te permite mapear una carpeta local contra el proyecto remoto y subir al guardar. Es el flujo más rápido si editas el sitio a menudo, pero configúrala para que borrar archivos en local no los borre en remoto por accidente.

Desde una terminal, los mismos datos funcionan con el cliente del sistema:

sftp -P 2026 [email protected]

La -P es mayúscula a propósito: la -p minúscula significa otra cosa y la conexión falla.

public Si nuestro gestor de archivos te da problemas

El gestor de archivos del panel es la forma recomendada de subir archivos: sin instalar nada, sin credenciales y sin configurar nada. Úsalo primero. Si en tu caso falla — subidas muy grandes, cientos de archivos o un navegador que se queda esperando — FileStash ofrece un cliente SFTP en el navegador en filestash.app/sftp-client.html como plan B, sin instalar nada.

Rellena los mismos cuatro valores: host sftp.nysr.host, puerto 2026, tu usuario cuenta.proyecto y la contraseña de ese proyecto.

security

La conexión se abre desde los servidores de FileStash, no desde tu navegador, así que tus credenciales SFTP pasan por un tercero. Trátalo como un apaño temporal: desactiva SFTP en los ajustes del proyecto al terminar, lo que revoca las credenciales.

5 drive_folder_upload Sube a la carpeta correcta

Sube a la raíz del proyecto. Esa raíz es lo que sirve el dominio, así que un archivo index.php en la raíz es la portada, y el mismo archivo dentro de /public/ queda en /public/index.php.

Este es el error más común con SFTP: arrastrar la carpeta local entera. Si subes mi-sitio/ en lugar de su contenido, la raíz queda vacía y la URL principal devuelve 404 aunque los archivos estén todos ahí, un nivel más abajo.

folder_off

Selecciona el contenido de tu carpeta local y súbelo a la raíz remota. Crea subcarpetas en remoto solo cuando tu aplicación las espere.

6 home Revisa la portada

Para PHP, usa index.php. Para un sitio estático, index.html. Si existen los dos, borra el que no quieras como portada.

El servidor mira primero index.html, después index.htm y por último index.php. Un index.html heredado del proyecto por defecto seguirá tapando tu portada PHP hasta que lo elimines.

7 verified Confirma que la subida funcionó

build Errores y soluciones

security Buenas prácticas

Preguntas frecuentes

¿Qué host y puerto uso?

sftp.nysr.host en el puerto 2026. El usuario es cuenta.proyecto y la contraseña es la que muestra ese proyecto. Copia los cuatro valores exactamente; un carácter que falte en la contraseña es el error de conexión más habitual.

¿Por qué dice autenticación fallida con la contraseña correcta?

Normalmente por una de tres cosas: SFTP no está activado en el proyecto, al usuario le falta el prefijo cuenta., o la contraseña es de otro proyecto. Actívalo en los ajustes y pega los valores de nuevo en lugar de escribirlos.

¿Dónde van los archivos?

A la raíz del proyecto. Una subcarpeta pasa a formar parte de la URL, así que los archivos dentro de public/ se sirven desde /public/. Si quieres una página en la raíz del dominio, el archivo debe estar en la raíz.

¿SFTP o el gestor de archivos?

Usa SFTP para muchos archivos o para subir desde un editor como VS Code o FileZilla. El gestor del navegador basta para pocos archivos o una edición rápida, y los dos escriben en el mismo proyecto.

¿Tengo acceso SSH?

No. La conexión es solo SFTP: puedes listar, subir, descargar, renombrar y borrar archivos, pero no ejecutar comandos en el servidor.

¿Dos personas pueden usar SFTP en el mismo proyecto?

El propietario y los colaboradores del proyecto pueden abrir los datos de conexión. Cada cuenta usa su propio usuario, así que la actividad no se comparte, pero todos escriben en los mismos archivos.

¿Hay límite de tamaño por archivo?

La cuenta tiene 5 GiB de almacenamiento compartidos entre sus proyectos. Los archivos muy grandes conviene subirlos por partes, y el gestor del navegador tiene un límite por petición más bajo que SFTP.

¿Por qué se subió un archivo de 0 bytes?

La transferencia se interrumpió. Reconecta y sube ese archivo otra vez; una transferencia parcial deja un archivo vacío que el sitio intentará servir igualmente.

¿Puedo usar SFTP sin instalar un cliente?

Prueba primero el gestor de archivos del panel: no requiere instalar nada ni usar credenciales. Si ese te da problemas, un cliente en el navegador como FileStash puede conectar por ti. Ten en cuenta que la conexión se hace desde sus servidores, así que las credenciales pasan por un tercero; desactiva SFTP en los ajustes del proyecto al terminar.

menu_book Guías relacionadas

¿Listo para subir?

Consigue tus datos SFTP desde el panel.

Abrir panel