Errores FTP en Syspanel: Cómo solucionarlos fácilmente

¿Te has encontrado con el molesto mensaje de "Error de conexión FTP" en tu Syspanel? No te preocupes, es uno de los problemas más comunes al gestionar un servidor, y lo bueno es que casi siempre tiene una solución sencilla. En esta guía extensa y fácil de seguir, vamos a desglosar los errores más frecuentes de la conexión FTP en Syspanel, cómo identificarlos y, lo más importante, cómo solucionarlos paso a paso. Tanto si eres un SysAdmin con experiencia como si estás empezando, aquí encontrarás respuestas claras y prácticas.

¿Por qué falla la conexión FTP en Syspanel?

Antes de meternos en soluciones concretas, es útil entender las causas raíz. Los errores de conexión FTP en Syspanel suelen deberse a una de estas tres razones principales: configuración incorrecta del cliente FTP, cortafuegos bloqueando el puerto, o credenciales mal introducidas. También puede ser que el servicio FTP no esté corriendo o que el usuario no tenga los permisos adecuados. Vamos a ver cada caso con detalle.

[INFO] Recuerda que Syspanel (basado en HestiaCP) gestiona los usuarios FTP de forma independiente a los usuarios del panel. No puedes usar las mismas credenciales que para acceder al panel (puerto 2106). Necesitas crear un usuario FTP específico desde la sección de "Usuarios FTP" de Syspanel.

Errores comunes al conectar por FTP y sus soluciones

1. Error de autenticación: "Login incorrecto" o "530 Authentication failed"

Este es, con diferencia, el error más habitual. Aparece cuando el cliente FTP (FileZilla, Cyberduck, etc.) no reconoce el usuario o la contraseña.

Posibles causas:

Has escrito mal el nombre de usuario o la contraseña.
Estás usando las credenciales del panel de Syspanel (puerto 2106) en lugar de las del FTP.
El usuario FTP ha sido eliminado o suspendido desde Syspanel.
La base de datos de usuarios FTP está corrupta (raro, pero posible).

Solución paso a paso:

Verifica las credenciales en Syspanel: Accede a tu Syspanel (https://tudominio.com:2106) y ve a la sección "Usuarios FTP". Allí verás la lista de usuarios. Si no aparece el que intentas usar, créalo de nuevo.
Reinicia el servicio FTP: A veces el servicio se queda colgado. Conéctate por SSH a tu servidor y ejecuta:
```
sudo systemctl restart vsftpd
```
(o proftpd si usas ese servidor).
Comprueba el archivo de usuarios: Si el problema persiste, revisa el archivo de configuración. Normalmente está en /etc/vsftpd/virtual_users. Puedes forzar una recarga con:
```
sudo /usr/local/hestia/bin/v-update-sys-ftp
```

[WARNING] No uses mayúsculas ni caracteres especiales en el nombre de usuario FTP. Syspanel los crea en minúsculas por defecto. Si lo escribes con mayúsculas, dará error.

2. Error de conexión: "No se puede conectar al servidor" o "Connection refused"

Este error indica que el cliente FTP no puede alcanzar el servidor. Puede ser por un problema de red, de cortafuegos o porque el servicio FTP no está escuchando.

Posibles causas:

El puerto FTP (21) está bloqueado por el firewall del servidor o de tu red local.
El servicio FTP no está instalado o no está activo.
El servidor está configurado para usar modo pasivo y el rango de puertos pasivos está bloqueado.
Syspanel tiene una opción de "Modo pasivo" que debes activar.

Solución paso a paso:

Comprueba si el servicio está activo: Desde SSH, ejecuta:
```
sudo systemctl status vsftpd
```
Si no está activo, inícialo con sudo systemctl start vsftpd.
Abre los puertos en el firewall: Si usas UFW (Ubuntu/Debian), permite el puerto 21 y el rango de puertos pasivos (por defecto 30000-31000):
```
sudo ufw allow 21/tcp
sudo ufw allow 30000:31000/tcp
```
Si usas CSF (ConfigServer Security & Firewall), añádelos en /etc/csf/csf.conf en las líneas TCP_IN y TCP_OUT.
Configura el modo pasivo en Syspanel: Ve a "Configuración del servidor" > "FTP" y asegúrate de que "Modo pasivo" esté habilitado. Anota el rango de puertos que aparece (normalmente 30000-31000).
Prueba con un cliente diferente: A veces el problema es del cliente. Prueba con FileZilla (modo pasivo por defecto) o con el comando ftp desde terminal.

[TIP] Si estás detrás de una VPN o proxy, es posible que bloqueen el puerto 21. Prueba a desconectarte de la VPN o usa un cliente que soporte FTP sobre TLS (FTPS) en el puerto 990.

3. Error de permisos: "550 Permission denied" o "No se puede acceder al directorio"

Este error ocurre cuando el usuario FTP tiene acceso, pero no puede leer, escribir o listar los archivos del directorio al que intenta acceder.

Posibles causas:

El directorio home del usuario FTP no existe o tiene permisos incorrectos.
El usuario FTP no es propietario de los archivos (por ejemplo, si los subiste por SSH como root).
Syspanel crea el usuario FTP con un directorio base que puede no coincidir con la ruta real de tu web.

Solución paso a paso:

Verifica el directorio home del usuario: En Syspanel, ve a "Usuarios FTP" y haz clic en el usuario. Verás la ruta del directorio (por ejemplo, /home/usuario/web/tudominio/public_html). Asegúrate de que esa carpeta exista.
Corrige los permisos: Conéctate por SSH y ejecuta:
```
sudo chown -R usuarioftp:usuarioftp /ruta/al/directorio
sudo chmod -R 755 /ruta/al/directorio
```
(Reemplaza usuarioftp por el nombre del usuario y la ruta por la correcta).
Reasigna el directorio base: Si el directorio no es el correcto, puedes cambiarlo desde Syspanel editando el usuario FTP. Pon la ruta exacta donde están tus archivos web.
Comprueba el archivo de configuración de vsftpd: A veces la directiva chroot_local_user=YES puede causar problemas. Si está activada, el usuario solo puede ver su directorio home. Si necesitas acceso a otras carpetas, desactívala (con cuidado).

[WARNING] No pongas permisos 777 a las carpetas. Es inseguro. Usa 755 para directorios y 644 para archivos.

4. Error de tiempo de espera: "Timeout" o "Conexión cerrada por el servidor"

Este error suele aparecer cuando la conexión se establece pero luego se cierra inesperadamente, o cuando el cliente se queda esperando una respuesta.

Posibles causas:

El servidor FTP tiene un límite de tiempo de inactividad muy bajo.
El modo pasivo no está bien configurado en el cliente o en el servidor.
El firewall está cerrando conexiones inactivas.

Solución paso a paso:

Aumenta el tiempo de espera en vsftpd: Edita /etc/vsftpd.conf y busca o añade:
```
idle_session_timeout=600
data_connection_timeout=300
```
Luego reinicia el servicio.
Configura el cliente FTP en modo pasivo: En FileZilla, ve a "Editar" > "Configuración" > "FTP" > "Modo de transferencia" y selecciona "Pasivo". También puedes forzar el uso de un proxy si es necesario.
Verifica el rango de puertos pasivos en el servidor: Asegúrate de que en /etc/vsftpd.conf tengas:
```
pasv_enable=YES
pasv_min_port=30000
pasv_max_port=31000
```
Prueba con FTPS (FTP sobre SSL): A veces el modo explícito (AUTH TLS) funciona mejor que el FTP puro. En Syspanel, activa "FTP Seguro" en la configuración del servidor y usa el puerto 990 en tu cliente.

[INFO] Si usas FileZilla, puedes ver los mensajes del servidor en la pestaña "Mensajes de registro". Allí suele aparecer el error exacto, como "425 Unable to build data connection". Eso te ayudará a diagnosticar.

5. Error de SSL/TLS: "No se pudo inicializar TLS" o "Certificado no válido"

Si has activado el FTP seguro (FTPS), pueden aparecer errores relacionados con certificados SSL.

Posibles causas:

El certificado SSL no está instalado correctamente en el servidor.
El cliente no confía en el certificado (por ejemplo, si es autofirmado).
El puerto 990 está bloqueado.

Solución paso a paso:

Genera un certificado SSL para FTP: Desde SSH, ejecuta:

sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/vsftpd.key -out /etc/ssl/certs/vsftpd.crt

Luego, en /etc/vsftpd.conf, añade:

rsa_cert_file=/etc/ssl/certs/vsftpd.crt
rsa_private_key_file=/etc/ssl/private/vsftpd.key
ssl_enable=YES

Configura el cliente para aceptar certificados autofirmados: En FileZilla, ve a "Editar" > "Configuración" > "FTP" > "FTPS" y desmarca "Requerir TLS explícito sobre FTP" si quieres usar FTP implícito (puerto 990). O bien, acepta el certificado la primera vez.
Abre el puerto 990 en el firewall:
```
sudo ufw allow 990/tcp
```

Preguntas Frecuentes (FAQ) sobre errores FTP en Syspanel

¿Cómo creo un usuario FTP en Syspanel?

Inicia sesión en tu Syspanel (puerto 2106).
Ve a "Usuarios FTP" y haz clic en "Añadir usuario".
Introduce un nombre de usuario (sin espacios), una contraseña segura y selecciona el dominio al que tendrá acceso.
Elige el directorio base (por defecto, la carpeta public_html del dominio).
Guarda. Las credenciales estarán listas para usar.

¿Qué puertos debo abrir para que funcione el FTP?

Puerto 21: Control (FTP o FTPS explícito).
Puerto 990: Control (FTPS implícito).
Rango 30000-31000: Datos en modo pasivo (puede variar según la configuración de Syspanel).

¿Por qué mi cliente FTP dice "Error de conexión" si el servicio está activo?

Revisa el firewall del servidor. A veces, incluso si el servicio corre, el firewall bloquea el puerto. También verifica que tu IP no esté en una lista negra (fail2ban). Puedes desbloquearla con:

sudo fail2ban-client set vsftpd unbanip TU_IP

¿Puedo usar el mismo usuario que uso para acceder al panel (puerto 2106) para FTP?

No. Syspanel separa las cuentas. El usuario del panel solo sirve para gestionar el servidor web, bases de datos, etc. Para FTP, debes crear un usuario específico desde la sección "Usuarios FTP".

¿Cómo sé si mi servidor FTP está usando vsftpd o proftpd?

Desde SSH, ejecuta:

sudo netstat -tulpn | grep :21

Te mostrará el proceso que está escuchando en el puerto 21. Normalmente, Syspanel usa vsftpd por defecto.

Conclusión: No te rindas, el FTP en Syspanel tiene solución

Los errores de conexión FTP pueden ser frustrantes, pero como has visto, casi siempre tienen una causa clara y una solución sencilla. Recuerda siempre verificar las credenciales, los puertos y los permisos. Si después de seguir todos estos pasos sigues teniendo problemas, no dudes en revisar los logs del servidor (/var/log/vsftpd.log o journalctl -u vsftpd) para obtener pistas más precisas.

Como SysAdmin, tener un conocimiento básico de cómo funciona el FTP en Syspanel te ahorrará muchos dolores de cabeza. Y si eres nuevo, no te preocupes: con esta guía podrás resolver el 90% de los incidentes. ¡Manos a la obra!

[TIP] Si necesitas una solución rápida y no quieres perder tiempo, siempre puedes usar SCP o SFTP (puerto 22) como alternativa. Syspanel también soporta SFTP, que es más seguro y no requiere configuraciones adicionales de puertos. Solo necesitas las credenciales de un usuario del sistema (no del panel).