Las conexiones FTP fallan. Fallan en la primera configuración, fallan después de meses de funcionar bien, y fallan de formas que te dan mensajes de error crípticos. Esta guía cubre los errores de conexión FTP y SFTP más comunes que encontrarás en Mac y cómo solucionar cada uno.

Timeout de conexión

Intentas conectar y no pasa nada. Después de 30-60 segundos, recibes un error de timeout.

Causas habituales:

  • Un firewall está bloqueando la conexión (el de tu Mac, el del router o el del servidor).
  • Estás usando el modo FTP Activo cuando necesitas el modo Pasivo. El modo activo requiere que el servidor se conecte de vuelta a tu Mac, cosa que la mayoría de routers NAT y firewalls bloquean.
  • El nombre de host o la dirección IP del servidor es incorrecta.
  • El servicio FTP del servidor no está ejecutándose.

Soluciones:

  • Cambia al modo FTP Pasivo. Esta es la configuración correcta para casi todas las conexiones modernas.
  • Comprueba el firewall de tu Mac: Ajustes del sistema > Red > Firewall. Asegúrate de que tu app FTP esté permitida.
  • Verifica el nombre del host haciendo un ping en Terminal: ping ftp.example.com
  • Prueba a conectar con otra app (como el comando sftp de Terminal) para descartar problemas específicos de la app.

Conexión rechazada

La conexión es rechazada inmediatamente, sin espera.

Causas habituales:

  • Puerto incorrecto. FTP usa el puerto 21, SFTP el puerto 22, FTPS Implícito el puerto 990.
  • El servicio FTP/SFTP no está ejecutándose en el servidor.
  • El firewall del servidor está bloqueando explícitamente tu IP.

Soluciones:

  • Comprueba el número de puerto. Esta es la causa más habitual.
  • Confirma con tu proveedor de servidor que FTP/SFTP está activado.
  • Pregunta si tu IP necesita ser añadida a la lista blanca.

530 Login incorrecto

Te conectas correctamente pero el login es rechazado.

Causas habituales:

  • Nombre de usuario o contraseña incorrectos. Copiar y pegar a veces añade espacios invisibles o saltos de línea.
  • La cuenta existe pero no está habilitada para acceso FTP (algunos paneles de alojamiento requieren habilitar FTP por separado).
  • Sensibilidad a mayúsculas. Algunos servidores tratan los nombres de usuario como sensibles a mayúsculas.

Soluciones:

  • Escribe las credenciales manualmente en lugar de pegarlas.
  • Entra al panel de control de tu alojamiento y verifica que la cuenta FTP está activa.
  • Prueba a conectar vía Terminal para ver la respuesta exacta del servidor: ftp ftp.example.com

425 No se puede abrir la conexión de datos

Inicias sesión correctamente pero los listados de archivos o las transferencias fallan con un error 425.

Causas habituales:

  • Desajuste entre modo Activo y Pasivo. El servidor no puede establecer el canal de datos.
  • Para FTPS: errores de reutilización de sesión TLS entre conexiones de control y datos.

Soluciones:

  • Cambia al modo Pasivo.
  • Para FTPS, prueba el modo Explícito en el puerto 21 en lugar del Implícito en el puerto 990, o viceversa.
  • Algunos servidores requieren versiones TLS específicas. Prueba a limitar a TLS 1.2 si está disponible en la configuración de tu cliente.

Error de handshake SSL/TLS

Específico de conexiones FTPS. La negociación de cifrado falla.

Causas habituales:

  • El certificado SSL del servidor ha expirado.
  • Te estás conectando con FTP plano a un puerto que espera FTPS, o viceversa.
  • Desajuste de versión TLS. El servidor requiere TLS 1.2 pero tu cliente intenta TLS 1.0.
  • Certificado autofirmado que tu cliente no confía.

Soluciones:

  • Asegúrate de que has seleccionado FTPS (no FTP plano) en la configuración de conexión.
  • Prueba los modos FTPS Explícito e Implícito.
  • Si el servidor usa un certificado autofirmado, comprueba si tu cliente tiene la opción de aceptarlo.
  • Contacta al administrador del servidor para verificar que el certificado es válido y las versiones TLS están configuradas correctamente.

Error de verificación de clave de host (SFTP)

Específico de SFTP. Tu Mac se niega a conectar porque la clave SSH del servidor no coincide con lo que espera.

Causas habituales:

  • El servidor fue reinstalado o sus claves SSH fueron regeneradas.
  • Te estás conectando por primera vez y la verificación estricta de host está activada.
  • Posible ataque man-in-the-middle (raro, pero para eso existe el aviso).

Soluciones:

  • Si sabes que el servidor fue reinstalado, elimina la clave antigua: ssh-keygen -R hostname
  • Reconecta y acepta la nueva clave cuando se te pida.
  • Si no esperabas un cambio de clave, verifica con el administrador del servidor antes de aceptar.

Permiso denegado

Te conectas e inicias sesión, pero no puedes leer archivos, escribir archivos o acceder a ciertos directorios.

Causas habituales:

  • Tu usuario FTP no tiene permisos de lectura/escritura en el directorio de destino.
  • La propiedad del directorio en el servidor no coincide con tu usuario FTP.
  • Restricciones de chroot/jail te impiden navegar fuera de tu directorio home.

Soluciones:

  • Contacta al administrador del servidor para verificar los permisos de tu cuenta.
  • Comprueba que la ruta remota en tu cliente FTP es correcta y accesible por tu usuario.
  • En servidores que controlas, verifica los permisos del directorio: ls -la /path/to/directory

Problemas específicos de Mac

Algunas cosas específicas de macOS:

  • macOS eliminó su servidor FTP integrado a partir de High Sierra (10.13). Si necesitas un servidor FTP en tu Mac, necesitarás software de terceros.
  • Las actualizaciones de macOS pueden romper SFTP. Actualizaciones mayores (especialmente Monterey) han sido reportadas como causa de problemas de conectividad SFTP para apps como Cyberduck y Transmit. Reiniciar el Mac o restablecer la configuración SSH suele solucionarlo.
  • Avisos de Gatekeeper pueden impedir que apps FTP recién descargadas se abran. Haz clic derecho en la app y selecciona Abrir, o ve a Ajustes del sistema > Privacidad y seguridad para permitirlo.