# 10 - Dépannage Cette page regroupe les principaux problèmes pouvant être rencontrés lors de l'utilisation de WireGuard ainsi que les procédures de diagnostic permettant d'identifier rapidement leur origine. Les vérifications sont présentées du cas le plus fréquent au plus spécifique. --- ## Vérifier l'état général du serveur Avant toute investigation, contrôler que le serveur WireGuard fonctionne correctement. ``` sudo systemctl status wg-quick@wg0 ``` Le résultat attendu est : ``` Active: active (exited) ``` Puis vérifier l'interface WireGuard : ``` sudo wg ``` --- ## Le client ne parvient pas à se connecter ### Cause possible - Le serveur n'est pas démarré. - Le port UDP 51820 n'est pas accessible. - Le domaine DNS est incorrect. - Une erreur est présente dans la configuration du client. ### Vérifications ``` sudo systemctl status wg-quick@wg0 ``` ``` sudo ss -lunp | grep 51820 ``` ``` sudo wg ``` Vérifier également : - Le nom DNS **adguard.numericare.fr**. - La redirection UDP 51820 sur le routeur. - La configuration du client. --- ## Aucun Handshake ### Symptômes ``` sudo wg ``` Le champ **Latest Handshake** est absent ou indique **Never**. ### Causes possibles - Clés publiques incorrectes. - Port UDP fermé. - Nom DNS incorrect. - Connexion Internet indisponible. ### Vérifications - Contrôler les clés publique et privée. - Tester le domaine **adguard.numericare.fr**. - Vérifier la redirection UDP 51820. - Contrôler le pare-feu. --- ## Le tunnel est établi mais le réseau domestique est inaccessible ### Symptômes - Le Handshake est présent. - Impossible de joindre les équipements du réseau **10.151.151.0/24**. ### Vérifications Contrôler les réseaux autorisés : ``` AllowedIPs = 10.151.151.0/24,10.152.152.0/24 ``` Puis vérifier le routage IPv4 : ``` cat /proc/sys/net/ipv4/ip_forward ``` Le résultat attendu est : ``` 1 ``` --- ## Le DNS ne fonctionne pas ### Symptômes - Les noms de domaine ne sont pas résolus. - Les publicités ne sont plus filtrées. ### Vérifications Contrôler la configuration du client : ``` DNS = 10.152.152.1 ``` Puis vérifier qu'AdGuard Home est actif : ``` docker ps ``` Le conteneur AdGuard Home doit être en état **Up**. --- ## Impossible d'accéder à Internet ### Cause possible Ce problème apparaît généralement lorsque le client est configuré en **Full Tunnel** et que le routage ou le NAT du serveur est incorrect. ### Vérifications ``` sudo iptables -t nat -L ``` Contrôler la présence de la règle MASQUERADE. --- ## Le client se connecte puis se déconnecte régulièrement ### Cause possible - Connexion mobile instable. - NAT du routeur. - Absence du paramètre PersistentKeepalive. ### Vérification Le client doit contenir : ``` PersistentKeepalive = 25 ``` --- ## Le serveur écoute sur un mauvais port Vérifier la configuration : ``` sudo cat /etc/wireguard/wg0.conf ``` Le paramètre attendu est : ``` ListenPort = 51820 ``` --- ## Vérifier les journaux Afficher les derniers événements : ``` journalctl -u wg-quick@wg0 -n 50 ``` Afficher les journaux en temps réel : ``` journalctl -fu wg-quick@wg0 ``` --- ## Commandes de diagnostic

Commande	Description
`sudo wg`	Afficher les tunnels et les Handshakes.
`ip addr show wg0`	Afficher l'interface WireGuard.
`systemctl status wg-quick@wg0`	Vérifier le service.
`ss -lunp \| grep 51820`	Vérifier l'écoute du port UDP.
`journalctl -u wg-quick@wg0`	Consulter les journaux.
`docker ps`	Vérifier qu'AdGuard Home est démarré.
`iptables -t nat -L`	Contrôler les règles NAT.
`cat /proc/sys/net/ipv4/ip_forward`	Vérifier l'activation du routage IPv4.

--- ## Résumé

Problème	Premier contrôle à effectuer
Aucune connexion	Vérifier le service WireGuard.
Aucun Handshake	Contrôler les clés, le DNS et le port UDP 51820.
Réseau domestique inaccessible	Vérifier les AllowedIPs et le routage IPv4.
DNS inopérant	Vérifier AdGuard Home et le paramètre DNS.
Pas d'accès Internet	Contrôler les règles NAT et la configuration Full Tunnel.
Déconnexions fréquentes	Vérifier le paramètre PersistentKeepalive.

--- > La majorité des incidents WireGuard proviennent d'une configuration incorrecte des clés, des paramètres **AllowedIPs**, de la résolution DNS ou de la redirection du port UDP **51820**. En suivant les vérifications de cette page dans l'ordre, il est généralement possible d'identifier rapidement l'origine du problème.