Introduction

Les messages Type « Connection timed out after 20 seconds of inactivity », « MLSD Error: Connection timed out » ou « 425 Can't open data connection » indiquent que FileZilla n’a pas pu établir (ou conserver) la connexion de commande ou la connexion de données. Les causes courantes : identifiants/protocole incorrects, mode actif/passif mal configuré, ports passifs non ouverts côté serveur ou blocage par un pare‑feu/NAT. Ce guide vous donne un ordre de vérifications simple, des réglages précis dans FileZilla et la liste d’éléments à fournir au support si nécessaire.

Prérequis

  • Accès à votre cPanel pour vérifier ou recréer le compte FTP : Comment accéder à mon compte cPanel?.
  • Un compte FTP valide (nom d’utilisateur, mot de passe, hôte) — si vous avez besoin d’en créer un, suivez : Comment créer un compte FTP.
  • FileZilla installé (version récente recommandée) sur votre poste.
  • Si vous êtes derrière une box/routeur : possibilité d’accéder aux réglages ou de contacter votre administrateur réseau (NAT/pare‑feu peut bloquer les connexions de données FTP).

Vérifications rapides (diagnostic — 2 minutes)

  1. Recopiez l’hôte, le nom d’utilisateur et le port depuis cPanel → Files → FTP Accounts → Configure FTP Client → « Manual Settings » pour éviter une erreur de frappe (voir Ressources officielles).
  2. Essayez SFTP (port 22) si votre hébergeur le propose : SFTP utilise SSH et fonctionne souvent quand FTP/FTPS échoue.
  3. Si la connexion s’établit mais l’affichage du dossier échoue (MLSD/Listing) : passez FileZilla en mode passif et contactez le support pour vérifier la plage de ports passive côté serveur.
  4. Si le message précise un délai (20 s, 30 s…) : augmentez le timeout côté FileZilla (voir Réglages FileZilla).

Procédure pas à pas (ordre recommandé)

  1. Vérifier et copier les paramètres côté serveur (cPanel)
    1. Ouvrez cPanel → Files → FTP Accounts puis cliquez sur Configure FTP Client pour afficher les « Manual Settings ». Copiez Host, Port et le protocole recommandé par le serveur.
  2. Configurer le site dans FileZilla (Site Manager)
    1. Ouvrez FileZilla → Fichier → Site Manager (ou Ctrl+S) → New Site.
    2. Renseignez :
      • Host : collez l’hôte fourni par cPanel (domain ou serveur).
      • Port : 22 pour SFTP ; 21 pour FTP/FTPS explicite (sauf indication contraire du fournisseur).
      • Protocol : préférez SFTP — SSH File Transfer Protocol si le serveur le propose. Sinon choisissez FTP et pour Encryption sélectionnez « explicit FTP over TLS » / FTPS explicite si recommandé.
      • Logon Type : Normal → Username et Password (ou l’option fournie par votre hébergeur).
    3. Onglet Transfer Settings → sélectionnez Passive (mode conseillé si vous êtes derrière une box/NAT). Enregistrez et testez la connexion.
  3. Augmenter le timeout et activer keep‑alive côté client
    1. FileZilla → Édition → Paramètres → Connexion → augmentez le Timeout à 60–120 s (ou plus selon la latence).
    2. Si disponible, activez l’option d’envoi périodique de commandes « keep‑alive » (préserve la connexion de commande entre opérations longues).
  4. Si la liste des fichiers échoue (erreur MLSD / data connection)
    1. Assurez‑vous que FileZilla est en mode Passive et demandez au support d’ouvrir la plage de ports passive côté serveur (voir Ressources officielles). Sans ces ports ouverts, la connexion de données ne pourra pas s’établir.
    2. Indiquez au support si votre serveur est derrière un NAT : le serveur FTP doit renvoyer sa IP publique (paramètre « MasqueradeAddress » ou équivalent) pour que le client puisse joindre la connexion de données.
  5. Si FTPS échoue (TLS / certificat)
    1. Vérifiez que vous utilisez l’hôte exact fourni par cPanel (utiliser une IP peut provoquer des erreurs TLS si le certificat est émis pour un nom d’hôte).
    2. Si l’FTPS explicite (AUTH TLS sur le port 21) ne fonctionne pas, essayez SFTP (port 22) si autorisé par l’hébergeur.
  6. Solution de contournement
    1. Si l’accès FTP est désactivé par l’hébergeur ou impossible à stabiliser, utilisez le Gestionnaire de fichiers cPanel pour téléverser vos fichiers : Comment ajouter des fichiers sur mon espace d’hébergement web sur cPanel ?.

Checklist précise pour FileZilla (récapitulatif à suivre)

  • Fichier → Site Manager → New Site : Host (coller depuis cPanel), Port (22 pour SFTP, 21 pour FTP), Protocol (SFTP si possible), Encryption (FTPS explicite si FTP).
  • Logon Type = Normal → Username / Password (coller depuis cPanel → Configure FTP Client → Manual Settings).
  • Transfer Settings → Transfer mode = Passive.
  • Édition → Paramètres → Connexion → Timeout = 60–120 s ; activer keep‑alive si nécessaire.
Tableau de bord cPanel centré sur la section Files avec accès aux outils
Tableau de bord cPanel — repérez la section Files (parmi les outils) pour accéder à FTP Accounts et au bouton Configure FTP Client. (Capture recadrée sur la zone utile.)
Gestionnaire de fichiers cPanel — alternative pour téléverser des fichiers si FTP est indisponible
Si l’accès FTP est indisponible, le Gestionnaire de fichiers cPanel permet de téléverser directement les fichiers dans public_html ou un autre dossier web.

Explication technique (bref)

FTP utilise deux canaux : une connexion de commande (contrôle) et, pour le transfert de répertoires/fichiers, une connexion de données. En mode actif le serveur ouvre la connexion de données vers le client (souvent bloquée par un NAT/pare‑feu). En mode passif le serveur ouvre un port dans une plage passive et le client se connecte à ce port : c’est la configuration recommandée pour les clients derrière une box. Si cette plage n’est pas ouverte dans le firewall du serveur, la connexion de données échouera.

Erreurs fréquentes et actions recommandées

  • Connection timed out after XX seconds of inactivity — augmentez le timeout côté FileZilla ; vérifiez la latence réseau ; passez en mode passif si nécessaire.
  • MLSD Error / Could not read the contents of the folder — problème de connexion de données (PASV) : activez le mode passif et demandez l’ouverture de la plage de ports passive côté serveur.
  • 425 Can't open data connection — ports passifs fermés ou MasqueradeAddress non configuré ; demandez au support d’ouvrir la plage et de vérifier la configuration NAT.
  • ECONNREFUSED / Connection refused — port incorrect (vérifiez 21/22), le service FTP/SFTP n’écoute pas, ou le firewall bloque la connexion.
  • Échec TLS / probleme de certificat — utilisez l’hôte exact indiqué par cPanel (évitez d’utiliser une IP si le certificat est pour un nom de domaine) ou basculez vers SFTP si possible.

Que fournir au support si l’erreur persiste

  • Heure exacte de l’essai (avec fuseau), hôte testé (nom ou IP) et nom d’utilisateur FTP.
  • Copie intégrale du journal (log) de FileZilla : sélectionnez le panneau de messages, copiez et collez dans le ticket.
  • Capture d’écran des réglages Site Manager (Host, Protocol, Port, Transfer settings).
  • Indiquez si SFTP (port 22) fonctionne ; si possible, joignez le résultat d’un test réseau basique (par ex. test de connexion au port 21/22 depuis votre poste) et précisez si vous êtes derrière un NAT/box.

Limitations et remarques

  • Certains hébergeurs mutualisés désactivent le FTP (ou limitent la plage passive) pour des raisons de sécurité : dans ce cas l’accès se fait uniquement par SFTP ou via le Gestionnaire de fichiers cPanel.
  • La plage de ports passive varie selon la configuration du serveur (ex. 49152–65534 est une plage courante) ; ne changez rien côté serveur sans l’accord du support.
  • Ne partagez jamais de mots de passe ou de jetons d’accès dans un ticket : fournissez uniquement les éléments listés ci‑dessus.

Ressources officielles (lecture recommandée)

Si vous souhaitez, nous pouvons vérifier vos réglages Site Manager et le journal FileZilla : joignez une capture des paramètres (zone utile uniquement) et le log complet au ticket de support.

Documentation de référence

  • How to Enable FTP Passive Mode — cPanel Documentation
  • FTP Accounts — cPanel Documentation

Documentation consultée le 17 octobre 2026. Les outils peuvent varier selon votre hébergement.