Error SFTP — Received unexpected end-of-file from SFTP server
Documento técnico que describe el error presentado al intentar conectar vía SFTP desde FileZilla a un servidor Linux, explica su causa raíz y detalla la solución aplicada.
Objetivo
Documentar claramente por qué el servidor rechazaba conexiones SFTP aunque SSH funcionaba, qué generó el error y cómo se corrigió la configuración de OpenSSH.
Descripción del error
Al intentar conectarse por SFTP con FileZilla usando el usuario root,
el servidor arrojaba el error:
FATAL ERROR: Received unexpected end-of-file from SFTP server
No se pudo conectar al servidor
SSH funcionaba correctamente, por lo que el fallo estaba exclusivamente en el subsistema SFTP.
Causa raíz del problema
En el archivo /etc/ssh/sshd_config existía esta línea incorrecta:
Subsystem sftp internal-sftp-server
El binario internal-sftp-server NO existe en distribuciones Ubuntu/Debian. Cuando SFTP intentaba iniciar, el servidor fallaba inmediatamente y cerraba la conexión, generando el error reportado por FileZilla.
Solución aplicada
Se corrigió el subsistema SFTP reemplazando la línea inválida por la ruta correcta de OpenSSH:
Subsystem sftp /usr/lib/openssh/sftp-server
Después de guardar los cambios, se reinició el servicio:
sudo systemctl restart ssh
Con esto, el servidor SFTP funcionó correctamente y la conexión desde FileZilla se estableció sin errores.
Por qué suele ocurrir este error
- Subsistema SFTP mal configurado en
sshd_config. - Rutas inexistentes como
internal-sftp-server. - Actualización o instalación de paneles que reescriben configuraciones (ej. HestiaCP, ISPConfig).
- Faltan binarios SFTP o permisos incorrectos.
- Chroot mal configurado para usuarios SFTP.
Resultado final
Tras corregir el subsistema SFTP, la conexión funcionó de inmediato sin necesidad de cambios adicionales en firewall, fail2ban o claves SSH. El servidor quedó completamente operativo tanto en SSH como en SFTP.