SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor · Mis à jour le 2026-11-18

Comment fonctionne le routage cryptographique WireGuard

Comprenez pourquoi AllowedIPs sert à la fois de table de routage et de contrôle d’accès, puis lisez le handshake Noise et chaque fichier wg0.conf.

Fonctionnement de WireGuard, en une idée

WireGuard associe chaque paquet à une clé publique. Ce mécanisme s’appelle le routage par clés cryptographiques, et il constitue toute la conception du logiciel : la ligne AllowedIPs située à côté d’un peer est la table de routage des paquets qui quittent votre machine et la liste de contrôle d’accès des paquets reçus de ce peer. Un seul paramètre, deux fonctions. Lisez AllowedIPs de cette manière et chaque fichier de configuration WireGuard devient compréhensible.

Il n’existe ni table de sessions indexée par adresse IP, ni base de données d’utilisateurs. Un peer est une clé publique associée à l’ensemble des adresses que cette clé peut utiliser. Le handshake et les timers servent à maintenir cette association lorsque le réseau sous-jacent change. Si vous voulez d’abord mettre en place un tunnel fonctionnel sans entrer dans la théorie, créez-en un avec un VPN WireGuard auto-hébergé sur votre propre VPS, puis revenez ici lorsqu’une ligne de configuration vous surprend.

AllowedIPs est une table de routage et une liste de contrôle d’accès

Commencez par le trafic sortant. Votre noyau route normalement un paquet vers l’interface wg0, via la table de routage principale. WireGuard compare ensuite l’adresse de destination de ce paquet avec une table contenant les préfixes autorisés de chaque peer, en recherchant le préfixe le plus long en premier. Le résultat identifie un peer, qui identifie une clé publique, puis une clé de session et un endpoint UDP. Le paquet est chiffré pour ce peer et envoyé vers celui-ci.

Si aucun AllowedIPs de peer ne couvre la destination, rien n’est envoyé, car aucune clé ne permet de le transmettre.

ping: sendmsg: Required key not available

Cette erreur n’a qu’une seule signification : l’adresse que vous avez tenté de joindre n’est listée chez aucun peer. Une autre erreur, ping: sendmsg: Destination address required, signifie qu’un peer a bien été sélectionné, mais que WireGuard ne possède aucun endpoint pour celui-ci, car aucun n’a été configuré et aucun n’a encore été appris.

Passons maintenant au trafic entrant. Un paquet UDP arrive sur le port d’écoute. WireGuard retrouve la session à partir de l’index du récepteur présent dans l’en-tête, déchiffre et authentifie la charge utile, puis compare le compteur avec une fenêtre glissante anti-rejeu. Ce n’est qu’après cette étape qu’il lit le paquet interne. Une recherche du préfixe le plus long de l’adresse source doit alors identifier le peer émetteur authentifié. Dans le cas contraire, le paquet est abandonné. Lorsque le débogage dynamique est activé, le noyau indique la raison dans une ligne comme celle-ci :

wg0: Packet has unallowed src IP (10.8.0.9) from peer 2 (203.0.113.10:51820)

C’est pourquoi un peer côté serveur obtient un /32. Un peer configuré avec AllowedIPs = 10.8.0.2/32 peut envoyer des paquets depuis 10.8.0.2, et depuis aucune autre adresse. Remplacez cette valeur par 0.0.0.0/0 : ce client pourra alors revendiquer toute adresse source IPv4 dont la correspondance de préfixe la plus longue le sélectionne, mais pas une adresse attribuée à un autre peer par un préfixe plus spécifique.

Les préfixes qui se chevauchent sont résolus selon leur spécificité, car la recherche utilise la correspondance du préfixe le plus long. Des préfixes identiques configurés sur deux peers se comportent différemment : l’entrée est attribuée au dernier peer configuré, et le premier peer cesse de recevoir ce trafic sans qu’aucune erreur ne soit affichée. wg show wg0 allowed-ips affiche la table réellement présente dans le noyau. C’est cette table qui fait foi lorsque le fichier sur disque et l’état actif ne correspondent plus.

Lire un fichier de configuration en tenant compte du routage par clé cryptographique

Côté serveur :

[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = <server private key>

[Peer]
PublicKey = <laptop public key>
AllowedIPs = 10.8.0.2/32

Côté client :

[Interface]
Address = 10.8.0.2/32
PrivateKey = <laptop private key>

[Peer]
PublicKey = <server public key>
Endpoint = vpn.example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

Le même mot-clé n’a pas le même rôle des deux côtés. Côté client, il signifie « envoyer chaque destination vers ce peer ». Côté serveur, il signifie « n’accepter que cette adresse depuis ce peer ». L’asymétrie tient aux valeurs, pas au rôle.

La moitié de ces clés ne relève pas du protocole. Address, DNS, MTU, PostUp et SaveConfig appartiennent à wg-quick, le script shell qui active l’interface. Il ne s’agit pas de paramètres du protocole WireGuard ; wg-quick les traite séparément. wg-quick strip wg0 affiche la configuration réduite que l’outil wg charge réellement. C’est le moyen le plus rapide d’observer cette séparation.

Ce que fait réellement le handshake

Le handshake de WireGuard utilise Noise_IKpsk2, issu du Noise Protocol Framework. La IK est l’élément utile pour un sysadmin : la clé publique statique du responder est déjà connue de l’initiator, puisqu’il s’agit de la PublicKey dans votre bloc [Peer], et l’initiator envoie sa propre clé publique statique dans le premier message, chiffrée. Il n’y a donc ni échange de certificats ni aller-retour d’identification. Un observateur passif ne peut pas savoir quelle clé émet la connexion, sauf s’il possède la clé privée du responder.

Le coût est d’un aller-retour. Le message d’initiation fait 148 octets, la réponse 92 octets, puis les données circulent immédiatement. Chaque pair génère une nouvelle paire de clés éphémères Curve25519 pour chaque handshake, et les clés de session proviennent d’une chaîne de résultats Diffie-Hellman qui combine les clés statiques et éphémères. Les clés privées éphémères sont ensuite supprimées, ce qui assure la forward secrecy : une personne qui enregistre votre trafic aujourd’hui et vole la clé privée du serveur l’année prochaine ne pourra toujours pas lire les données enregistrées.

Une initiation de handshake contient un timestamp TAI64N, et chaque pair mémorise le timestamp le plus récent reçu de l’autre. Une initiation rejouée est donc rejetée. Les paquets de données contiennent un compteur de 64 bits utilisé comme nonce, et le récepteur conserve une fenêtre glissante des compteurs récemment vus. Les replays et les réordonnancements importants sont ainsi gérés sans état de connexion comparable à celui de TCP.

Les clés de session ne durent pas longtemps, et les timers sont intégrés au code plutôt que configurables.

GraphiqueWireGuard protocol timers, in seconds
Les données de ce graphique
[
  {
    "label": "REKEY_TIMEOUT",
    "seconds": 5,
    "notes": "resend a handshake initiation that got no answer, plus up to 333 ms of random jitter"
  },
  {
    "label": "KEEPALIVE_TIMEOUT",
    "seconds": 10,
    "notes": "send a keepalive after receiving data and sending none back"
  },
  {
    "label": "REKEY_ATTEMPT_TIME",
    "seconds": 90,
    "notes": "stop retrying the handshake and drop the packets queued for that peer"
  },
  {
    "label": "REKEY_AFTER_TIME",
    "seconds": 120,
    "notes": "the peer that initiated the current session begins a fresh handshake when it next sends"
  },
  {
    "label": "REJECT_AFTER_TIME",
    "seconds": 180,
    "notes": "the old session key is refused and traffic stops"
  }
]

Il s’agit de constantes définies par la spécification du protocole, pas de mesures. Ces 5 timers contribuent à gérer le cycle de vie de la session. Lorsqu’une clé de session a 120 secondes, le pair qui a initié ce handshake en démarre un nouveau lors de son prochain envoi ; le responder ne renouvelle pas la clé avec ce timer. Au bout de 180 secondes, l’ancienne clé est refusée, et le trafic s’arrête jusqu’à la fin d’un nouveau handshake. Une initiation qui ne reçoit aucune réponse est renvoyée après 5 secondes, avec un jitter aléatoire pouvant atteindre un tiers de seconde, et les tentatives s’arrêtent après environ 90 secondes. C’est pourquoi wg show affiche latest handshake comme un âge relatif, et pourquoi un tunnel sain et très sollicité conserve un âge faible. Un âge qui augmente alors que vous envoyez activement du trafic indique que les handshakes échouent, et non que le tunnel est inactif.

Pourquoi un pair n’a pas de rôle client ou serveur

Les deux extrémités exécutent un code identique et utilisent le même format de configuration. Il n’existe pas de mode serveur. L’asymétrie que vous percevez vient de Endpoint, et Endpoint est facultatif.

Un pair dont l’endpoint est configuré peut lancer un handshake. Un pair qui n’en a pas attend, puis apprend l’adresse et le port de l’autre côté grâce au premier paquet correctement authentifié. Cet endpoint appris est enregistré et mis à jour chaque fois qu’un paquet valide arrive depuis une nouvelle adresse. C’est ainsi que fonctionne le roaming : un laptop qui passe du Wi-Fi à un réseau mobile conserve le même tunnel, car une session est identifiée par une clé et un index, et non par une adresse IP. Rien ne se reconnecte, car rien n’a jamais été connecté au sens TCP du terme.

Le même mécanisme entraîne un fait important à connaître : le pair qui possède l’adresse publique conserve la dernière adresse IP publique connue de l’autre côté, et wg show l’affiche.

Primitives fixes, sans négociation

WireGuard ne contient aucune liste de suites cryptographiques. ChaCha20-Poly1305 assure le chiffrement authentifié, Curve25519 l’accord de clé, BLAKE2s le hachage et HKDF la dérivation de clé. Chaque déploiement utilise ces primitives. Il n’y a donc aucune phase de négociation à analyser ni aucun mécanisme de repli vers une option plus faible. Le compromis est réel : si l’une de ces primitives est cassée, il faut publier une nouvelle version de l’ensemble du protocole et la mettre à jour aux deux extrémités, et non modifier la configuration. Cette décision unique supprime la majeure partie du code et des modes de défaillance d’un tunnel basé sur TLS. C’est l’essentiel de la comparaison présentée dans WireGuard face à OpenVPN.

Pourquoi le port ne répond pas à un scanner

Les messages d’initiation et de réponse contiennent un champ appelé mac1 ; les réponses avec cookie n’en contiennent pas. Il s’agit d’un MAC (code d’authentification de message) calculé sur le message avec une clé dérivée de la clé publique statique du récepteur. Un émetteur qui ne connaît pas cette clé publique ne peut pas produire de mac1 valide. Le récepteur abandonne alors ce paquet sans envoyer la moindre réponse. Il n’y a ni erreur, ni reset, ni message ICMP.

Le résultat visible est un scan UDP qui ne reçoit aucune réponse.

sudo nmap -sU -p 51820 vpn.example.com

nmap signale open|filtered. C’est la même réponse que celle qu’il donne lorsqu’un firewall abandonne silencieusement les paquets destinés à un port. Un port UDP non filtré sur lequel aucun service n’écoute renvoie normalement une erreur ICMP port-unreachable. nmap la signale alors comme closed.

Un second champ, mac2, gère la pression due aux attaques par déni de service. Lorsque le récepteur est sous charge, il répond à une initiation ou à une réponse avec un mac1 valide, mais sans mac2 valide, au moyen d’une réponse avec cookie de 64 octets liée à l’adresse source de l’émetteur. Il refuse d’effectuer les opérations coûteuses liées aux clés publiques tant que l’émetteur n’utilise pas ce cookie pour calculer un mac2 valide. Cela prouve que l’adresse source est joignable avant l’exécution des opérations coûteuses liées aux clés publiques. Ce mécanisme ne s’active que sous charge.

Pourquoi 0.0.0.0/0 transforme un peer en route par défaut

Parce que AllowedIPs est la table de routage, AllowedIPs = 0.0.0.0/0, ::/0 sélectionne ce peer pour les destinations qui ne sont pas couvertes par un préfixe plus spécifique attribué à un autre peer. C’est tout ce que définit le full tunnel.

Le routage qui permet ce fonctionnement est plus intéressant que la ligne elle-même. Une route par défaut simple via wg0 provoquerait une boucle, car le paquet UDP chiffré qui transporte votre trafic doit lui aussi quitter la machine et correspondrait à sa propre route par défaut. wg-quick évite ce problème avec le policy routing. Il marque les paquets sortants de WireGuard avec un fwmark, place la route par défaut du tunnel dans une table de routage distincte et ajoute des règles afin que seul le trafic non marqué l’utilise. Exécutez ip rule show pour voir le résultat :

32764:	from all lookup main suppress_prefixlength 0
32765:	not from all fwmark 0xca6c lookup 51820
32766:	from all lookup main

0xca6c correspond à 51820 en hexadécimal, et 51820 est également le numéro de la table. La règle suppress_prefixlength 0 demande à la table principale d’ignorer sa propre route par défaut. Les routes spécifiques, comme celle de votre sous-réseau local, restent donc prioritaires, tandis que tout le reste passe par la table du tunnel. Un split tunnel ne nécessite rien de tout cela : une liste plus limitée, comme AllowedIPs = 10.8.0.0/24, 10.20.0.0/16, devient un ensemble de routes ordinaires dans la table principale.

Le full tunnel ne corrige pas à lui seul la résolution de noms, car le resolver appris par votre client auprès du réseau local reste généralement utilisé et sa route est plus spécifique. C’est un problème distinct, traité dans DNS qui fuit en dehors d’un tunnel WireGuard.

À quoi sert réellement PersistentKeepalive

WireGuard n’envoie rien lorsqu’il n’y a aucun trafic. Il n’y a ni heartbeat, ni actualisation de session, ni paquet sur le réseau. Ce silence préserve la batterie et facilite le cas du scanner décrit plus haut, mais il casse une configuration précise.

Un peer situé derrière un NAT (network address translation) ou un firewall stateful n’est joignable depuis l’extérieur que tant qu’un mapping existe dans cet équipement. Ce mapping a été créé par un paquet sortant. Les durées de vie courantes des mappings UDP commencent autour de 30 secondes. Lorsque le mapping expire, les paquets venant du côté public sont rejetés par le middlebox, et le tunnel semble hors service jusqu’à ce que le peer derrière le NAT envoie quelque chose. PersistentKeepalive = 25 envoie un paquet authentifié vide chaque fois que 25 secondes s’écoulent sans qu’aucun paquet authentifié ne traverse le tunnel vers ce peer ou depuis celui-ci. Le trafic réel réinitialise le compte à rebours. Sur un tunnel actif, le paquet vide est donc rarement envoyé, tandis que sur un tunnel inactif, l’intervalle ne dépasse jamais cette durée de vie courante la plus courte. Le mapping reste ainsi ouvert.

Configurez-le sur le peer situé derrière le NAT. Un serveur disposant d’une adresse publique et d’un port UDP ouvert n’en a pas besoin, et le configurer de ce côté ajoute seulement du trafic. Ne le confondez pas avec l’keepalive automatique, qui est déclenché 10 secondes après qu’un peer a reçu des données et n’a rien à envoyer en retour. Celui-ci est toujours actif et ne peut pas être configuré.

Le routage de votre LAN via le tunnel n’est pas une fonctionnalité de WireGuard

Supposons que le pair B se trouve sur un réseau domestique 192.168.50.0/24 et que le pair A doive y accéder. Deux systèmes distincts doivent être configurés, et un seul d’entre eux concerne WireGuard.

Rôle de WireGuard : ajoutez 192.168.50.0/24 à l’élément AllowedIPs de B sur A. A sélectionne ainsi B pour ce préfixe et accepte de B les paquets dont les adresses source correspondent, sauf lorsqu’un préfixe plus spécifique sélectionne un autre pair. Sans cette configuration, le routage par clés cryptographiques ne dispose d’aucune clé pour la destination et n’autorise pas cette adresse source.

Rôle du noyau : sur B, net.ipv4.ip_forward doit être défini sur 1, sinon le noyau supprime tous les paquets déchiffrés qui ne sont pas destinés à B lui-même. La chaîne forward du pare-feu de B doit autoriser le trafic. Les hôtes du LAN doivent disposer d’une route de retour vers 10.8.0.0/24, ou B doit appliquer une source NAT afin que les réponses repassent par B.

Le rôle de WireGuard s’arrête lorsqu’il remet le paquet déchiffré au noyau. Tout ce qui suit relève du routage et du filtrage Linux classiques. C’est pourquoi cet échec apparaît dans les compteurs nft list ruleset ou dans ip -s link show wg0, et non dans wg show. Si vous préférez gérer les pairs via une interface web, exécuter wg-easy dans Docker génère les entrées des pairs pour vous, mais le forwarding dépend toujours du noyau de l’hôte et de la prise en charge du pare-feu. La même séparation s’applique lorsqu’une couche de coordination distribue le préfixe à votre place : annoncer un réseau privé depuis un VPS avec un subnet router Tailscale remplace la modification manuelle de AllowedIPs sur chaque pair, mais vous devez tout de même activer le forwarding IP sur le routeur ; Tailscale gère ses propres règles de pare-feu par défaut.

Pourquoi WireGuard fonctionne dans le kernel

wg0 est un pilote de périphérique réseau. Les paquets l’atteignent via la pile de routage normale, sont chiffrés par des workers du kernel, puis sortent via une socket UDP sans jamais passer dans l’espace utilisateur. WireGuard a été intégré au noyau Linux principal avec la version 5.6, en mars 2020. Ubuntu 24.04 et Debian 13 l’incluent, il ne manque donc que le paquet wireguard-tools.

Le fait qu’il s’agisse d’une interface réseau normale a des conséquences pratiques. tcpdump -ni wg0 affiche les paquets internes en clair, tandis que tcpdump -ni eth0 udp port 51820 affiche les paquets externes chiffrés. Leur comparaison permet de déterminer immédiatement dans quel sens se situe la panne. netfilter et la mise en forme du trafic traitent wg0 comme n’importe quelle autre interface. Lorsque le module du kernel n’est pas disponible, par exemple avec une virtualisation de conteneurs qui partage le kernel de l’hôte, wireguard-go implémente le même protocole dans l’espace utilisateur via un périphérique TUN. Le débit est alors réellement réduit, car chaque paquet franchit deux fois la frontière entre le kernel et l’espace utilisateur.

Ce que WireGuard ne protège pas

Le modèle de menace est volontairement limité, et un protocole aussi discret peut facilement susciter de fausses attentes. Il faut le dire clairement.

  • Il ne masque pas l’utilisation de WireGuard. Les messages de handshake ont des tailles fixes, le premier octet indique le type de message et le transport utilise UDP. La deep packet inspection le reconnaît facilement, et un réseau qui bloque les VPN peut l’interdire. L’obfuscation a été volontairement exclue.
  • Il ne masque ni le volume ni le timing. Les payloads sont complétés uniquement jusqu’à une limite de 16 octets. Un observateur voit donc toujours quand vous envoyez des données et en estime approximativement le volume.
  • Il conserve le dernier endpoint connu. Le peer qui possède l’adresse publique enregistre l’adresse IP publique actuelle de l’autre côté, et wg show l’affiche. Avec une adresse de tunnel fixe dans la configuration, cela forme un identifiant stable qui suit un utilisateur d’un réseau à l’autre. Sur votre propre VPS, ce comportement ne pose pas de problème. C’est aussi pourquoi les services commerciaux ajoutent une couche au-dessus du protocole.
  • Il authentifie une clé, pas une personne. Le détenteur du fichier de clé privée est le peer. Définissez les permissions de /etc/wireguard sur 700 et celles des fichiers de clé sur 600.
  • Il n’existe ni liste de révocation ni expiration. L’accès prend fin lorsque vous supprimez l’entrée du peer sur tous les serveurs qui la contiennent. Les clés statiques restent valides jusqu’à leur suppression.

Rien de tout cela ne rend WireGuard peu sûr. Cela le rend compact, et c’est précisément l’objectif : il authentifie et chiffre les communications, puis laisse la gestion des identités et l’attribution des adresses à la solution que vous construisez au-dessus. Une couche de coordination du type décrit dans WireGuard comparé à Tailscale comble précisément cette lacune, en utilisant le même data plane que celui présenté précédemment. Une fois cette couche en place, la décision suivante consiste à déterminer qui peut accéder à un service que vous exécutez dans le tunnel. C’est ce que définit le choix entre Tailscale serve et funnel pour un port donné.

FAQ

Qu’est-ce que le routage par clé cryptographique dans WireGuard ?

Le routage par clé cryptographique est la règle qui associe chaque paquet à une clé publique. Chaque entrée de peer contient une liste de préfixes dans AllowedIPs. En sortie, WireGuard sélectionne le peer en comparant la destination du paquet avec la liste de chaque peer, en commençant par le préfixe le plus long. Cette liste joue donc le rôle d’une table de routage. En entrée, une fois le paquet déchiffré et authentifié, une recherche du préfixe le plus long correspondant à son adresse source interne doit sélectionner ce même peer. Sinon, le paquet est supprimé. La liste joue donc aussi le rôle d’une liste de contrôle d’accès. WireGuard n’a ni configuration de routage séparée ni firewall interne distinct, car cette même liste assure les deux fonctions.

Dois-je configurer PersistentKeepalive sur les deux peers ?

Non. Configurez-le du côté situé derrière un NAT (network address translation) ou un firewall stateful, généralement le client. WireGuard n’envoie rien lorsqu’il est inactif. Le mapping qui permet au côté distant de joindre ce peer expire donc, souvent en moins d’une minute, et le tunnel semble alors fonctionner dans un seul sens. PersistentKeepalive = 25 envoie un paquet authentifié vide chaque fois que 25 secondes se sont écoulées sans trafic authentifié vers ce peer ou depuis celui-ci. Cela maintient le mapping ouvert. Un peer doté d’une adresse publique et d’un port UDP ouvert n’en a pas besoin.

Pourquoi ping sur le tunnel affiche-t-il « Required key not available » ?

Parce que l’adresse de destination ne figure dans le AllowedIPs d’aucun peer. Le routage par clé cryptographique n’a donc trouvé aucune clé avec laquelle chiffrer le paquet, et le kernel a refusé de l’envoyer. Exécutez wg show wg0 allowed-ips et comparez sa sortie avec l’adresse que vous utilisez pour le ping. L’erreur similaire Destination address required correspond à un autre problème : un peer a été sélectionné, mais WireGuard ne possède aucun endpoint pour celui-ci, car aucun endpoint n’a été configuré et aucun paquet authentifié n’est encore arrivé de ce peer.

Un firewall peut-il détecter et bloquer WireGuard ?

Oui. WireGuard authentifie et chiffre votre trafic, sans chercher à dissimuler son protocole. Les messages d’initiation et de réponse du handshake ont une taille fixe de 148 et 92 octets, les réponses aux cookies font 64 octets, le premier octet de chaque message indique son type et le transport utilise UDP. Une inspection approfondie des paquets identifie donc facilement le protocole. Les réseaux qui bloquent UDP ou qui identifient les protocoles par leur empreinte l’arrêteront. Dissimuler le tunnel consiste à l’encapsuler dans autre chose. Il s’agit d’un outil distinct et non d’un paramètre WireGuard.

Cet article vous a-t-il été utile ?