FR

Applications

Monter un VPN WireGuard sur son serveur

Installer WireGuard sur Debian ou Ubuntu, ajouter des clients Windows, macOS, Linux et mobiles, configurer le routage et le pare-feu, puis réserver SSH au VPN.

10 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide vous explique comment transformer votre serveur en passerelle WireGuard. Vos appareils s’y connectent par un tunnel chiffré. Ils peuvent ensuite joindre les services privés du serveur et, si vous le souhaitez, sortir sur Internet avec son adresse IP.

À la fin du guide, vous disposez d’un VPN qui démarre avec le serveur, d’un premier client opérationnel et d’une méthode pour ajouter ou révoquer des appareils.

Commander un serveur

Ce guide s’applique aux serveurs que vous administrez vous-même :

Prérequis

  • Un serveur sous Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04
  • Un accès SSH avec un utilisateur disposant de sudo
  • L’adresse IPv4 publique du serveur, notée ici VOTRE_IP_SERVEUR
  • Un appareil client : Windows, macOS, Linux, Android ou iOS

Plan d’adressage et ports

Le guide utilise les valeurs suivantes. Choisissez une autre plage si 10.8.0.0/24 est déjà utilisée sur l’un de vos réseaux.

Élément Valeur
Interface VPN wg0
Réseau VPN 10.8.0.0/24
Adresse du serveur dans le VPN 10.8.0.1
Premier client 10.8.0.2
Port à ouvrir en entrée 51820/udp

Ce guide route l’IPv4 dans le tunnel. La configuration du client bloque aussi l’IPv6 pour éviter qu’il ne contourne le VPN.

Étape 1 : installer WireGuard

WireGuard est intégré au noyau Linux des systèmes concernés. Les paquets officiels de la distribution fournissent les outils wg et wg-quick. Ouvrez un shell root, puis installez-les :

Terminal
sudo -i
apt update
apt install -y wireguard iptables qrencode

Sauf mention contraire, les commandes à lancer sur le serveur s’exécutent dans ce shell root.

Étape 2 : activer le routage IPv4

Le serveur doit pouvoir transmettre les paquets des clients vers Internet :

Terminal
cat > /etc/sysctl.d/99-wireguard.conf <<EOF
net.ipv4.ip_forward = 1
EOF
sysctl -p /etc/sysctl.d/99-wireguard.conf

La commande doit afficher net.ipv4.ip_forward = 1.

Étape 3 : générer les clés du serveur

Terminal
cd /etc/wireguard
umask 077
wg genkey | tee server.key | wg pubkey > server.pub
IFACE=$(ip -4 route show default | awk '{print $5; exit}')
echo "$IFACE"

La dernière commande affiche l’interface réseau publique, par exemple eth0 ou ens18. Si elle n’affiche rien, le serveur n’a pas de route IPv4 par défaut : corrigez ce point avant de continuer. Gardez ce shell ouvert, car la variable IFACE sert à l’étape suivante.

Étape 4 : créer la configuration du serveur

Terminal
cat > /etc/wireguard/wg0.conf <<EOF
[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = $(cat /etc/wireguard/server.key)

PostUp = iptables -t nat -A POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PostUp = iptables -I FORWARD -i %i -o $IFACE -j ACCEPT
PostUp = iptables -I FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
PreDown = iptables -t nat -D POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PreDown = iptables -D FORWARD -i %i -o $IFACE -j ACCEPT
PreDown = iptables -D FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
EOF
chmod 600 /etc/wireguard/wg0.conf

Les lignes PostUp s’exécutent au démarrage du tunnel et les lignes PreDown à son arrêt. Elles masquent l’adresse des clients derrière celle du serveur et autorisent leur trafic à traverser la machine. %i est remplacé par le nom de l’interface, ici wg0. Ces règles sont placées en tête de la chaîne FORWARD : elles s’appliquent aussi lorsque UFW ou Docker bloque le transit par défaut.

Étape 5 : ouvrir le pare-feu

Si UFW est actif, autorisez le port WireGuard :

Terminal
ufw allow 51820/udp
ufw status

Étape 6 : démarrer le VPN

Terminal
systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0 --no-pager
wg show
ss -lun | grep 51820

wg show doit afficher l’interface wg0, sa clé publique et le port 51820. Le service redémarrera automatiquement avec le serveur.

Étape 7 : ajouter un client

Choisissez un nom et une adresse libre dans le VPN. Pour chaque nouveau client, changez ces deux valeurs :

Terminal
cd /etc/wireguard
umask 077
mkdir -p clients
CLIENT=laptop
CLIENT_IP=10.8.0.2
wg genkey | tee clients/$CLIENT.key | wg pubkey > clients/$CLIENT.pub
wg genpsk > clients/$CLIENT.psk

cat >> wg0.conf <<EOF

[Peer]
# $CLIENT
PublicKey = $(cat clients/$CLIENT.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
AllowedIPs = $CLIENT_IP/32
EOF

systemctl reload wg-quick@wg0

Le rechargement applique la liste des clients sans couper ceux qui sont connectés. La clé pré-partagée est facultative dans WireGuard : elle ajoute une couche de chiffrement symétrique.

Créez ensuite le fichier destiné à l’appareil :

Terminal
cat > clients/$CLIENT.conf <<EOF
[Interface]
PrivateKey = $(cat clients/$CLIENT.key)
Address = $CLIENT_IP/32
DNS = 1.1.1.1, 9.9.9.9

[Peer]
PublicKey = $(cat server.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
Endpoint = VOTRE_IP_SERVEUR:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
EOF

PersistentKeepalive = 25 maintient le tunnel ouvert lorsque l’appareil se trouve derrière une box ou un réseau NAT.

Étape 8 : connecter l’appareil

Installez l’application depuis la page officielle WireGuard, puis importez la configuration.

Android et iOS

Affichez un QR code dans le terminal, puis scannez-le depuis l’application avec l’ajout d’un tunnel :

Terminal
qrencode -t ansiutf8 < clients/$CLIENT.conf

Windows et macOS

Affichez le fichier :

Terminal
cat clients/$CLIENT.conf

Copiez son contenu dans un fichier laptop.conf sur votre poste, puis importez-le dans l’application avec Import tunnel(s) from file. Activez ensuite le tunnel.

Linux

Installez wireguard sur le poste, puis copiez la configuration dans /etc/wireguard/wg0.conf :

Terminal
sudo apt install -y wireguard
sudo nano /etc/wireguard/wg0.conf
sudo chmod 600 /etc/wireguard/wg0.conf
sudo wg-quick up wg0

Pour arrêter le tunnel, utilisez sudo wg-quick down wg0.

Supprimer les secrets du serveur

Une fois l’appareil configuré, le serveur n’a plus besoin de sa clé privée. Sur le serveur :

Terminal
shred -u clients/$CLIENT.key clients/$CLIENT.psk clients/$CLIENT.conf

Vérifier le fonctionnement

Sur le serveur, latest handshake doit apparaître pour le client, avec des compteurs transfer qui augmentent :

Terminal
wg show

Sur un client Linux ou macOS, testez le tunnel puis l’adresse de sortie :

Terminal
ping -c 3 10.8.0.1
curl -4 https://ifconfig.me

Le ping doit répondre et curl doit afficher VOTRE_IP_SERVEUR. Sous Windows, utilisez ping 10.8.0.1 puis consultez votre adresse IP publique dans un navigateur.

Choisir ce qui passe dans le tunnel

Le paramètre AllowedIPs du client détermine le trafic envoyé dans le VPN :

Besoin AllowedIPs côté client
Tout le trafic passe par le serveur 0.0.0.0/0, ::/0
Seulement le réseau VPN 10.8.0.0/24
Le VPN et un réseau privé du serveur 10.8.0.0/24, 192.168.50.0/24

Avec ::/0, le trafic IPv6 entre dans le tunnel, mais il n’en ressort pas puisque ce guide ne route que l’IPv4. Les applications se rabattent alors sur l’IPv4, sans fuite hors du VPN.

Pour joindre un réseau privé relié au serveur, ajoutez aussi des lignes PostUp et PreDown pour cette interface, sur le modèle de l’étape 4, puis redémarrez le tunnel.

Côté serveur, AllowedIPs indique les adresses que chaque client a le droit d’utiliser. Gardez une adresse /32 par client. Pour joindre un réseau situé derrière un client, ajoutez-le à cette ligne, par exemple AllowedIPs = 10.8.0.3/32, 192.168.1.0/24. Ce client doit lui-même autoriser le routage vers son réseau.

Faire communiquer les clients entre eux

Selon la politique de la chaîne FORWARD, les clients peuvent ou non se joindre. Pour fixer ce comportement, ajoutez l’une de ces paires de lignes dans la section [Interface] de /etc/wireguard/wg0.conf.

Pour autoriser les échanges :

Configuration
PostUp = iptables -I FORWARD -i %i -o %i -j ACCEPT
PreDown = iptables -D FORWARD -i %i -o %i -j ACCEPT

Pour les interdire :

Configuration
PostUp = iptables -I FORWARD -i %i -o %i -j DROP
PreDown = iptables -D FORWARD -i %i -o %i -j DROP

Les changements de la section [Interface] demandent un redémarrage, qui coupe brièvement le VPN :

Terminal
systemctl restart wg-quick@wg0

Réserver SSH au VPN

Une fois le VPN validé, vous pouvez fermer SSH sur l’adresse publique. Cette section suppose qu’UFW est actif et refuse les connexions entrantes par défaut, ce que ufw status verbose permet de confirmer. Adaptez le port 22 si vous en utilisez un autre.

Autorisez SSH depuis le VPN :

Terminal
ufw allow in on wg0 to any port 22 proto tcp

Depuis un client connecté au VPN, ouvrez une nouvelle session :

Terminal
ssh VOTRE_USER@10.8.0.1

Si la connexion fonctionne, retirez la règle publique, puis contrôlez le résultat :

Terminal
ufw status numbered
ufw delete allow 22/tcp
ufw status verbose

Si votre règle porte un autre nom, comme OpenSSH, utilisez ufw delete allow OpenSSH. Vous pouvez aussi la supprimer par son numéro avec ufw delete NUMERO.

Révoquer un client

Supprimez le bloc [Peer] de l’appareil dans /etc/wireguard/wg0.conf, puis rechargez la configuration :

Terminal
nano /etc/wireguard/wg0.conf
systemctl reload wg-quick@wg0
wg show

Le client ne doit plus apparaître. Supprimez aussi /etc/wireguard/clients/laptop.pub. Si la clé privée du serveur a été exposée, générez-en une nouvelle et redistribuez la configuration à tous les clients.

Mettre à jour

Les outils sont mis à jour par APT et le module WireGuard par le noyau :

Terminal
apt update
apt upgrade -y
wg --version

Redémarrez le serveur après une mise à jour du noyau. Le VPN repart automatiquement, mais prévoyez un autre accès si SSH lui est réservé.

Sauvegarder et restaurer

Le dossier /etc/wireguard contient les clés et la liste des clients :

Terminal
tar -czf /root/wireguard-$(date +%F).tar.gz -C /etc wireguard sysctl.d/99-wireguard.conf
chmod 600 /root/wireguard-$(date +%F).tar.gz

Cette archive contient des clés privées : conservez-la chiffrée, hors du serveur.

Pour restaurer sur un serveur où les paquets sont installés, en remplaçant AAAA-MM-JJ par sa date :

Terminal
tar -xzf /root/wireguard-AAAA-MM-JJ.tar.gz -C /etc
sysctl -p /etc/sysctl.d/99-wireguard.conf
systemctl enable --now wg-quick@wg0

Si le nom de l’interface publique a changé, corrigez-le dans les lignes PostUp et PreDown avant le démarrage.

En cas de problème

Aucun latest handshake dans wg show

Le client n’arrive pas à établir le tunnel. WireGuard ne répond jamais aux paquets non authentifiés : un scanner de ports ne prouve donc rien. Observez plutôt l’arrivée du trafic sur le serveur pendant que le client tente de se connecter :

Terminal
apt install -y tcpdump
tcpdump -ni any udp port 51820
  • Aucun paquet n’arrive : vérifiez Endpoint, la règle UFW et le réseau du client. Si tout est correct, contactez le support depuis votre espace client pour savoir si un filtrage s’applique en amont.
  • Des paquets arrivent sans réponse : les clés ne correspondent pas. Comparez PublicKey côté client avec server.pub, et la clé du bloc [Peer] avec celle du client.

Le tunnel monte, mais Internet ne fonctionne pas

Vérifiez dans l’ordre le routage, le NAT et le transit :

Terminal
sysctl net.ipv4.ip_forward
ip -4 route show default
iptables -t nat -S POSTROUTING
iptables -S FORWARD

L’interface des règles doit être celle de la route par défaut. Si elle diffère, corrigez wg0.conf, puis lancez systemctl restart wg-quick@wg0.

Le VPN fonctionne, mais les noms de domaine ne se résolvent pas

Testez ping 1.1.1.1 depuis le client. Si ce test réussit, le problème vient du DNS : vérifiez la ligne DNS du client ou indiquez un autre résolveur.

resolvconf: command not found sur un client Linux

wg-quick a besoin de cet outil pour appliquer la ligne DNS. Installez openresolv, ou retirez cette ligne si vous ne routez que le réseau VPN.

iptables: command not found

Le paquet manque, souvent sur une installation Debian minimale. Installez-le, puis relancez le service :

Terminal
apt install -y iptables
systemctl restart wg-quick@wg0

Le noyau ne peut pas créer l’interface. C’est le cas d’un système exécuté dans un conteneur sans prise en charge de WireGuard par l’hôte. Vérifiez le module avec modprobe wireguard.

modprobe: FATAL: Module wireguard not found

Le noyau a souvent été mis à jour sans redémarrage. Comparez uname -r au contenu de /lib/modules, puis redémarrez le serveur.

Key is not the correct length or format

Une clé est incomplète ou contient un caractère en trop. Recopiez-la entièrement, sans espace ni retour à la ligne.

L’interface wg0 existe déjà

Le message contient already exists : l’interface a été démarrée hors de systemd. Arrêtez-la, puis relancez le service :

Terminal
wg-quick down wg0
systemctl restart wg-quick@wg0

Certains sites restent bloqués ou les transferts se figent

La taille des paquets est probablement trop élevée pour le réseau traversé. Ajoutez MTU = 1380 dans la section [Interface] du client, puis réactivez le tunnel. Si le problème persiste, essayez 1280.

L’IPv6 est désactivé sur le client Linux. Retirez ::/0 de AllowedIPs.

Références