Русский · 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
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
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
:
- Utilisez un collecteur d’événements NAT distinct.
- Surveillez la perte UDP et le débordement de tampon.
- Synchronisez les horloges de la passerelle et du collecteur.
- Contrôlez l’espace disque et la durée de stockage.
- Limiter l’accès aux journaux d’activité des abonnés.
- Vérifiez le fonctionnement après la mise à jour du noyau et le redémarrage.
- 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.