Retour aux mises à jour
New releaseAug 28, 2026

maltrail v3.2

Système de détection de trafic malveillant en temps réel utilisant des listes noires publiques, des traces statiques de logiciels malveillants et une analyse heuristique pour identifier les menaces sur le trafic DNS, HTTP et IP.

Partager

Maltrail

License Sensor Server Trails X

Maltrail

Maltrail est un système de détection du trafic réseau qui identifie les communications avec des infrastructures malveillantes connues et signale certaines anomalies de trafic sélectionnées. Il compare les domaines, URL, adresses IP, paires IP:port et valeurs User-Agent observés sur le réseau à un ensemble d'indicateurs appelés trails.

Une détection est enregistrée sous forme d'un événement unique contenant la source, la destination, le protocole, le trail correspondant, la classification et la source du trail :

"2026-08-07 09:14:22.117034" gw 10.13.13.2 57809 1.1.1.1 53 UDP DNS malware.bakewithdavid.com "asyncrat (malware)" (static)

Maltrail est conçu pour la surveillance réseau basée sur les indicateurs. Ses détections heuristiques complètent la correspondance des trails, mais elles ne remplacent pas la télémétrie des points de terminaison ni un système de prévention d'intrusion à usage général.

Fonctionnalités

  • Une construction complète des trails combinant l'ensemble statique de trails (plus de 3 000 fichiers sélectionnés, récupérés depuis stamparm/trails), 38 intégrations de flux publics, et des trails optionnels fournis par l'opérateur.
  • Un capteur Rust multithread utilisant libpcap, avec des workers de capture Linux PACKET_FANOUT optionnels.
  • Un serveur Python fournissant l'interface de reporting, la réception d'événements et l'API HTTP.
  • Des trails personnalisés et des listes blanches en texte brut pouvant être examinés et versionnés.
  • Des heuristiques pour le scan, l'épuisement DNS, les recherches de type DGA, les téléchargements suspects, les sondes de proxy, les valeurs User-Agent suspectes et les activités réseau associées.
  • La journalisation locale des événements, la journalisation Maltrail distante, le CEF sur syslog et la sortie JSON Logstash.
  • La validation du déploiement avec maltrail-sensor -T et des métriques Prometheus optionnelles.

Sommaire

Architecture

Maltrail dispose de deux processus déployables indépendamment qui peuvent s'exécuter sur le même hôte ou sur des hôtes séparés : le capteur détecte le trafic suspect, tandis que le serveur stocke et expose les événements pour le reporting et l'accès à l'API.

flowchart LR
    Traffic(("<b>Network traffic</b>"))

    subgraph Maltrail ["Maltrail System"]
        direction LR
        Sensor["<b>Sensor</b><br/>Rust / libpcap<br/>Capture & detection<br/>Trail matching & heuristics"]
        Logs[("<b>Event logs</b><br/>LOG_DIR")]
        Server["<b>Server</b><br/>Python<br/>Event intake & access<br/>Reporting UI & API"]
    end

    Browser(("<b>Browser</b><br/>Reporting interface"))
    Syslog["<b>Syslog / SIEM</b><br/>CEF"]
    Logstash["<b>Logstash</b><br/>JSON"]

    Traffic --> Sensor
    Sensor -->|local events| Logs
    Sensor -->|remote events / LOG_SERVER| Server
    Server -->|stores remote events| Logs
    Logs -->|reads daily logs| Server
    Sensor -->|SYSLOG_SERVER| Syslog
    Sensor -->|LOGSTASH_SERVER| Logstash
    Server <-->|HTTP / SSE| Browser

Le capteur capture le trafic réseau, effectue une correspondance de pistes et une analyse heuristique, et produit des événements. Il peut écrire les événements localement dans LOG_DIR, les envoyer à un serveur Maltrail distant via LOG_SERVER, ou effectuer les deux. Il peut également émettre du CEF via syslog avec SYSLOG_SERVER et du JSON vers Logstash avec LOGSTASH_SERVER.

Le serveur accepte les événements distants, les stocke dans les journaux d'événements, lit les journaux quotidiens disponibles localement, et fournit l'API HTTP ainsi que l'interface de reporting basée sur navigateur. Le capteur ne dépend pas de l'interface de reporting et peut être déployé indépendamment lorsque les événements sont transmis à un autre système.

Interface de reporting

Maltrail inclut une interface de reporting basée sur navigateur permettant d'explorer le trafic détecté, avec mises à jour en direct, recherche par champ, chasse rétrospective, vues géographiques, triage, état des capteurs, vues enregistrées et export.

Interface de reporting Maltrail

L'interface est servie par server.py à l'adresse HTTP_ADDRESS:HTTP_PORT. Elle est en JavaScript pur avec une seule dépendance d'exécution tierce (PapaParse, pour l'analyse CSV) et sans étape de build. Une journée est consultée à la fois, sélectionnée via un sélecteur de date qui fait également office de grille de densité d'événements sur les journaux quotidiens disponibles. Les événements sont diffusés depuis /events et agrégés dans le navigateur en menaces — une ligne par (source, trail) distinct — affichées dans une grille triable avec un panneau de détail.

Catégories