Accéder au contenu principal

Un auto-entrepreneur passionné à votre service,

Pour votre projet de site internet et vos dépannages informatiques

Maltrail 3.4 : détecter gratuitement le trafic malveillant sur votre réseau

Publié le 14 Octobre 2026, dernière mise à jour le 14 Octobre 2026

Un PC infecté ne prévient pas. Il discute en silence avec son serveur de commande, interroge des domaines au nom improbable, télécharge sa charge utile au milieu de la nuit. Un antivirus peut passer à côté. Le réseau, lui, voit tout passer. C'est exactement là que se place Maltrail, un outil open source qui observe le trafic et lève la main dès qu'une machine contacte une infrastructure connue pour être malveillante. La version 3.4, sortie le 4 septembre 2026, change pas mal de choses sous le capot : moteur réécrit en Rust, binaires pour quatre systèmes, interface allégée. Je vous explique comment il fonctionne, où l'installer, ce qu'on peut en attendre et, surtout, ce qu'il ne fera pas à votre place.

Maltrail, c'est quoi exactement ?

Maltrail est un système de détection de trafic malveillant développé depuis 2014 par Miroslav Stampar, un nom que les amateurs de sécurité connaissent déjà puisqu'il co-signe sqlmap. Le principe est simple : un capteur écoute le trafic réseau et compare ce qu'il voit à une énorme liste d'indicateurs, que le projet appelle des « trails ». Un trail peut être un nom de domaine, une URL, une adresse IP, un couple IP:port, une valeur User-Agent, et même une empreinte de connexion TLS (JA3/JA4) ou le hachage d'un certificat.

La base compte aujourd'hui plus de 1,5 million d'indicateurs. Elle est assemblée à partir de plus de 3 000 listes statiques compilées depuis des rapports d'éditeurs antivirus, d'une quarantaine de flux publics et, si vous le souhaitez, de vos propres listes. Quand une correspondance est trouvée, Maltrail enregistre un événement : qui a parlé à qui, sur quel protocole, avec quel indicateur et d'où vient cet indicateur.

L'outil se compose de deux processus indépendants, qui peuvent tourner sur la même machine ou sur deux machines différentes :

Le capteur (sensor)
Écrit en Rust depuis la branche 3.x, il capture les paquets via libpcap, cherche les correspondances, applique les heuristiques et produit les événements. Il peut les écrire localement, les envoyer à un serveur Maltrail distant, ou les pousser vers un syslog (format CEF) ou Logstash (JSON).
Le serveur (server)
Écrit en Python, il reçoit et stocke les événements, et sert l'interface web de consultation ainsi qu'une petite API.

Le moteur est publié sous licence MIT. Les indicateurs statiques, eux, vivent depuis la version 3.2 dans un dépôt séparé, stamparm/trails, avec leurs propres conditions. J'y reviens plus bas, car c'est un point qui compte pour les professionnels.

Ce qui change avec la version 3.4

La branche 3.x marque une vraie rupture avec les anciennes versions entièrement en Python. Avec la 3.4, le projet publie des binaires de capteur prêts à l'emploi pour Linux, macOS, Windows et FreeBSD, en x86-64 et en ARM64 selon la plateforme, chacun accompagné de sa somme SHA-256 pour vérifier l'archive avant de l'utiliser.

Quelques détails pratiques valent le détour :

  • les versions Linux sont compilées avec libpcap intégré et ne demandent qu'une glibc 2.28 ou plus récente (RHEL 8, Debian 10, Ubuntu 18.04 et suivantes), et il existe des builds musl entièrement statiques pour Alpine ;
  • la version Windows exige Windows 10 au minimum et Npcap installé au préalable, sans quoi l'exécutable refuse tout simplement de se lancer ;
  • le Raspberry Pi OS 64 bits utilise le build aarch64, mais il n'y a pas de binaire pour l'ARM 32 bits : il faut alors compiler soi-même.

Cette version s'inscrit dans la suite de deux mises à jour importantes de l'été. La 3.2 a sorti les indicateurs statiques du code source pour les distribuer sous forme d'un fichier unique téléchargé au démarrage (un fichier de configuration antérieur à la 3.2 doit d'ailleurs être complété, sans quoi ces indicateurs ne sont pas chargés). La 3.3, publiée fin août, a refermé plusieurs angles morts : le trafic encapsulé dans des tunnels VXLAN, GENEVE, GRE ou ERSPAN, les paquets IPv6 avec en-têtes d'extension et les trames à double étiquette VLAN échappaient jusque-là à l'inspection.

À la date où j'écris ces lignes, la 3.4 est toujours la dernière version publiée, mais le dépôt reçoit des commits presque tous les jours. Pensez à vérifier la page des versions avant d'installer.

Comment Maltrail repère une menace

La détection repose d'abord sur la correspondance exacte. Les indicateurs sont chargés en mémoire dans des structures compactes, puis comparés au trafic DNS, HTTP, TLS/QUIC et IP ordinaire. Si un poste du réseau résout un domaine listé comme serveur de commande d'un cheval de Troie, l'événement remonte immédiatement, avec le nom de la famille de malware concernée.

À côté de ce chemin exact, des heuristiques cherchent des comportements suspects que les listes ne peuvent pas connaître à l'avance :

  • les balayages de ports ou d'adresses (scan) ;
  • les abus de DNS, comme l'épuisement volontaire d'un serveur ;
  • les requêtes vers des domaines qui ressemblent à du charabia généré automatiquement, une technique (DGA) utilisée par certains malwares pour changer d'adresse en permanence ;
  • les téléchargements douteux, les tentatives d'injection SQL ou de traversée de répertoires, les User-Agent suspects.

Pour un néophyte, on peut résumer ainsi : la liste d'indicateurs, c'est le fichier des personnes recherchées, et les heuristiques, c'est l'agent qui repère quelqu'un qui rôde autour des voitures. Le premier est très fiable, le second plus sujet aux fausses alertes.

Chaque indicateur reçoit aussi un score de confiance : 40 s'il ne vient que d'un seul flux, 15 points de plus pour chaque flux supplémentaire qui le confirme, jusqu'à 100. Pratique pour trier les alertes, car un indicateur signalé par une seule source mérite une seconde vérification avant de le bloquer sur le pare-feu.

Point qui a son importance : la mise à jour des indicateurs reste volontairement une seule implémentation en Python, alors que le capteur est passé au Rust. Les développeurs ont préféré garder un unique analyseur de flux plutôt que d'en maintenir deux qui finiraient par diverger sans que personne ne s'en aperçoive.

Où placer le capteur sur son réseau

C'est la question que l'article d'origine passe sous silence, et pourtant tout en dépend. Maltrail ne peut analyser que le trafic qui passe sous ses yeux. Installé sur un simple PC de bureau, il ne verra que le trafic de ce PC. Je ne l'ai pas encore déployé chez moi, mais voici les options possibles, de la plus simple à la plus complète.

Les principaux emplacements pour un capteur Maltrail
Emplacement Ce que le capteur voit Pour qui
Sur une seule machine (serveur, VPS) Uniquement le trafic de cette machine Surveiller un serveur exposé sur Internet
Sur le routeur ou pare-feu (OPNsense, Linux) Tout ce qui entre et sort du réseau Home lab, TPE avec un pare-feu dédié
Sur un port miroir (SPAN) d'un switch manageable Une copie du trafic des ports choisis, sans toucher au flux réel Réseaux de bureau, configuration la plus propre
Sur un TAP réseau Une copie physique fidèle d'un lien Environnements professionnels exigeants
Un switch manageable d'entrée de gamme avec port mirroring suffit pour un home lab ou un petit bureau.

Avec une box opérateur grand public, on ne peut pas installer de logiciel ni activer de port miroir. La solution consiste à intercaler un switch manageable entre la box et le reste du réseau, puis à brancher le capteur, un Raspberry Pi 5 par exemple, sur le port qui reçoit la copie du trafic. Pour ceux qui utilisent déjà OPNsense, il existe un plugin Maltrail officiel, ce qui évite d'ajouter un boîtier.

Installer Maltrail pas à pas

Le projet fournit un script d'installation qui fait tout le travail sous Linux. Il est testé à chaque version sur une douzaine de distributions (Debian, Ubuntu, Fedora, Rocky, AlmaLinux, Arch, openSUSE, Alpine…), ainsi que sur FreeBSD, NetBSD, OpenBSD et macOS. La commande tient en une ligne :

curl -fsSL https://raw.githubusercontent.com/stamparm/maltrail/master/install.sh | sudo sh

Lancer un script téléchargé avec les droits administrateur n'est jamais anodin. Lisez-le avant, ou utilisez l'option --dry-run depuis une copie locale du dépôt : elle affiche les commandes sans rien modifier.

Le script installe les dépendances, place le programme dans /opt/maltrail, vérifie la somme de contrôle du capteur, puis crée un compte système maltrail sans privilèges. Ce compte reçoit seulement deux capacités Linux, CAP_NET_RAW et CAP_NET_ADMIN, juste ce qu'il faut pour capturer les paquets. Le capteur et le serveur sont lancés par des unités systemd durcies, qui limitent l'accès au système de fichiers. Relancer le script plus tard met l'installation à jour.

Quelques options utiles :

sh install.sh --role sensor      # installer uniquement le capteur
sh install.sh --ref 3.4          # installer une version précise
sh install.sh --no-service       # ne pas toucher à systemd
sh install.sh --uninstall        # désinstaller en gardant journaux et état

Avant chaque démarrage, systemd exécute le test maltrail-sensor -T. Ce contrôle vérifie la configuration, la présence d'indicateurs valides, la liste blanche, le filtre de capture, les droits et l'espace d'écriture des journaux. S'il manque quelque chose, le service refuse de démarrer et le dit clairement, plutôt que de tourner à vide sans que personne ne le remarque. On peut aussi vérifier que la détection fonctionne réellement :

python3 server.py --detect-test

Cette commande rejoue un trafic malveillant simulé et doit afficher « 20/20 detection(s) fired » sur une installation saine.

Ceux qui préfèrent les conteneurs disposent d'un fichier Docker Compose dans le dépôt :

docker compose -f docker/docker-compose.yml up -d

Sous Windows, il faut d'abord installer Npcap, puis lancer le script PowerShell install.ps1, qui place le capteur dans %ProgramFiles%\Maltrail et le démarre au boot via une tâche planifiée.

Après l'installation, l'interface est accessible sur le port 8338 avec les identifiants par défaut admin / changeme!, et elle écoute sur toutes les interfaces réseau. Changez le mot de passe (paramètre USERS dans /etc/maltrail.conf) et limitez l'écoute à 127.0.0.1 ou placez l'interface derrière un reverse proxy en HTTPS avant toute chose.

Le premier téléchargement des indicateurs prend plusieurs minutes. Tant qu'il n'est pas terminé, le capteur ne détecte rien, ce qui est normal.

L'interface de reporting

L'interface web a été entièrement réécrite. Elle est développée maison, en JavaScript pur, sans framework et sans étape de compilation. Une seule bibliothèque tierce subsiste (PapaParse, pour lire les CSV). Le JavaScript tiers est passé de 968 415 à 19 709 octets, et l'ensemble JavaScript et CSS chargé par page pèse environ 465 Ko, contre à peu près 1,31 Mo auparavant. Sur une petite machine ou une connexion lente, la différence se sent.

On consulte une journée à la fois, et les événements sont regroupés en « menaces » : une ligne par couple source et indicateur. Voici ce que propose l'interface :

Mode direct
Les nouveaux événements arrivent en temps réel via Server-Sent Events (SSE). Si ce canal n'est pas disponible, l'interface se rabat sur une lecture par plages du journal du jour. Une notification de bureau et une alerte sonore peuvent signaler les menaces graves.
Recherche avancée
Des filtres par champ (src:, dst:, port:, trail:…), la négation avec un tiret, les jokers, les plages CIDR comme src:10.0.0.0/8 et les comparaisons numériques comme port:>1024.
Rétrochasse
Elle cherche un indicateur dans tous les journaux conservés, pas seulement dans la journée affichée. Idéal quand on apprend qu'un domaine est malveillant et qu'on veut savoir si un poste l'a contacté la semaine dernière.
Carte mondiale
La densité des événements par pays, à partir de l'adresse externe de chaque connexion.
Triage
Un statut par menace (nouvelle, en cours d'analyse, résolue, faux positif), des notes, des étiquettes et l'ajout en liste blanche depuis un clic droit.
Vues enregistrées et export
Des préréglages de filtres, et l'export de la vue courante en CSV, en JSON ou sous forme d'indicateurs « défangés », c'est-à-dire neutralisés (hxxp://, points entre crochets) pour être partagés sans risque de clic accidentel.

Un détail à connaître si vous travaillez à plusieurs : les statuts de triage, les étiquettes et les vues enregistrées sont stockés dans le navigateur, pas sur le serveur. Deux analystes ne partagent donc pas leur travail de tri.

Côté serveur, le code Python se limite à la bibliothèque standard, sans dépendance externe à installer. Pour afficher plusieurs jours, il lit les journaux sous forme de flux plutôt que de tout charger en mémoire, ce qui évite de faire tomber une petite machine quand les journaux grossissent.

Performances et nombre de workers

Le chemin des paquets, c'est-à-dire l'analyse, la recherche d'indicateurs, l'extraction des protocoles et les heuristiques, est entièrement écrit en Rust. Lors d'un rejeu hors ligne avec un seul worker sur un Raspberry Pi 5, le projet a mesuré 936 nanosecondes par paquet, soit 1 067 924 paquets par seconde. Selon la documentation, le nouveau capteur est de 14 à 37 fois plus rapide que l'ancien en Python, selon les machines.

Ces chiffres mesurent le traitement logiciel sur un fichier de capture, pas un débit garanti sur une vraie carte réseau. En conditions réelles, le pilote, la carte et la nature du trafic changent la donne. Le projet le précise lui-même.

Par défaut, un seul worker de capture tourne. C'est un choix de fidélité. Sous Linux, l'option PACKET_FANOUT (paramètre CAPTURE_FANOUT) répartit le travail sur plusieurs workers, mais le noyau découpe alors le trafic par flux. Résultat : un worker ne voit qu'une partie des connexions d'une même source, et certaines heuristiques, comme la détection de scan, perdent en sensibilité. Dans les tests du projet, 91 % des alertes heuristiques restaient détectées avec deux workers, 86 % avec quatre et seulement 65 % avec huit. Les correspondances exactes, elles, ne bougent pas. Mon conseil : restez à un worker et n'augmentez que si les métriques montrent des paquets perdus.

Surveiller le capteur avec Prometheus

Un capteur qui ne remonte rien peut vouloir dire deux choses : le réseau est sain, ou le capteur est en panne. Pour lever le doute, Maltrail expose des métriques au format Prometheus dès qu'on renseigne le paramètre STATS_ADDRESS : nombre de paquets traités, détections, paquets perdus à la capture, état de la mise à jour, âge des indicateurs, santé des workers, espace disque restant pour les journaux.

Les alertes à mettre en place en priorité :

  • maltrail_up à 0, signe qu'aucun worker de capture ne tourne ;
  • une hausse de maltrail_capture_dropped_total, qui indique des paquets perdus ;
  • maltrail_trail_generation qui n'avance plus, preuve que les indicateurs ne sont plus mis à jour ;
  • maltrail_log_dir_free_bytes trop bas, car Maltrail ne fait aucune rotation de ses journaux.

Ce dernier point mérite qu'on s'y arrête : c'est à vous d'organiser l'archivage et la suppression des anciens journaux, avec logrotate ou un script maison. Un disque plein, et le capteur ne peut plus rien écrire.

Maltrail face aux autres outils

Maltrail n'est pas le seul outil open source de surveillance réseau. Il ne joue pas tout à fait dans la même catégorie que les grands noms, et c'est justement ce qui le rend intéressant pour les petites structures.

Comparatif de quelques outils open source de sécurité réseau
Outil Approche Bloque le trafic ? Prise en main
Maltrail Listes d'indicateurs et heuristiques Non, détection seule Simple, interface web incluse
Suricata Signatures et analyse protocolaire poussée Oui, en mode IPS Exigeante, il faut une console à côté
Zeek Journalisation détaillée et scripts d'analyse Non Réservée aux profils techniques
Snort Signatures Oui, en mode IPS Exigeante
CrowdSec Analyse des journaux et réputation collaborative Oui, via des « bouncers » Moyenne
Pi-hole / AdGuard Home Filtrage DNS par listes Oui, au niveau DNS Très simple

Ces outils se complètent plus qu'ils ne s'opposent. Un Pi-hole bloque des domaines connus mais ne voit pas une connexion directe vers une adresse IP. Suricata va beaucoup plus loin dans l'analyse, au prix d'une configuration bien plus lourde. Maltrail se situe entre les deux : il voit tout le trafic, il ne bloque rien, mais il s'installe en quelques minutes et parle un langage compréhensible.

Pour qui, et avec quelles limites ?

Pour un particulier curieux ou un amateur de home lab, Maltrail est un bon moyen de savoir si un objet connecté, une caméra IP ou un vieux PC parlent à des serveurs qu'ils ne devraient pas connaître. Pour une TPE ou un indépendant, c'est un filet de sécurité supplémentaire à moindre coût, à condition que quelqu'un consulte réellement les alertes. Pour un administrateur réseau, la possibilité d'envoyer les événements vers un SIEM, un syslog, Logstash, Splunk ou Wazuh l'intègre facilement dans une chaîne existante.

Il faut aussi connaître ses limites :

  • il détecte mais ne bloque pas : c'est à vous de réagir, ou de brancher ses alertes sur un pare-feu ;
  • il ne remplace ni un antivirus ni une solution de sécurité installée sur les postes, ses auteurs le disent noir sur blanc ;
  • il ne voit pas le contenu du trafic chiffré, seulement les noms de domaine, les adresses et les empreintes TLS ;
  • les heuristiques produisent des faux positifs qu'il faudra apprendre à écarter avec la liste blanche ;
  • une menace encore inconnue des listes passera inaperçue tant que personne ne l'a signalée.

Licence des indicateurs : le moteur est libre (MIT), mais les indicateurs statiques du dépôt stamparm/trails ne sont gratuits que pour un usage défensif interne, la recherche ou l'enseignement. Si vous proposez une prestation de surveillance à vos clients (infogérance, MSSP, service payant), une licence est nécessaire.

RGPD : les journaux de Maltrail contiennent des adresses IP et des noms de domaine consultés, qui sont des données personnelles. En entreprise, surveiller le réseau suppose d'informer les salariés au préalable, de définir une durée de conservation et de documenter le traitement. La CNIL détaille ces obligations dans ses fiches sur la surveillance au travail.

Questions fréquentes sur Maltrail

Maltrail est-il gratuit ?
Oui, le logiciel est open source et gratuit. Seule l'utilisation commerciale des indicateurs statiques (revente, service payant) demande une licence.
Peut-on l'installer sur un Raspberry Pi ?
Oui, sur Raspberry Pi OS 64 bits avec le binaire aarch64. Un Raspberry Pi 5 suffit largement pour un réseau domestique ou un petit bureau. En 32 bits, il faut compiler le capteur soi-même.
Fonctionne-t-il sous Windows ?
Le capteur oui, depuis la branche 3.x, sur Windows 10 ou plus récent avec Npcap. Pour surveiller tout un réseau, une machine Linux dédiée reste plus pratique.
Faut-il une machine dédiée ?
Non, mais c'est préférable si vous surveillez tout le réseau via un port miroir. Pour un serveur unique, le capteur peut tourner directement dessus.
À quelle fréquence les indicateurs sont-ils mis à jour ?
Le contenu change plusieurs dizaines de fois par jour côté projet. Votre installation les récupère selon l'intervalle défini par UPDATE_PERIOD, et ne télécharge le fichier que s'il a changé.
Maltrail peut-il bloquer une attaque ?
Non. C'est un outil de détection. Pour bloquer, il faut l'associer à un pare-feu, à CrowdSec ou à un filtrage DNS.

Mon avis sur Maltrail 3.4

Ce qui me plaît dans cette version, c'est le sérieux du travail d'exploitation : le test de démarrage qui refuse de tourner à vide, les métriques qui distinguent un réseau calme d'un capteur cassé, les chiffres de performance assortis de leurs limites. C'est rare dans un projet open source de cette taille. Pour un home lab ou une petite structure qui n'a pas les moyens d'une solution de détection commerciale, Maltrail donne enfin une visibilité sur ce qui sort du réseau. Il ne fera pas de miracle et il faudra regarder ses alertes de temps en temps, mais entre ne rien voir et voir qu'une caméra chinoise appelle un serveur de commande connu, le choix est vite fait.

Source

Comment cet article a-t-il été réalisé ? Le texte a été rédigé par mes soins, puis relu avec l'aide d'une intelligence artificielle afin de corriger d'éventuelles erreurs d'orthographe ou de grammaire. L'illustration de présentation a également été créée à l'aide de l'IA.