Résolution des erreurs de connexion FTP sur Mac

Les connexions FTP échouent. Elles échouent lors de la première configuration, elles échouent après des mois de fonctionnement, et elles échouent de manières qui vous donnent des messages d'erreur cryptiques. Ce guide couvre les erreurs de connexion FTP et SFTP les plus courantes que vous rencontrerez sur Mac et comment résoudre chacune d'elles.

Timeout de connexion

Vous essayez de vous connecter et rien ne se passe. Après 30-60 secondes, vous recevez une erreur de timeout.

Causes courantes :

• Un pare-feu bloque la connexion (celui de votre Mac, de votre routeur ou du serveur).
• Vous utilisez le mode FTP Actif alors que vous avez besoin du mode Passif. Le mode actif nécessite que le serveur se reconnecte à votre Mac, ce que la plupart des routeurs NAT et pare-feu bloquent.
• Le nom d'hôte ou l'adresse IP du serveur est incorrect.
• Le service FTP du serveur ne tourne pas.

Solutions :

• Passez en mode FTP Passif. C'est le réglage correct pour presque toutes les connexions modernes.
• Vérifiez le pare-feu de votre Mac : Réglages du système > Réseau > Pare-feu. Assurez-vous que votre app FTP est autorisée.
• Vérifiez le nom d'hôte en le pingant dans Terminal : ping ftp.example.com
• Essayez de vous connecter avec une autre app (comme la commande sftp de Terminal) pour éliminer les problèmes spécifiques à l'app.

Connexion refusée

La connexion est rejetée immédiatement, sans attente.

Causes courantes :

• Port incorrect. FTP utilise le port 21, SFTP le port 22, FTPS Implicite le port 990.
• Le service FTP/SFTP ne tourne pas sur le serveur.
• Le pare-feu du serveur bloque explicitement votre IP.

Solutions :

• Vérifiez le numéro de port. C'est la cause la plus courante.
• Confirmez avec votre fournisseur de serveur que FTP/SFTP est activé.
• Demandez si votre IP doit être mise en liste blanche.

530 Login incorrect

Vous vous connectez correctement mais le login est rejeté.

Causes courantes :

• Nom d'utilisateur ou mot de passe incorrect. Le copier-coller ajoute parfois des espaces invisibles ou des sauts de ligne.
• Le compte existe mais n'est pas activé pour l'accès FTP (certains panneaux d'hébergement nécessitent d'activer FTP séparément).
• Sensibilité à la casse. Certains serveurs traitent les noms d'utilisateur comme sensibles à la casse.

Solutions :

• Tapez les identifiants manuellement au lieu de les coller.
• Connectez-vous à votre panneau de contrôle d'hébergement et vérifiez que le compte FTP est actif.
• Essayez de vous connecter via Terminal pour voir la réponse exacte du serveur : ftp ftp.example.com

425 Impossible d'ouvrir la connexion de données

Vous vous connectez correctement mais les listages de fichiers ou les transferts échouent avec une erreur 425.

Causes courantes :

• Décalage entre mode Actif et Passif. Le serveur ne peut pas établir le canal de données.
• Pour FTPS : échecs de réutilisation de session TLS entre connexions de contrôle et de données.

Solutions :

• Passez en mode Passif.
• Pour FTPS, essayez le mode Explicite sur le port 21 au lieu de l'Implicite sur le port 990, ou inversement.
• Certains serveurs nécessitent des versions TLS spécifiques. Essayez de limiter à TLS 1.2 si disponible dans les paramètres de votre client.

Échec du handshake SSL/TLS

Spécifique aux connexions FTPS. La négociation de chiffrement échoue.

Causes courantes :

• Le certificat SSL du serveur a expiré.
• Vous vous connectez en FTP simple à un port qui attend du FTPS, ou inversement.
• Décalage de version TLS. Le serveur exige TLS 1.2 mais votre client essaie TLS 1.0.
• Certificat auto-signé que votre client ne reconnaît pas.

Solutions :

• Assurez-vous d'avoir sélectionné FTPS (pas FTP simple) dans vos paramètres de connexion.
• Essayez les deux modes FTPS Explicite et Implicite.
• Si le serveur utilise un certificat auto-signé, vérifiez si votre client a une option pour l'accepter.
• Contactez l'administrateur du serveur pour vérifier que le certificat est valide et que les versions TLS sont correctement configurées.

Échec de vérification de la clé hôte (SFTP)

Spécifique à SFTP. Votre Mac refuse de se connecter car la clé SSH du serveur ne correspond pas à ce qu'il attend.

Causes courantes :

• Le serveur a été réinstallé ou ses clés SSH ont été régénérées.
• Vous vous connectez pour la première fois et la vérification stricte de l'hôte est activée.
• Possible attaque man-in-the-middle (rare, mais c'est pour cela que l'avertissement existe).

Solutions :

• Si vous savez que le serveur a été réinstallé, supprimez l'ancienne clé : ssh-keygen -R hostname
• Reconnectez-vous et acceptez la nouvelle clé quand on vous le demande.
• Si vous ne vous attendiez pas à un changement de clé, vérifiez avec l'administrateur du serveur avant d'accepter.

Permission refusée

Vous vous connectez et vous vous identifiez, mais vous ne pouvez pas lire de fichiers, écrire de fichiers ou accéder à certains répertoires.

Causes courantes :

• Votre utilisateur FTP n'a pas les permissions de lecture/écriture sur le répertoire cible.
• La propriété du répertoire sur le serveur ne correspond pas à votre utilisateur FTP.
• Les restrictions chroot/jail vous empêchent de naviguer en dehors de votre répertoire personnel.

Solutions :

• Contactez l'administrateur du serveur pour vérifier les permissions de votre compte.
• Vérifiez que le chemin distant dans votre client FTP est correct et accessible par votre utilisateur.
• Sur les serveurs que vous contrôlez, vérifiez les permissions du répertoire : ls -la /path/to/directory

Problèmes spécifiques au Mac

Quelques points spécifiques à macOS :

• macOS a supprimé son serveur FTP intégré à partir de High Sierra (10.13). Si vous avez besoin d'un serveur FTP sur votre Mac, vous aurez besoin d'un logiciel tiers.
• Les mises à jour de macOS peuvent casser SFTP. Les mises à jour majeures (notamment Monterey) ont été signalées comme cassant la connectivité SFTP pour des apps comme Cyberduck et Transmit. Redémarrer votre Mac ou réinitialiser la configuration SSH résout généralement le problème.
• Les avertissements de Gatekeeper peuvent empêcher l'ouverture d'apps FTP nouvellement téléchargées. Faites un clic droit sur l'app et sélectionnez Ouvrir, ou allez dans Réglages du système > Confidentialité et sécurité pour l'autoriser.