Cómo subir archivos con SFTP
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
- Un proyecto ya creado.
- SFTP activado en ese proyecto. No viene activo en todos, y el usuario existe antes de activarlo.
- Un cliente SFTP: FileZilla, una extensión SFTP para VS Code, o el comando
sftpen una terminal.
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.

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:
- El puerto es 2026, no 22. Con el puerto por defecto la conexión se queda esperando o se rechaza.
- El usuario es
cuenta.proyecto, con un punto. No es tu correo ni el nombre del proyecto solo. - La contraseña es por proyecto. La de otro proyecto no funciona aquí.
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.

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.
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.
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ó
- Recarga el sitio en una ventana privada, para que la caché no oculte el cambio.
- Revisa el tamaño y la fecha de modificación en el gestor de archivos; un archivo de 0 bytes significa que la transferencia se cortó.
- Si la página sale en blanco, abre una vez un archivo PHP con un
phpinfo()deliberado y bórralo después.
build Errores y soluciones
- La conexión se queda esperando — puerto incorrecto. Usa 2026.
- Conexión rechazada — el host está mal o SFTP está desactivado en ese proyecto.
- Autenticación fallida — el usuario debe ser
cuenta.proyecto. Revisa si al pegar la contraseña se coló un espacio. - Permiso denegado al escribir — puede que la cuota de archivos (5 GiB compartidos entre proyectos) esté llena.
- Archivos subidos pero el sitio da 404 — fueron a una subcarpeta, o no hay archivo index en la raíz.
- PHP se ve como texto — el archivo termina en
.html,.txto doble extensión como.php.txt. - Los cambios no aparecen — conectaste a otro proyecto. El usuario incluye el nombre del proyecto; compáralo.
security Buenas prácticas
- No subas
.env, volcados de base de datos ni copias de seguridad a la raíz. Archivos comoconfig.php.bakse sirven como descarga, así que la contraseña que contienen se vuelve pública. - Borra las carpetas
.gitlocales antes de subir una copia; exponen el historial y a veces credenciales. - Desactiva SFTP en el panel de ajustes cuando no lo uses. Al desactivarlo se revocan las credenciales.
- Si cambias la contraseña, actualiza la conexión guardada en tu cliente antes del siguiente despliegue.
- Mantén una copia independiente de tus archivos. SFTP es una herramienta de transferencia, no un backup.
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.