Speedtest-cli : tester le débit Internet depuis un terminal Linux
speedtest-cli est un outil en ligne de commande qui mesure le ping, le débit descendant et le débit montant d’une connexion Internet, sans passer par un navigateur. Sous Ubuntu ou Debian, l’installation se fait avec sudo apt install speedtest-cli, puis un simple speedtest-cli dans le terminal suffit à lancer un test complet.
Installer speedtest-cli sous Ubuntu, Debian et avec pip
Sur les distributions basées sur Debian, le paquet est disponible directement dans les dépôts officiels :
sudo apt update
sudo apt install speedtest-cli
Cette méthode installe une version stable, généralement suffisante pour un usage courant. Pour obtenir la dernière version du script Python ou l’installer sur un système sans les dépôts Debian, pip reste une alternative fiable :
pip install speedtest-cli
Sur certaines distributions récentes, l’ajout de l’option --break-system-packages peut être nécessaire pour contourner la protection de l’environnement Python global. Une fois l’installation terminée, la commande speedtest-cli --version permet de vérifier que l’outil répond correctement.
L’intérêt de passer par pip plutôt que par apt tient surtout à la fraîcheur du script installé. Les dépôts Debian et Ubuntu proposent une version figée au moment de la publication de la distribution, alors que pip install speedtest-cli récupère la dernière version publiée sur PyPI. Dans la pratique, les deux méthodes donnent des résultats de mesure équivalents, la différence portant surtout sur d’éventuelles corrections de bugs mineurs.
Lancer un test de débit et lire les résultats
Le test se lance sans argument particulier :
speedtest-cli
L’outil sélectionne automatiquement un serveur proche, puis affiche trois valeurs principales : le ping en millisecondes, qui mesure la latence de la connexion, le débit descendant en Mbit/s, correspondant à la vitesse de téléchargement, et le débit montant en Mbit/s, correspondant à la vitesse d’envoi. Un ping bas traduit une connexion réactive, utile pour le jeu en ligne ou la visioconférence, tandis que le débit descendant et montant reflète la bande passante disponible pour le téléchargement et l’envoi de fichiers.
Il arrive que ces résultats diffèrent de ceux obtenus via un test dans un navigateur. Cet écart s’explique par le serveur sélectionné, la charge réseau au moment du test, ou encore par le protocole utilisé, qui n’est pas strictement identique entre le script Python et l’interface web de Speedtest.net.
Pendant l’exécution, speedtest-cli affiche par défaut le nom du serveur retenu, sa distance approximative et le fournisseur associé, avant d’indiquer les trois mesures. Ces informations aident à comprendre pourquoi un test peut donner un résultat différent d’un autre : un serveur plus éloigné ou davantage sollicité par d’autres utilisateurs influence directement le débit descendant et montant mesuré, sans que la connexion elle-même ait changé.
Les options utiles : –simple, –list, –server, –share et –csv
Plusieurs options permettent d’adapter la commande speedtest-cli selon le besoin.
L’option --simple limite l’affichage aux trois mesures essentielles, sans les détails du serveur :
speedtest-cli --simple
Pour choisir un serveur précis plutôt que de laisser l’outil décider, --list affiche la liste des serveurs disponibles avec leur identifiant :
speedtest-cli --list
Le serveur souhaité se sélectionne ensuite avec --server suivi de son identifiant :
speedtest-cli --server 12345
Conserver le même serveur d’un test à l’autre facilite la comparaison des résultats dans le temps. L’option --share génère quant à elle un lien image partageable du résultat, tandis que --csv exporte les données au format CSV, pratique pour un traitement automatisé :
speedtest-cli --csv
Tableau récapitulatif des commandes speedtest-cli
| Commande | Fonction | Résultat | Cas d’usage |
|---|---|---|---|
speedtest-cli | Test complet | Ping, download, upload | Vérification ponctuelle |
speedtest-cli --simple | Affichage réduit | Trois valeurs clés | Lecture rapide |
speedtest-cli --list | Liste des serveurs | ID et localisation | Choix d’un serveur fixe |
speedtest-cli --csv | Export de données | Ligne au format CSV | Automatisation et suivi |
Fiabiliser les mesures de vitesse Internet
Pour obtenir des résultats représentatifs, il est préférable de tester la connexion en Ethernet plutôt qu’en Wi-Fi, ce dernier introduisant des variations liées au signal. Fermer les téléchargements ou les mises à jour en cours sur le même réseau évite également de fausser la mesure du débit descendant et montant.
Répéter plusieurs tests avec le même serveur, à différents moments de la journée, donne une image plus fiable qu’une mesure isolée. Un débit anormalement bas ou incohérent d’un test à l’autre peut simplement indiquer une congestion temporaire du réseau ou du serveur choisi, plutôt qu’un problème réel de connexion.
Comparer les résultats obtenus en heures creuses et en heures de forte affluence, comme en soirée, permet aussi de distinguer une limitation propre à l’abonnement d’un simple engorgement passager du réseau local ou du fournisseur d’accès. Sur un réseau partagé par plusieurs appareils, isoler temporairement les autres connexions actives reste le moyen le plus simple d’obtenir une mesure représentative du débit réellement disponible.
Automatiser les tests avec Cron et un export CSV
Pour suivre l’évolution du débit dans le temps, speedtest-cli peut être combiné avec cron afin de lancer un test à intervalles réguliers et d’enregistrer chaque résultat dans un fichier :
speedtest-cli --csv >> /home/utilisateur/speedtest.csv
En plaçant cette ligne dans une tâche planifiée, par exemple toutes les heures, un historique se constitue progressivement dans le fichier CSV. Ce fichier peut ensuite être ouvert dans un tableur ou analysé par un script pour repérer les baisses de débit sur plusieurs jours.
Speedtest-cli face au client officiel Ookla
speedtest-cli désigne le script Python open source développé par Sivel, distinct du client officiel Ookla, qui utilise généralement la commande speedtest. Les deux outils s’appuient sur l’infrastructure Speedtest.net mais reposent sur des implémentations différentes, ce qui peut expliquer de légers écarts de résultats entre les deux.
Le dépôt du projet Python speedtest-cli a été archivé le 30 avril 2026. Cela signifie que son développement n’est plus activement maintenu, mais l’outil installé reste utilisable pour effectuer des tests de débit. Pour un usage à long terme ou un besoin de mises à jour régulières, le client officiel Ookla constitue une alternative à considérer.
Concrètement, cet archivage ne rend pas la commande speedtest-cli inutilisable du jour au lendemain : les tests continuent de fonctionner tant que l’infrastructure Speedtest.net reste accessible via le protocole utilisé par le script. En revanche, aucune correction ne sera apportée en cas de changement côté serveur, ce qui explique pourquoi certains utilisateurs préfèrent désormais installer le client officiel speedtest, disponible également via un paquet dédié sur les distributions Linux les plus récentes.
Résoudre les erreurs courantes avec speedtest-cli
Un message indiquant que la commande est introuvable signale généralement une installation incomplète ; relancer sudo apt install speedtest-cli ou pip install speedtest-cli résout la plupart de ces cas. Une erreur liée à un serveur indisponible peut se corriger en relançant le test sans l’option --server, ce qui laisse l’outil sélectionner automatiquement un autre serveur. Enfin, des résultats incohérents d’un test à l’autre invitent surtout à vérifier qu’aucun autre appareil ou processus ne sollicite la connexion au même moment.
