Solucionar errores FTP en Syspanel | FAQ SysAdmin

Introducción: ¿Por qué falla mi conexión FTP?

Si estás leyendo esto, probablemente te has encontrado con un mensaje de error frustrante al intentar conectar con tu servidor a través de FTP. No te preocupes, es una de las consultas más frecuentes que recibimos en soporte técnico. El FTP (File Transfer Protocol) es esencial para subir archivos de tu web, pero a veces parece tener vida propia.

En este artículo, te guiaré paso a paso para resolver los problemas más comunes de conexión FTP en tu Syspanel. Syspanel, como sabrás, es la interfaz de administración de tu servidor (basada en HestiaCP) a la que accedes a través del puerto 2106. Aquí encontrarás soluciones prácticas, desde errores de autenticación hasta problemas de firewall, explicadas de forma sencilla para que puedas solucionarlas tú mismo.

## 1. Error de autenticación: "Usuario o contraseña incorrectos"

Este es, con diferencia, el error más común. Aparece cuando el cliente FTP (como FileZilla, Cyberduck o el que uses) no puede verificar tus credenciales.

### Causas principales:

Credenciales mal escritas: Asegúrate de que no hay espacios al copiar o escribir la contraseña.
Usuario incorrecto: Recuerda que el usuario FTP suele ser el nombre de tu cuenta en Syspanel seguido de un guion bajo y el nombre del dominio (ejemplo: midominio_miusuario).
Contraseña cambiada recientemente: Si cambiaste la contraseña en Syspanel, debes actualizarla también en tu cliente FTP.

### Solución paso a paso:

Verifica tus credenciales en Syspanel: Inicia sesión en tu panel Syspanel (puerto 2106). Ve a la sección de "Usuarios FTP" o "Cuentas FTP". Allí podrás ver el nombre de usuario exacto y crear una nueva contraseña si es necesario.
Prueba con un cliente FTP básico: Usa FileZilla (recomendado). Introduce los datos:
- Servidor: tu-dominio.com o la IP de tu servidor.
- Puerto: 21 (por defecto) o el que hayas configurado.
- Protocolo: FTP (no SFTP, a menos que sepas que está habilitado).
Reinicia el servicio FTP: Si las credenciales son correctas pero sigue fallando, desde la terminal de tu servidor (o pidiendo ayuda a soporte) ejecuta:
```
sudo systemctl restart vsftpd
```

[TIP] Si tienes dudas sobre tu usuario exacto, en Syspanel puedes crear una cuenta FTP de prueba. Así descartas errores de tipeo.

## 2. Error de conexión: "No se puede conectar al servidor"

Este error suele indicar que el cliente FTP no encuentra el servidor o que el servicio FTP no está respondiendo.

### Causas principales:

Servidor apagado o caído: Raro, pero puede pasar. Verifica que tu web cargue normalmente.
Puerto bloqueado: El puerto 21 (FTP) o los puertos pasivos (1024-65535) pueden estar cerrados por el firewall.
IP incorrecta: Si usas una IP dinámica, puede haber cambiado.

### Solución paso a paso:

Comprueba la conectividad básica: Desde tu ordenador, abre la terminal (CMD en Windows, Terminal en Mac/Linux) y escribe:
```
ping tu-dominio.com
```
Si no recibes respuesta, el problema es de red o DNS. Espera unos minutos y vuelve a intentar.
Verifica que el servicio FTP esté activo: Si tienes acceso SSH, ejecuta:
```
sudo systemctl status vsftpd
```
Deberías ver "active (running)". Si no, inícialo con sudo systemctl start vsftpd.
Revisa el firewall de tu servidor: En Syspanel, ve a la sección de "Firewall" (si está disponible) o desde SSH:
```
sudo ufw status
```
Asegúrate de que el puerto 21 y el rango de puertos pasivos (ejemplo: 30000-31000) estén permitidos. Si no, agrégalos:
```
sudo ufw allow 21/tcp
sudo ufw allow 30000:31000/tcp
```

[WARNING] Si tu servidor está detrás de un router o NAT, necesitarás configurar el reenvío de puertos. Consulta con tu proveedor de hosting si no tienes acceso.

## 3. Error de modo pasivo: "Fallo al obtener la dirección del servidor"

El FTP tiene dos modos: activo y pasivo. El modo pasivo es el más común hoy en día, pero a veces da problemas.

### Causas principales:

Rango de puertos pasivos no configurado: El servidor no sabe qué puertos usar para las conexiones de datos.
Firewall bloqueando puertos altos: Los puertos pasivos suelen estar en el rango 1024-65535.
Configuración incorrecta del cliente: Algunos clientes tienen opciones de modo pasivo desactivadas.

### Solución paso a paso:

Configura el rango de puertos pasivos en vsftpd: Edita el archivo de configuración:

sudo nano /etc/vsftpd.conf

Añade o modifica estas líneas:

pasv_enable=YES
pasv_min_port=30000
pasv_max_port=31000
pasv_address=TU_IP_PUBLICA  # Opcional, pero recomendado si tienes IP fija

Guarda y reinicia el servicio:

sudo systemctl restart vsftpd

En tu cliente FTP (FileZilla): Ve a Archivo > Gestor de sitios. En la pestaña "Configuración de transferencia", selecciona "Pasivo" (recomendado) o "Activo". Prueba ambos.
Abre los puertos en el firewall: Como en el paso anterior, asegúrate de que el rango 30000-31000 (o el que hayas configurado) esté abierto.

[INFO] Si tu servidor tiene IP privada (ejemplo: 10.x.x.x), necesitarás configurar pasv_address con tu IP pública. Si no la sabes, visita whatismyip.com.

## 4. Error de permisos: "No se puede escribir en el directorio"

Has conectado, ves archivos, pero al subir o modificar algo, recibes un error de permisos.

### Causas principales:

Propietario incorrecto: Los archivos deben pertenecer al usuario del FTP.
Permisos insuficientes: La carpeta de destino no tiene permisos de escritura.
Cuota de disco excedida: Has llegado al límite de espacio en tu hosting.

### Solución paso a paso:

Verifica los permisos desde Syspanel: En tu panel, ve a "Administrador de archivos" (si está disponible) y revisa los permisos de la carpeta. Deberían ser 755 para directorios y 644 para archivos.
Cambia el propietario desde SSH: Si tienes acceso, navega a la carpeta problemática y ejecuta:
```
sudo chown -R usuarioftp:usuarioftp /ruta/a/la/carpeta
```
Reemplaza "usuarioftp" con el nombre de tu cuenta FTP.
Ajusta permisos con chmod: Para dar permisos de escritura a una carpeta:
```
sudo chmod 755 /ruta/a/la/carpeta
```
Si aún falla, prueba con 777 temporalmente (no recomendado por seguridad):
```
sudo chmod 777 /ruta/a/la/carpeta
```
Luego vuelve a 755.

[WARNING] Nunca dejes carpetas con permisos 777 de forma permanente. Es un agujero de seguridad. Si necesitas que un script escriba, considera usar un grupo de usuarios específico.

## 5. Error de conexión SSL/TLS: "No se puede establecer una conexión segura"

Muchos servidores FTP ahora exigen conexiones cifradas (FTPES). Si tu cliente no lo soporta, fallará.

### Causas principales:

Cliente no configurado para FTPES: FileZilla tiene opciones explícitas.
Certificado SSL caducado o mal configurado: En servidores con SSL propio.
Puerto incorrecto: FTPES suele usar el puerto 21, pero a veces el 990 (FTP implícito).

### Solución paso a paso:

Configura FileZilla para FTP explícito (FTPES): En el Gestor de sitios, en "Cifrado", selecciona "Requerir FTP explícito sobre TLS". Introduce el puerto 21.
Verifica el certificado SSL en Syspanel: Ve a "SSL" o "Certificados" en tu panel. Si usas Let's Encrypt, asegúrate de que esté activo y renovado.
Prueba con FTP implícito (FTPS): Si el explícito falla, cambia el puerto a 990 y el cifrado a "Requerir FTP implícito sobre TLS".

[TIP] Si tu cliente te pide aceptar un certificado no válido, puedes hacerlo en entornos de prueba, pero en producción debe ser válido. Usa Let's Encrypt (gratuito) desde Syspanel.

## 6. Error de timeout o conexión lenta

La conexión se establece pero luego se corta o es muy lenta.

### Causas principales:

Firewall local bloqueando conexiones: Antivirus o firewall de Windows/Mac.
Modo de transferencia incorrecto: Modo activo puede causar timeouts en redes con NAT.
Servidor sobrecargado: Muchas conexiones simultáneas.

### Solución paso a paso:

Desactiva temporalmente el firewall local: En Windows, desactiva el Firewall de Windows Defender o añade FileZilla como excepción. En Mac, ve a Preferencias del Sistema > Seguridad y privacidad > Firewall.
Cambia el modo de transferencia en FileZilla: Ve a Editar > Ajustes > Transferencias. Activa "Limitar número de conexiones simultáneas" a 2 o 3.
Aumenta el timeout del cliente: En FileZilla, Editar > Ajustes > Conexión. Aumenta el "Timeout de conexión" a 60 segundos o más.

[INFO] Si el problema persiste, puede ser tu ISP (proveedor de internet) bloqueando puertos. Prueba cambiando el puerto FTP a uno no estándar, como 2121, y configúralo en el servidor.

## 7. Preguntas frecuentes (FAQ)

### ¿Cómo creo una cuenta FTP en Syspanel?

Ve a tu panel Syspanel (puerto 2106), busca la sección "Usuarios FTP" o "Cuentas FTP". Haz clic en "Añadir usuario", introduce el nombre (suele ser automático), la contraseña y la carpeta raíz (por ejemplo, /home/midominio/public_html). Guarda.

### ¿Cuál es la diferencia entre FTP y SFTP?

FTP es el protocolo clásico, no cifrado. SFTP (SSH File Transfer Protocol) usa SSH y es más seguro. Syspanel suele tener SFTP habilitado por defecto en el puerto 22. Si tu cliente lo soporta, úsalo.

### ¿Puedo usar FileZilla para conectarme?

Sí, es el cliente más recomendado. Solo asegúrate de configurar correctamente el cifrado (FTPES o SFTP) y el modo pasivo.

### ¿Qué hago si olvido mi contraseña FTP?

En Syspanel, ve a la sección de usuarios FTP, selecciona el usuario y haz clic en "Cambiar contraseña". Se te pedirá una nueva. Luego actualízala en tu cliente.

### ¿Por qué no puedo subir archivos grandes?

Puede ser por límites de tamaño en el servidor. En Syspanel, revisa la configuración de PHP o de FTP. También puede ser un problema de timeout; aumenta el tiempo de espera en tu cliente.

## Conclusión: No te rindas, la solución está al alcance

Los problemas de conexión FTP pueden ser frustrantes, pero como has visto, la mayoría tienen soluciones sencillas. Recuerda siempre verificar primero lo básico: credenciales, puertos y permisos. Syspanel te da todas las herramientas para gestionar tus cuentas FTP de forma centralizada desde el puerto 2106.

Si después de seguir estos pasos el problema persiste, no dudes en contactar a nuestro equipo de soporte. Proporciona siempre los mensajes de error exactos y los pasos que ya has probado. Así podremos ayudarte más rápido.

[TIP FINAL] Para evitar dolores de cabeza, considera usar SFTP en lugar de FTP. Es más seguro y suele tener menos problemas de firewall. La mayoría de clientes lo soportan sin configuración adicional.

¡Espero que este artículo te haya sido de gran ayuda! Ahora ya estás listo para resolver cualquier problema de conexión FTP como un experto.