Solucionar problemas de FTP en DirectAdmin: Guía de errores frecuentes | SysAdmin

¿Tienes problemas para conectar con tu servidor mediante FTP en DirectAdmin? No te preocupes, es una de las consultas más frecuentes que recibimos. En esta guía extensa y detallada, vamos a recorrer juntos los errores más comunes de FTP en DirectAdmin y, paso a paso, cómo solucionarlos.

Vamos a empezar con lo básico, para que incluso si eres nuevo en esto, puedas seguir sin problemas. Recuerda que el FTP es una herramienta esencial para subir archivos de tu web, modificar contenido o hacer copias de seguridad. Cuando falla, puede ser frustrante, pero casi siempre tiene una solución sencilla.

¿Por qué falla la conexión FTP en DirectAdmin? Causas comunes

Antes de meternos en soluciones técnicas, es bueno entender qué puede estar pasando. Los problemas de FTP en DirectAdmin suelen dividirse en tres grandes grupos:

Errores de autenticación: Usuario o contraseña incorrectos, o permisos mal configurados.
Errores de conexión: El servidor no responde, el puerto está bloqueado o el firewall lo impide.
Errores de configuración del cliente FTP: Ajustes incorrectos en FileZilla, Cyberduck u otro programa.

Vamos a ver cada uno con detalle.

## 1. Error: "No se puede conectar al servidor" o "Conexión rechazada"

Este es el error más común. Cuando intentas conectar y ves un mensaje como "Conexión rechazada" o "No se puede establecer la conexión", el problema suele estar en la red o en el propio servidor.

### 1.1. Verifica que el servicio FTP esté corriendo en DirectAdmin

Lo primero es asegurarte de que el servicio de FTP (normalmente Pure-FTPd o ProFTPd) esté activo en tu servidor.

Pasos para verificarlo desde DirectAdmin:

Inicia sesión en tu panel de DirectAdmin como administrador o usuario con permisos.
Ve a Admin Level -> Services Monitor.
Busca en la lista servicios como pure-ftpd o proftpd. Debe aparecer con un estado Running (en ejecución) y un check verde.
Si aparece como Stopped (detenido), haz clic en el botón Start para iniciarlo.

[INFO] Si no ves el servicio, puede que no esté instalado. En ese caso, contacta con tu proveedor de hosting o, si tienes acceso root, instálalo con el gestor de paquetes de tu sistema (ej. yum install pure-ftpd en CentOS).

### 1.2. Comprueba que el puerto FTP no esté bloqueado

Por defecto, el FTP usa el puerto 21 para la conexión de control. Si tu firewall (como CSF o iptables) lo bloquea, no podrás conectar.

Cómo verificarlo:

Desde DirectAdmin, ve a Admin Level -> Firewall Configuration (si usas CSF).
Busca la entrada para el puerto 21 (TCP) y asegúrate de que esté permitido.
Si no aparece, añádelo manualmente: TCP_IN = "21, ..." y luego reinicia el firewall.

[WARNING] Si tienes un firewall en tu ordenador local (Windows Defender, McAfee, etc.), también puede bloquear la conexión. Prueba a desactivarlo temporalmente para descartarlo.

### 1.3. Modo pasivo vs. activo: el problema de los puertos altos

El FTP tiene dos modos de transferencia de datos: activo y pasivo. El modo pasivo es el más común y recomendado para usuarios detrás de routers o firewalls.

En modo pasivo, el servidor FTP abre un rango de puertos altos (ej. 30000-50000) para la transferencia de datos. Si estos puertos están bloqueados, la conexión fallará.

Configuración en DirectAdmin:

Ve a Admin Level -> FTP Settings (o edita el archivo de configuración de Pure-FTPd en /etc/pure-ftpd/pure-ftpd.conf).
Busca la línea PassivePortRange o PassivePorts y asegúrate de que tenga un rango definido, por ejemplo: 30000 50000.
Guarda los cambios y reinicia el servicio FTP.

Configuración en tu cliente FTP (FileZilla):

Abre FileZilla y ve a Editar -> Configuración -> FTP -> Modo pasivo.
Marca la opción "Usar modo pasivo" (recomendado).
Si tu servidor usa un rango específico, puedes configurarlo en Modo pasivo -> Limitar el rango de puertos locales (aunque esto no suele ser necesario).

## 2. Error: "Usuario o contraseña incorrectos"

Este error es muy claro, pero a veces la solución no es tan obvia. Puede que el usuario o la contraseña sean correctos, pero el sistema los rechace.

### 2.1. Verifica que el usuario FTP existe y tiene permisos

En DirectAdmin, los usuarios FTP se crean dentro de cada cuenta de usuario. Asegúrate de que el usuario que estás usando esté creado correctamente.

Pasos:

Inicia sesión en DirectAdmin como User Level (el usuario de tu cuenta).
Ve a FTP Management -> FTP Accounts.
Revisa la lista de usuarios. Si el que intentas usar no aparece, créalo de nuevo.
Si aparece, puedes hacer clic en Edit para cambiar la contraseña o verificar los permisos.

### 2.2. Problemas con la contraseña: caracteres especiales

A veces, las contraseñas con caracteres como $, #, @ o espacios pueden dar problemas. El sistema puede interpretarlos mal.

[TIP] Prueba a cambiar la contraseña por una más simple, solo con letras y números, para descartar este problema. Luego, si funciona, puedes poner una más segura.

### 2.3. El usuario FTP no tiene acceso a la carpeta correcta

Cada usuario FTP tiene asignado un directorio raíz (home). Si el directorio no existe o tiene permisos incorrectos, no podrás iniciar sesión.

Cómo verificarlo:

En DirectAdmin, ve a FTP Management -> FTP Accounts.
Haz clic en Edit junto al usuario problemático.
Revisa el campo Home Directory. Debería ser algo como /home/usuario/domains/tudominio.com/public_html.
Si el directorio no existe, créalo manualmente desde el administrador de archivos o mediante SSH.

## 3. Error: "No se puede obtener la lista de directorios"

Este error aparece después de conectar, cuando intentas ver los archivos. Es muy común y casi siempre está relacionado con el modo pasivo o los permisos de directorio.

### 3.1. Ajusta el modo de transferencia en tu cliente FTP

Como ya mencionamos, el modo pasivo es el estándar. Pero a veces el cliente FTP intenta usar modo activo y falla.

En FileZilla:

Ve a Editar -> Configuración -> FTP -> Modo pasivo.
Asegúrate de que Modo pasivo (recomendado) esté seleccionado.
También puedes probar con Modo activo para ver si funciona (aunque es menos probable).

### 3.2. Permisos de la carpeta raíz

Si la carpeta a la que apunta el usuario FTP tiene permisos demasiado restrictivos (por ejemplo, 700 en lugar de 755), el cliente no podrá leer su contenido.

Solución:

Conéctate por SSH o usando el administrador de archivos de DirectAdmin.
Ve a la carpeta raíz del usuario FTP.

Cambia los permisos a 755 para carpetas y 644 para archivos. Puedes hacerlo con el comando:

find /home/usuario/domains/tudominio.com/public_html -type d -exec chmod 755 {} \;
find /home/usuario/domains/tudominio.com/public_html -type f -exec chmod 644 {} \;

[WARNING] No cambies los permisos de carpetas del sistema como /etc o /bin. Solo las carpetas de tu cuenta de hosting.

### 3.3. Firewall o router bloqueando puertos altos

Si el rango de puertos pasivos (30000-50000) está bloqueado en tu router local o en el firewall del servidor, la lista de directorios fallará.

Verifica desde tu red local:

Prueba a conectar desde una red diferente (por ejemplo, usando los datos móviles de tu teléfono como hotspot).
Si funciona, el problema está en tu router local. Abre los puertos en tu router o desactiva temporalmente el firewall.

## 4. Error: "Tiempo de espera agotado" (Timeout)

Este error significa que el servidor no responde dentro del tiempo esperado. Puede deberse a lentitud de la red, servidor sobrecargado o configuración incorrecta del cliente.

### 4.1. Aumenta el tiempo de espera en tu cliente FTP

En FileZilla, puedes aumentar el tiempo de espera para conexiones lentas:

Ve a Editar -> Configuración -> FTP -> Tiempo de espera.
Aumenta el valor de Tiempo de espera de conexión a 60 segundos o más.
También puedes aumentar el Tiempo de espera de transferencia.

### 4.2. Comprueba la carga del servidor

Si el servidor está muy cargado, puede tardar en responder. Desde DirectAdmin, ve a Admin Level -> System Information para ver el uso de CPU y memoria.

[INFO] Si ves un uso elevado de recursos, contacta con tu proveedor de hosting para que revise el servidor.

## 5. Problemas con SSL/TLS en FTP (FTPES)

Muchos servidores modernos exigen conexiones cifradas (FTPES). Si tu cliente no lo soporta o está mal configurado, no conectarás.

### 5.1. Configura FileZilla para usar FTPES

En FileZilla, al crear una nueva conexión, en el campo Protocolo selecciona FTP - Protocolo de transferencia de archivos.
En Cifrado, elige Requiere cifrado TLS explícito sobre FTP (FTPES).
Introduce tu servidor, usuario y contraseña, y conecta.

### 5.2. Verifica que el servidor soporte SSL

En DirectAdmin, ve a Admin Level -> FTP Settings y asegúrate de que la opción SSL/TLS esté habilitada.

## 6. Problemas con Syspanel (HestiaCP) y FTP

Si estás usando Syspanel (el nuevo nombre de HestiaCP, que accedes por el puerto 2106), el manejo de FTP es similar pero con algunas particularidades.

[TIP] En Syspanel, los usuarios FTP se gestionan desde Panel -> Usuarios FTP. Asegúrate de que el usuario esté creado y que la contraseña no tenga caracteres extraños.

Pasos para solucionar problemas de FTP en Syspanel:

Accede a Syspanel a través de https://tudominio.com:2106.
Ve a Panel -> Usuarios FTP.
Si el usuario no aparece, créalo de nuevo.
Si aparece pero no conecta, prueba a cambiar la contraseña.
Verifica que el servicio FTP esté activo en Panel -> Servicios.

## Preguntas Frecuentes (FAQ)

P: ¿Qué puerto usa FTP en DirectAdmin?
R: Por defecto, el puerto 21 para la conexión de control y un rango de puertos altos (ej. 30000-50000) para datos en modo pasivo.

P: ¿Cómo cambio la contraseña de un usuario FTP en DirectAdmin?
R: Ve a FTP Management -> FTP Accounts, haz clic en Edit junto al usuario y escribe la nueva contraseña.

P: ¿Por qué mi FTP funciona en casa pero no en el trabajo?
R: Probablemente el firewall de tu trabajo bloquea el puerto 21 o los puertos pasivos. Prueba a usar SFTP (puerto 22) si está disponible.

P: ¿Qué es mejor, FTP o SFTP?
R: SFTP es más seguro porque cifra toda la conexión. Si tu servidor lo soporta (DirectAdmin suele tener SSH habilitado), úsalo.

P: ¿Cómo habilito el modo pasivo en el servidor?
R: En DirectAdmin, ve a Admin Level -> FTP Settings y configura el rango de puertos pasivos. Luego reinicia el servicio FTP.

P: ¿Puedo usar FTP anónimo en DirectAdmin?
R: No, por seguridad. Solo usuarios autenticados pueden acceder.

P: ¿Qué hago si sigo sin poder conectar?
R: Contacta con tu proveedor de hosting. Proporciónales el mensaje de error exacto de tu cliente FTP.

## Resumen y recomendaciones finales

Los problemas de FTP en DirectAdmin son comunes pero casi siempre solucionables. Aquí tienes un checklist rápido para cuando te enfrentes a un error:

Verifica que el servicio FTP esté corriendo en el servidor.
Comprueba los puertos (21 y rango pasivo) no estén bloqueados.
Revisa el usuario y contraseña en DirectAdmin.
Ajusta el modo pasivo en tu cliente FTP.
Aumenta el tiempo de espera si hay lentitud.
Usa FTPES (SSL) si el servidor lo requiere.
Si nada funciona, prueba con SFTP (puerto 22) como alternativa.

Recuerda que la paciencia y el método son tus mejores aliados. Con esta guía, deberías poder resolver la mayoría de los problemas por ti mismo. ¡Buena suerte!