Configuration de NetFlow/IPFIX pour enregistrer les traductions NAT sur Debian 12

Русский · English · Español · Français · Deutsch

Guide pratique d’installation ipt_NETFLOW avec prise en charge des événements NAT, exportation des événements diffusés et personnalisation du collecteur nfdump.

Toutes les adresses IP indiquées dans l’article sont conditionnelles. Les adresses publiques sont extraites des plages de documentation RFC 5737.

1. Introduction

Lors de l’utilisation de Linux comme passerelle NAT, notamment pour les fournisseurs Internet avec CGNAT, il est nécessaire d’enregistrer la correspondance des adresses internes et des ports des abonnés avec les adresses et ports publics. NetFlow standard prend en compte les flux réseau, mais ne permet pas toujours de restaurer la traduction NAT. À cette fin, la journalisation des événements NAT (NEL) est utilisée en fonction des événements du sous-système conntrack.

Ce tutoriel utilise le module du noyau Debian 12 ipt_NETFLOW, NetFlow v9/IPFIX et collecteur nfcapd/nfdump.

2. Comment fonctionne la journalisation des événements NAT

Exemple de connexion initiale :

10.10.1.100:50004 -> 198.51.100.20:443

Après SNAT :

203.0.113.10:61025 -> 198.51.100.20:443

Pour identifier l’abonné, il est nécessaire d’enregistrer la correspondance 203.0.113.10:61025 et 10.10.1.100:50004, protocole, adresse de destination et heure exacte de l’événement. Le port après NAT peut différer de celui d’origine.

Linux stocke les données de connexion et NAT dans le sous-système Netfilter Connection Tracking (
Leconntrack). ipt_NETFLOW peut recevoir des événements de création et de suppression de mappage NAT et les exporter.

3. Architecture

Abonnés 10.10.0.0/16
        |
Debian 12 NAT gateway (192.0.2.1)
        | SNAT: 203.0.113.10
        +-----------------> Internet
        |
        +--- NetFlow/IPFIX UDP 555 ---> Collector 192.0.2.10
                                        nfcapd -> nfdump -> archives
Composant But
Netfilter NAT et filtrage de paquets
conntrack Comptabilisation de l’état de la connexion
ipt_NETFLOW Exporter des flux et des événements NAT
Réception
nfcapd NetFlow/IPFIX
nfdump Analyse et lecture de l’archive

4. Champs IPFIX pour NAT

IE Nom Signification
4 protocolIdentifier Protocole
7 sourceTransportPort Port source
8 sourceIPv4Address Source IPv4
11 destinationTransportPort Port de destination
12 destinationIPv4Address Destination IPv4
225 postNATSourceIPv4Address IPv4 public après SNAT
Port
227 postNAPTSourceTransportPort après NAT
230 natEvent Type d’événement NAT

Il est important de vérifier le modèle réel exporté : la présence du support des événements NAT ne garantit pas en soi la présence de tous les IE dans une seule entrée.

5. Préparation de Debian 12

uname -r
grep CONFIG_NF_CONNTRACK_EVENTS /boot/config-$(uname -r)
grep -E 'CONFIG_NF_NAT=|CONFIG_NF_CONNTRACK=' /boot/config-$(uname -r)
ls -l /lib/modules/$(uname -r)/build

Prise en charge des événements attendus : CONFIG_NF_CONNTRACK_EVENTS=y (ou configuration de noyau correspondante disponible). Installation des outils :

apt update
apt install -y git build-essential dkms pkg-config libxtables-dev linux-headers-$(uname -r)

Si les en-têtes du noyau en cours d’exécution ont déjà été supprimés des référentiels actuels, les packages correspondants peuvent être recherchés dans Debian Snapshot Archive. Les versions d’en-tête et de base doivent correspondre.

6. Création d’ipt_NETFLOW avec des événements NAT

Code source ipt_NETFLOW

cd /usr/src
git clone https://github.com/aabc/ipt-netflow.git
cd ipt-netflow
./configure --help

Dans la configuration testée, l’appel a permis :

./configure --enable-natevents

Dans la version présentée
Le --enable-natevents inclut la prise en charge des événements NAT. Vérifiez les clés disponibles et le résultat de la génération pour la version sélectionnée.

make -j$(nproc)
make install
depmod -a

En cas d’erreur DKMS tree already contains vérifie les versions enregistrées et les fichiers installés :

dkms status
find /lib/modules/$(uname -r) -name 'ipt_NETFLOW.ko*'
modinfo -n ipt_NETFLOW

Ne supprimez pas l’intégralité de l’arborescence DKMS sans vérification. Si une erreur de signature apparaît signing_key.pem, vérifiez le mode de démarrage sécurisé et les exigences de signature du module.

Chargement du module :

modprobe ipt_NETFLOW
lsmod | grep ipt_NETFLOW
ls /proc/sys/net/netflow/
sysctl net.netflow.natevents

Critères de présence de la journalisation des événements NAT : dans /proc/sys/net/netflow/ devrait apparaître natevents. Si le module a été reconstruit alors qu’il était déjà chargé, un rechargement correct du module sera nécessaire. modinfo affiche le module sur le disque, et non une instance chargée garantie.

7. Exporter la configuration

pour NetFlow v9 :

sysctl -w net.netflow.protocol=9
sysctl -w net.netflow.destination=192.0.2.10:555
sysctl -w net.netflow.natevents=1

pour IPFIX :

sysctl -w net.netflow.protocol=10

Vérifier :

sysctl net.netflow.protocol
sysctl net.netflow.destination
sysctl net.netflow.natevents

Paramètres constants du module dans /etc/modprobe.d/ipt_NETFLOW.conf:

options ipt_NETFLOW destination=192.0.2.10:555 protocol=10 natevents=1

Ils prendront effet au prochain chargement du module.

8. Les règles iptables sont-elles nécessaires ?

Pour NAT Events règle distincte -j NETFLOW n’est pas obligatoire : les événements proviennent de conntrack. Si vous avez également besoin de statistiques pour les discussions régulières, vous pouvez ajouter :

iptables -I FORWARD 1 -j NETFLOW
iptables -L FORWARD -nvx --line-numbers

Ne devrait pas être ajouté NETFLOW dans plusieurs chaînes sans évaluer le risque de recomptage des paquets. Pas besoin d’ajouter NETFLOW à la table NAT pour recevoir les événements NAT.

9. diagnostics de connexion

apt install conntrack
conntrack -L -s 10.10.1.100
conntrack -E -o timestamp,extended
conntrack -E -s 10.10.1.100

Notation conditionnelle :

tcp 6 431999 ESTABLISHED
src=10.10.1.100 dst=198.51.100.20 sport=50004 dport=443
src=198.51.100.20 dst=203.0.113.10 sport=443 dport=61025

Le sens inverse affiche l’adresse publique et le port attribué.

10. Statistiques ipt_NETFLOW

cat /proc/net/stat/ipt_netflow
watch -n 1 cat /proc/net/stat/ipt_netflow

Selon la version, les statistiques contiennent des compteurs d’événements NAT (start, stop), paramètres d’exportation et d’erreur. L’augmentation des compteurs confirme que le module a traité les événements, mais n’a pas transmis tous les enregistrements au collecteur.

11. Installation de nfdump 1.7.x

code source de nfdump

apt update
apt install -y git build-essential autoconf automake libtool pkg-config flex bison libbz2-dev zlib1g-dev liblz4-dev
cd /usr/local/src
git clone https://github.com/phaag/nfdump.git
cd nfdump
git tag --list '*1.7*'

Pour un système fonctionnel, sélectionnez une balise vérifiée et définissez-la dans une variable NFDUMP_TAG.

: "${NFDUMP_TAG:?Set NFDUMP_TAG to a verified release tag}"
git checkout --detach "$NFDUMP_TAG"
./autogen.sh
./configure
make -j$(nproc)
make install
ldconfig
/usr/local/bin/nfdump -V
/usr/local/bin/nfcapd -V

Si le programme ne trouve pas libnfdump*.so, vérifiez ldd /usr/local/bin/nfdump, chemin d’accès à la bibliothèque et configuration ldconfig.

12. Démarrage du collecteur

mkdir -p /mnt/flow/nat
/usr/local/bin/nfcapd -w /mnt/flow/nat -p 555 -t 60

Pour deux exportateurs avec division par catalogues (vérifier la syntaxe sur nfcapd -h votre version) :

/usr/local/bin/nfcapd -p 555 -t 60 -S 1 \
  -n gw1,192.0.2.1,/mnt/flow/1 \
  -n gw2,192.0.2.2,/mnt/flow/2

13. Vérification de la réception et décodage

tcpdump -ni any udp port 555
find /mnt/flow/nat -type f -name 'nfcapd.*'
/usr/local/bin/nfdump -R /mnt/flow/nat -o raw
/usr/local/bin/nfdump -R /mnt/flow/nat -o 'fmt:%ts %sa:%sp -> %da:%dp %pr'

Ce dernier format est destiné principalement aux flux réguliers. Les événements NAT peuvent apparaître différemment.

Pour vérifier le modèle IPFIX réel, capturez les paquets :

tcpdump -ni any -s0 -w /tmp/nat-ipfix.pcap udp port 555
tshark -r /tmp/nat-ipfix.pcap -V

Vérifiez IE 4, 7, 8, 11, 12, 225, 227, 230, ainsi que les enregistrements de données réels. Exemple de contenu de message logique :

Protocol: TCP
Original Source: 10.10.1.100:50004
Destination: 198.51.100.20:443
Translated Source: 203.0.113.10:61025
NAT Event: CREATE

Ceci est une illustration et non un format de sortie littéral nfdump.

14. Erreurs courantes

Symptôme Que vérifier
Non natevents configure les indicateurs, la version du module chargé, la prise en charge des événements du noyau
CONFIG_NF_NAT_NEEDED... No Ceci est un test d’une ancienne macro, pas une preuve de l’absence de NAT
Conflit d’assemblys enregistrés
DKMS tree already contains DKMS
Erreur
Signature du module signing_key.pem et démarrage sécurisé
UDP n’est pas reçu
Routes
, pare-feu, destination, compteurs exportateurs
UDP est reçu, mais il n’y a aucune entrée NAT natevents, compteurs d’événements, modèle IPFIX, décodage

Vérification de l’itinéraire vers le collecteur :

ip route get 192.0.2.10

Vous ne devez pas forcer la définition d’anciennes macros du noyau sans vérifier les sources et la compatibilité des API.

15. Performances

La charge de journalisation est déterminée par le nombre de mappages NAT créés, et pas seulement par la vitesse du trafic. Avec 5 000 créations et 5 000 suppressions par seconde, il y aura 10 000 événements/s, soit 864 millions d’événements par jour en charge constante.
Recommandations

:

  1. Utilisez un collecteur d’événements NAT distinct.
  2. Surveillez la perte UDP et le débordement de tampon.
  3. Synchronisez les horloges de la passerelle et du collecteur.
  4. Contrôlez l’espace disque et la durée de stockage.
  5. Limiter l’accès aux journaux d’activité des abonnés.
  6. Vérifiez le fonctionnement après la mise à jour du noyau et le redémarrage.
  7. Sous charge, vérifiez l’exhaustivité des enregistrements et l’exactitude du modèle IPFIX.

16. Démarrage automatique

Déposer /etc/modules-load.d/ipt_NETFLOW.conf:

ipt_NETFLOW

Déposer /etc/modprobe.d/ipt_NETFLOW.conf:

options ipt_NETFLOW destination=192.0.2.10:555 protocol=10 natevents=1

Exemple de service de collecteur systemd /etc/systemd/system/nfcapd-nat.service:

[Unit]
Description=NetFlow/IPFIX Collector
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/nfcapd -w /mnt/flow/nat -p 555 -t 60
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now nfcapd-nat
systemctl status nfcapd-nat
journalctl -u nfcapd-nat -f

17. Liste de contrôle

Conclusion

ipt_NETFLOW vous permet d’exporter des événements NAT directement depuis la passerelle Linux sans mettre en miroir tout le trafic. Mais il convient de distinguer trois niveaux de préparation : le module est chargé ; Les événements NAT sont générés ; le collecteur accepte et décode correctement les champs obligatoires. Pour prendre pleinement en compte le NAT, vous devez vérifier les trois niveaux et l’exhaustivité des événements sous charge.

Sources