Blog

Basculement WireGuard IPv4/IPv6 : pourquoi deux pairs ne suffisent pas

Découvrez pourquoi deux pairs WireGuard ne permettent pas de basculer automatiquement d’un point de terminaison IPv6 à IPv4, et comment examiner en toute sécurité le point de terminaison, le routage et le comportement des messages de maintien de connexion.

FreeGuard Editorial Team · 2026-11-05

Ajouter un pair IPv4 et un pair IPv6 à un profil WireGuard ne crée pas, en soi, une connexion préférée et une connexion de secours. Il faut d’abord distinguer l’adresse utilisée pour joindre le serveur VPN des adresses de destination transportées à l’intérieur du tunnel. Cette distinction explique pourquoi une configuration peut sembler redondante sans offrir de rétablissement automatique.

Ce guide traite de la sémantique des configurations WireGuard et des commandes de diagnostic pour les systèmes Linux équipés des outils WireGuard. Les applications mobiles et de bureau peuvent ajouter leur propre gestion des connexions ; vérifiez le comportement du client et de la version exacts que vous utilisez. Aucun test réseau réel n’est revendiqué ici.

Distinguer le point de terminaison du trafic à l’intérieur du tunnel

La présentation conceptuelle de WireGuard décrit deux décisions : sélectionner un pair pour une destination interne, puis envoyer le paquet chiffré au point de terminaison de ce pair. IPv4 et IPv6 peuvent être combinés entre ces couches.

Paramètre Question à laquelle il répond
Endpoint Où faut-il envoyer les paquets UDP chiffrés ?
AllowedIPs Quelles adresses de destination internes sélectionnent ce pair, et quelles adresses source entrantes sont acceptées de sa part ?

Un point de terminaison IPv4 peut transporter du trafic IPv6 dans le tunnel. Un point de terminaison IPv6 peut transporter du trafic IPv4 dans le tunnel. Par conséquent, AllowedIPs = ::/0 ne signifie pas « utiliser l’adresse IPv6 du serveur », et AllowedIPs = 0.0.0.0/0 ne signifie pas « utiliser son adresse IPv4 ». Ces entrées correspondent aux familles d’adresses de destination internes, comme indiqué dans le manuel wg.

Pourquoi deux pairs ne forment pas une paire de basculement

Attribuer toutes les destinations IPv4 à un pair et toutes les destinations IPv6 à un autre répartit le trafic interne par famille d’adresses. Cela ne demande pas à WireGuard de transférer le trafic du premier pair vers le second lorsqu’un point de terminaison cesse de fonctionner.

Attribuer le même préfixe de destination aux deux pairs ne constitue pas non plus une politique de secours. Dans l’implémentation des adresses IP autorisées de WireGuard sous Linux, l’insertion d’un préfixe exact déjà présent met à jour son association avec un pair. Il s’agit d’une observation sur l’implémentation, et non d’une garantie multiplateforme quant à la configuration qu’un client graphique acceptera. N’utilisez pas les préfixes en double comme contrôle de disponibilité ou liste de priorités.

L’installation des routes constitue une autre couche. Sous Linux, wg-quick déduit normalement les routes des adresses IP autorisées des pairs et traite les routes par défaut de manière particulière. Son option Table modifie ce comportement. La route menant à l’interface WireGuard et la sélection par un pair de la destination souhaitée doivent toutes deux être correctes.

L’itinérance, les mises à jour des noms d’hôte et les messages de maintien de connexion répondent à des problèmes différents

WireGuard peut mettre à jour le point de terminaison d’un pair après avoir reçu un trafic correctement authentifié provenant d’une nouvelle adresse source et d’un nouveau port. Ce comportement d’itinérance documenté ne définit pas de liste ordonnée de destinations IPv6 et IPv4 à tester lorsque le point de terminaison actuel est inaccessible.

De même, un nom d’hôte disposant des deux familles d’adresses ne suffit pas à prouver l’existence d’un basculement automatique. Examinez le point de terminaison réellement utilisé et vérifiez la politique de résolution et de reconnexion documentée du client. La contribution distincte du projet pour la nouvelle résolution DNS met à jour l’état du point de terminaison dans le noyau après un changement de DNS dynamique ; son existence est une raison utile d’examiner l’outil de gestion, et non de supposer que tous les clients résolvent continuellement les noms d’hôte.

Les messages persistants de maintien de connexion répondent au problème des correspondances NAT ou de pare-feu devenues inactives. Le guide de démarrage rapide officiel indique qu’un intervalle de 25 secondes convient à de nombreuses configurations de ce type et précise que la plupart des utilisateurs n’en ont pas besoin. Ces messages ne définissent ni point de terminaison alternatif ni politique de changement de route. Une connexion qui se bloque après un changement de réseau mobile ne prouve pas, sur ce seul symptôme, une défaillance de l’opérateur ou un problème de maintien de connexion.

Examiner une connexion Linux sans exporter sa configuration

Remplacez wg0 par le nom de votre interface. Ces commandes sont fournies à titre de référence pour votre propre machine ; elles n’ont pas été exécutées sur le VPN d’un lecteur :

sudo wg show wg0 endpoints
sudo wg show wg0 allowed-ips
sudo wg show wg0 latest-handshakes
sudo wg show wg0 transfer

Le manuel wg documente ces affichages sélectifs. Conservez leur sortie en local : les points de terminaison et les identifiants des pairs peuvent tout de même révéler des informations sur votre réseau. Évitez de partager des exportations complètes de configuration ou des fichiers de diagnostic contenant des secrets.

Consignez l’état autour d’une tentative d’accès à un service public connu. Une ancienne négociation sur un tunnel inactif ne suffit pas à diagnostiquer une défaillance. Comparez les observations relatives au point de terminaison, à la négociation et au transfert avec le résultat obtenu dans l’application.

Observation Investigation suivante
La famille du point de terminaison diffère de celle du trafic interne Cela peut être valide ; examinez séparément la sélection de destination
Le trafic reste associé à un pair malgré des préfixes en double Examinez les associations des pairs ; la duplication ne met pas en place de comportement de secours
Un changement de réseau rend le point de terminaison inaccessible Vérifiez la politique de sélection du point de terminaison et de reconnexion du client
Le trafic du tunnel reprend, mais la résolution des noms échoue toujours Examinez DNS séparément à l’aide de la procédure DNS sous Linux

Choisir et vérifier une politique de rétablissement

Pour un serveur accessible par les deux familles d’adresses, utilisez un client ou un gestionnaire de réseau dont le comportement documenté couvre la sélection du point de terminaison et le rétablissement dont vous avez besoin. Avec des profils simples, une comparaison contrôlée utilisant un point de terminaison à la fois peut déterminer quel chemin fonctionne, mais un changement manuel n’est pas un basculement automatique.

Enregistrez les paramètres d’origine en lieu sûr avant toute modification. Sur une connexion de confiance, répétez la même requête applicative sans risque avant et après une transition réseau ordinaire. Gardez la protection VPN activée. Ne provoquez pas de panne sur une connexion distante dont vous dépendez pour rétablir l’accès.

Si l’objectif est le rétablissement automatique, recherchez après la transition un point de terminaison accessible, des signes d’une nouvelle négociation et de trafic, ainsi qu’une requête applicative réussie. Vérifiez les deux familles d’adresses internes lorsqu’elles sont toutes deux nécessaires. Mesurez vous-même le temps de rétablissement plutôt que de supposer qu’il est garanti. Restaurez les paramètres enregistrés si la modification dégrade la connectivité.

Une vérification de l’adresse IP dans un navigateur fournit une indication sur cette requête du navigateur. Elle ne permet pas d’identifier le point de terminaison sélectionné par WireGuard, de prouver la route de chaque application ni d’établir qu’un futur basculement fonctionnera. Le test DNS du site ne permet pas non plus d’établir quel est le résolveur récursif de l’appareil ni de prouver le routage VPN. Utilisez conjointement les observations en cours de fonctionnement et les vérifications applicatives.

Pour approfondir la question des destinations qui devraient utiliser un tunnel, consultez le dossier sur le tunneling fractionné. Distinguez cette décision de routage de la politique qui rétablit une connexion défaillante au serveur.