530 Login authentication failed veut dire que le serveur FTP a refusé votre nom d’utilisateur ou votre mot de passe sur le canal de contrôle, avant même de toucher un seul fichier. Sur cPanel, la raison la plus courante est la forme du nom d’utilisateur. Un compte FTP créé sous un domaine s’appelle user@example.com, et un client qui coupe discrètement tout ce qui suit le @ envoie user, que le serveur ne connaît pas. Les autres causes habituelles sont un compte suspendu, un répertoire FTP qui n’existe plus et une adresse IP bannie après plusieurs échecs de connexion. Une deuxième panne FTP se ressemble dans un billet de soutien, mais c’est un autre problème : le client annonce une connexion réussie, puis reste figé sur Récupération de la liste des fichiers. Ce n’est pas de l’authentification. C’est la connexion de données du mode passif : une deuxième connexion TCP, sur un port haut, que le pare-feu n’a jamais laissée passer. Un coup d’œil au journal de protocole du client vous dit laquelle des deux vous avez, et cet article se divise de la même façon.
Ce que vous allez accomplir
- Distinguer un rejet d’identifiants 530 d’un blocage du canal de données passif en une seule lecture du journal du client.
- Corriger les quatre vraies causes de 530 sur cPanel : la forme du nom d’utilisateur, un compte suspendu, un bannissement d’IP et un dossier personnel FTP absent.
- Lire une réponse
227 Entering Passive Mode, décoder le port qu’elle annonce et tester ce port précis depuis le poste client. - Ouvrir la plage de ports passifs dans CSF ou firewalld et régler la bonne adresse publique sur un serveur derrière du NAT.
- Reconnaître le cas FTPS où l’assistant de suivi de connexions du pare-feu n’arrive plus à lire la réponse chiffrée, et le régler sans abandonner le chiffrement.
Prérequis
Un accès WHM root ou revendeur pour les vérifications de compte, et un accès shell root pour le travail sur le démon et le pare-feu. Côté client, il vous faut un client FTP qui affiche l’échange de protocole : lftp -d, curl -v ou ftp -v -d font tous l’affaire. C’est nc (netcat), sur le poste client, qui prouve si un port précis est joignable ; les options diffèrent entre les versions OpenBSD et Nmap, alors consultez nc -h si -z est refusé.
cPanel installe Pure-FTPd par défaut et peut basculer vers ProFTPD ; les noms de directives ne sont pas les mêmes et cet article donne les deux. Les exemples de pare-feu supposent CSF, avec firewalld montré quand le serveur utilise plutôt le pare-feu RHEL d’origine. Tout ce qui suit vaut pour cPanel et WHM 110 et plus récent. Si le serveur est derrière un répartiteur de charge infonuagique ou une passerelle NAT, il vous faut aussi accès aux règles de groupe de sécurité de ce fournisseur : le pare-feu de l’hôte n’est que la moitié du chemin.
Comment ça fonctionne
Une session FTP utilise deux connexions TCP, et presque tous les symptômes FTP déroutants viennent du fait qu’on l’ignore. La connexion de contrôle est celle à laquelle on pense quand on dit « FTP » : le client ouvre le port 21, le serveur répond par une bannière 220, le client envoie USER et PASS, et le serveur répond 230 Login successful ou 530 Login authentication failed. Les commandes et les réponses circulent là pendant toute la session. Mais aucune donnée de fichier n’y passe. Chaque liste de répertoire et chaque transfert exige une connexion de données, une deuxième connexion TCP distincte, ouverte pour cette seule opération puis refermée.
Dans la conception d’origine — le mode actif — le client indique un port de rappel avec une commande PORT et c’est le serveur qui ouvre la connexion de données en entrée vers le client. Ça a cessé de fonctionner dès que les réseaux domestiques et de bureau se sont retrouvés derrière du NAT et des pare-feu à états : une connexion entrante non sollicitée vers un poste client se fait jeter, et la liste fige. Le mode passif renverse la chose. Le client envoie PASV, le serveur répond par une adresse et un port haut, et c’est le client qui ouvre la connexion de données en sortie. La sortie, c’est la direction que les pare-feu autorisent ; voilà pourquoi le passif est le défaut de tous les clients modernes, et pourquoi la charge s’est déplacée vers le serveur, où cette plage de ports hauts doit maintenant être ouverte en entrée.
Ce renversement, c’est toute l’histoire. Un 530 est un évènement du canal de contrôle et n’a rien à voir avec les ports au-delà du 21. Un blocage après une connexion réussie est un évènement du canal de données et n’a rien à voir avec les identifiants.
Étape par étape
-
Lisez l’échange de protocole avant de toucher à quoi que ce soit. Le volet d’état d’un client graphique en montre souvent assez, mais un client en ligne de commande ne laisse aucune ambiguïté. Lancez ceci depuis le poste qui échoue, pas depuis le serveur.
lftp -d -u 'user@example.com' ftp.example.comPuis, à l’invite de
lftp, forcez le mode passif et demandez une liste :set ftp:passive-mode on lsUn échec d’identifiants met fin à la conversation tout de suite :
<--- 220 FTP Server ready. ---> USER user@example.com <--- 331 User user@example.com OK. Password required ---> PASS XXXX <--- 530 Login authentication failedUn échec du passif va plus loin, puis s’arrête :
<--- 230 OK. Current restricted directory is / ---> PASV <--- 227 Entering Passive Mode (203,0,113,10,124,32) ---- Connecting data socket to (203.0.113.10) port 31776Si la dernière ligne n’aboutit jamais, vous êtes dans la moitié passive. Passez à l’étape 5.
-
Envoyez le nom d’utilisateur que le serveur connaît vraiment. cPanel crée deux sortes d’accès FTP. L’accès principal, c’est le nom d’utilisateur cPanel lui-même : court, sans domaine, et il aboutit dans le dossier personnel du compte. Tout compte FTP créé ensuite dans cPanel » Files » FTP Accounts s’appelle
user@example.com, parce qu’un même serveur héberge plusieurs domaines et queinfotout seul entrerait en collision d’un compte à l’autre. Le suffixe@domainen’est pas décoratif : c’est l’espace de noms. Certains clients et certains scripts de déploiement traitent le@comme un séparateur et n’envoient que ce qui le précède, d’où le classique « ça marche dans FileZilla et ça échoue dans le pipeline ». Confirmez les accès qui existent :grep -o '^[^:]*' /etc/proftpd/USERNAMEcPanel tient ce fichier par compte pour l’un ou l’autre démon, c’est donc la liste faisant autorité des accès FTP du compte :
user@example.com backup@example.comTapez la chaîne complète dans le client, domaine compris. Si un client mutile le
@et n’offre aucune échappatoire, changez de client plutôt que de deviner des substitutions. -
Écartez un compte suspendu et un dossier personnel manquant. Un compte cPanel suspendu échoue en FTP avec un 530 même si le mot de passe est bon, et il en va de même d’un compte FTP dont le dossier cible n’existe plus : le démon n’arrive pas à entrer dans le dossier après l’authentification, alors il refuse la session plutôt que de déposer l’usager n’importe où. C’est ce deuxième cas qui fait perdre le plus de temps, parce que tout dans son allure évoque un mauvais mot de passe.
ls /var/cpanel/suspended/ ls -ld /home/USERNAME/public_ftp /home/USERNAME/public_htmlUn compte suspendu apparaît sous forme de fichier portant son nom ; des dossiers sains affichent une liste normale :
drwxr-xr-x 4 username nobody 4096 Sep 2 10:14 /home/username/public_ftp drwxr-x--- 9 username nobody 4096 Sep 4 08:31 /home/username/public_htmlSi le dossier visé par un compte FTP a disparu, recréez-le avec le bon propriétaire, ou recréez le compte FTP dans cPanel pour que le chemin soit réécrit.
-
Vérifiez si l’IP source a été bannie. Des échecs de connexion répétés depuis une même adresse finissent par la faire bloquer, et le symptôme passe de « 530 chaque fois » à « la connexion ne s’ouvre même plus » — ou reste à 530 si seul le service FTP est bloqué. Sur les serveurs avec CSF, LFD suit les échecs de connexion FTP par défaut et jette le fautif dans le pare-feu.
csf -g 203.0.113.10 grep -i ftp /var/log/lfd.log | tail -20Un bannissement ne laisse aucun doute dans la sortie :
DROP all -- 203.0.113.10 0.0.0.0/0 Temporary Blocks: IP:203.0.113.10 Port: Dir:in TTL:3600 (lfd - FTP login failures)Levez-le et, pour une adresse d’opérateur de confiance, mettez-la en liste blanche pour qu’une boucle de réessais ne redéclenche pas le bannissement :
csf -dr 203.0.113.10 csf -a 203.0.113.10 officecPHulk est l’autre bloqueur à vérifier. Sa couverture dépend des services activés dans WHM » Security Center » cPHulk Brute Force Protection : lisez cette page au lieu de présumer. Son historique et les messages correspondants du démon :
grep -i cphulk /var/log/messages | tail -20 tail -50 /usr/local/cpanel/logs/login_logLevez un blocage depuis l’onglet History Reports de la même interface WHM, et ajoutez l’adresse sous Whitelist Management si elle appartient à un bureau fixe ou à un exécuteur de déploiement.
-
Décodez la réponse passive. C’est l’étape qu’on saute, et c’est celle qui rend tout le reste évident. La réponse
227encode six nombres séparés par des virgules : les quatre premiers forment l’adresse IP à joindre, les deux derniers le port, en octet fort et octet faible. Dans l’échange de l’étape 1,(203,0,113,10,124,32)veut dire203.0.113.10sur le port124 x 256 + 32, soit31776. Certains clients utilisent plutôtEPSVet reçoivent une réponse plus courte, qui ne porte que le port :---> EPSV <--- 229 Entering Extended Passive Mode (|||31776|)Si l’adresse en quatre nombres tombe dans une plage privée —
10.x,172.16-31.xou192.168.x— le serveur est derrière du NAT et annonce une adresse que le client ne peut pas router. Si c’est bien l’adresse publique, le problème vient du port. -
Testez le port annoncé depuis le poste client. Faites-le depuis le réseau qui échoue, parce que la réponse porte sur ce chemin-là et sur aucun autre.
nc -vz 203.0.113.10 31776Un port joignable répond tout de suite :
Connection to 203.0.113.10 31776 port [tcp/*] succeeded!Un port bloqué reste suspendu jusqu’à l’expiration, ou se fait refuser net. Pendant que vous y êtes, confirmez que le port de contrôle répond et lisez la bannière, qui vous dit aussi quel démon tourne :
telnet ftp.example.com 21Connected to ftp.example.com. 220---------- Welcome to Pure-FTPd ---------- 220-You are user number 3 of 50 allowed.Pour d’autres façons d’interroger un port depuis le poste client, tester des ports et transférer avec netcat couvre les différences d’options entre les versions de
nc. -
Confirmez la plage passive du démon, puis ouvrez-la dans le pare-feu. Trouvez d’abord quel démon tourne réellement : un serveur peut avoir les deux installés et un seul actif.
/usr/local/cpanel/scripts/restartsrv_ftpserver --status systemctl status pure-ftpd --no-pagerpure-ftpd (/usr/sbin/pure-ftpd) is running as root with PID 1181 (systemd check method).Lisez ensuite la plage configurée. Pure-FTPd la garde dans
/etc/pure-ftpd.conf; ProFTPD utilisePassivePortsdans/etc/proftpd.conf:grep -i passiveportrange /etc/pure-ftpd.conf grep -i passiveports /etc/proftpd.confPassivePortRange 49152 65534Sans plage définie, le démon pige des ports éphémères au hasard et aucune règle de pare-feu ne peut les couvrir : fixez d’abord une plage explicite. Ajoutez ensuite exactement cette plage à
TCP_INdans/etc/csf/csf.confet rechargez :grep '^TCP_IN' /etc/csf/csf.conf csf -rLa plage s’écrit
49152:65534à côté des ports déjà présents. Sur un serveur avec firewalld plutôt que CSF :firewall-cmd --permanent --add-port=49152-65534/tcp firewall-cmd --reloadsuccessLa même prudence vaut pour n’importe quelle plage de ports sur une machine cPanel : le raisonnement de fermer le port MySQL 3306 sans casser les sites se transpose tel quel — sachez qui a besoin du port avant de l’élargir ou de le refermer.
-
Réglez l’adresse publique sur un serveur derrière du NAT. Si l’étape 5 a montré une IP privée dans la réponse
227, le démon rapporte l’adresse de sa propre interface : exact de son point de vue, inutile pour le client. Dites-lui ce que le monde voit. Pure-FTPd utiliseForcePassiveIP; ProFTPD utiliseMasqueradeAddress:grep -i forcepassiveip /etc/pure-ftpd.conf grep -i masqueradeaddress /etc/proftpd.confMettez l’adresse publique, relancez le démon, puis relisez la réponse :
/usr/local/cpanel/scripts/restartsrv_ftpserverLe prochain
PASVdevrait annoncer l’adresse routable :<--- 227 Entering Passive Mode (203,0,113,10,124,32)C’est aussi le réglage à changer après une migration vers une nouvelle IP ; l’oublier donne la panne FTP classique d’après-migration.
-
Traitez le cas FTPS. Les pare-feu masquent depuis longtemps le problème du passif avec un assistant de suivi de connexions FTP —
nf_conntrack_ftpsous Linux — qui lit la réponse227en clair au passage et ouvre à la volée le port annoncé. C’est pour ça que le FTP fonctionne parfois sans aucune plage passive configurée. Activez FTPS et le canal de contrôle devient chiffré par TLS : l’assistant ne voit que du texte chiffré et n’apprend plus le port. Tout le reste a l’air correct ; la connexion de données, elle, n’obtient jamais son ouverture. Le correctif n’est pas de désactiver TLS, c’est d’arrêter de dépendre de l’assistant : fixez unPassivePortRangeexplicite, ouvrez cette plage de façon statique comme à l’étape 7, et réglezForcePassiveIPcomme à l’étape 8. Une fois la plage ouverte par règle et non par inspection, FTPS se comporte comme du FTP en clair. Pour confirmer que c’est bien de l’assistant que vous dépendiez :lsmod | grep nf_conntrack_ftp
Valider que ça fonctionne
Lancez une session non interactive qui met les deux canaux à l’épreuve d’un bout à l’autre. Si elle affiche une liste, l’authentification et le chemin de données sont sains tous les deux :
lftp -c "set ftp:passive-mode on; open -u 'user@example.com',PASSWORD ftp.example.com; ls; bye"
drwxr-x--- 9 user user 4096 Sep 4 08:31 public_html
drwxr-xr-x 4 user user 4096 Sep 2 10:14 public_ftp
Prouvez ensuite un vrai transfert, parce qu’une liste est assez petite pour masquer un chemin de données limite :
curl -v --ftp-pasv -T /tmp/test.txt ftp://ftp.example.com/ --user 'user@example.com:PASSWORD'
< 227 Entering Passive Mode (203,0,113,10,124,32)
< 150 Accepted data connection
< 226-File successfully transferred
Refaites les deux commandes depuis un second réseau — un partage de connexion cellulaire suffit — parce qu’une règle qui n’autorise que la plage du bureau passera ici et échouera pour tout le monde. Documentation de référence : la documentation cPanel pour les interfaces de configuration du serveur FTP, et le site du projet Pure-FTPd pour les directives.
Dépannage
Ça fonctionne du bureau et ça échoue de la maison. C’est du filtrage par source, pas une panne du serveur. Cherchez d’abord un blocage LFD ou cPHulk sur l’adresse fautive, puis les règles de sortie du réseau client : certains réseaux d’entreprise et d’hôtel bloquent les ports hauts sortants, ce qui tue le mode passif côté client.
Un seul compte FTP reçoit un 530 alors que les autres du même domaine passent. Des identifiants, pas de la configuration. Réinitialisez le mot de passe dans cPanel » Files » FTP Accounts et retapez-le au lieu de coller une entrée enregistrée. Les caractères que les clients gèrent mal sont une vraie cause : une espace en trop au début ou à la fin, ou un $ ou un ! non protégé dans un script lancé par le shell. Un mot de passe sans ces caractères teste plus vite que de déboguer les guillemets.
Le mode actif fonctionne, le passif fige. La preuve que la plage passive n’est pas joignable. Le mode actif utilise le port 20 du serveur en sortie, que rien ne bloque. Ne vous contentez pas de basculer les clients en actif : ça échouera pour tous les usagers derrière du NAT, c’est-à-dire presque tous. Réglez la plage.
La première liste passe, les suivantes figent. La plage passive est trop petite pour le nombre de sessions simultanées. Chaque transfert retient un port pendant l’intervalle TIME_WAIT, donc une plage de quelques dizaines de ports s’épuise toute seule sur un serveur occupé. Élargissez la plage et la règle de pare-feu correspondante.
La réponse 227 montre la bonne IP publique et nc échoue quand même. Le pare-feu de l’hôte n’est pas le seul pare-feu. Les instances infonuagiques ont un groupe de sécurité ou une liste de contrôle réseau devant elles, et ouvrir la plage dans CSF n’y change rien. Ajoutez la même plage aux règles d’entrée du fournisseur.
Quand ce n’est pas la bonne approche
Le FTP en clair envoie le nom d’utilisateur et le mot de passe en clair sur le réseau. Quiconque est en position d’observer le trafic les lit, et sur un réseau partagé c’est un risque réel, pas théorique. Si vous choisissez une méthode d’accès aux fichiers plutôt que d’en réparer une, choisissez le SFTP par SSH. Il passe par l’unique connexion SSH sur le port 22, n’a pas de canal de données séparé, donc pas de plage de ports passifs, pas d’adresse masquerade, et aucun assistant de suivi de connexions à contourner : toute la seconde moitié de cet article cesse de s’appliquer. Sur cPanel, le SFTP demande l’accès shell sur le compte, ce qui est une décision à prendre et non un défaut à subir.
FTPS est l’option intermédiaire : il garde le protocole FTP et le chiffre, ce qui satisfait les exigences qui nomment « transfert de fichiers chiffré », mais il hérite de toutes les complications du mode passif et y ajoute le problème de conntrack de l’étape 9. Choisissez-le quand un client ou une intégration fournisseur exige spécifiquement du FTP.
Il y a aussi un argument pour ne pas faire tourner de FTP du tout. Si l’accès aux fichiers est occasionnel, le gestionnaire de fichiers de cPanel et le SFTP y suffisent sans port 21 public et sans large plage entrante dans le pare-feu. Élargir TCP_IN pour faire disparaître un blocage, sans savoir quelle plage le démon utilise réellement, c’est le mouvement inverse et celui à éviter.
Si c’est le genre de travail que vous préféreriez ne plus jamais porter, c’est le quotidien d’Opérations Cloud — réservez une revue d’infrastructure.