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.
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 :
sudo -i
apt update
apt install -y wireguard iptables qrencodeSauf 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 :
cat > /etc/sysctl.d/99-wireguard.conf <<EOF
net.ipv4.ip_forward = 1
EOF
sysctl -p /etc/sysctl.d/99-wireguard.confLa commande doit afficher net.ipv4.ip_forward = 1.
Étape 3 : générer les clés du serveur
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
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.confLes 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 :
ufw allow 51820/udp
ufw statusÉtape 6 : démarrer le VPN
systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0 --no-pager
wg show
ss -lun | grep 51820wg 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 :
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@wg0Le 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 :
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
EOFPersistentKeepalive = 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 :
qrencode -t ansiutf8 < clients/$CLIENT.confWindows et macOS
Affichez le fichier :
cat clients/$CLIENT.confCopiez 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 :
sudo apt install -y wireguard
sudo nano /etc/wireguard/wg0.conf
sudo chmod 600 /etc/wireguard/wg0.conf
sudo wg-quick up wg0Pour 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 :
shred -u clients/$CLIENT.key clients/$CLIENT.psk clients/$CLIENT.confVérifier le fonctionnement
Sur le serveur, latest handshake doit apparaître pour le client, avec des compteurs transfer qui augmentent :
wg showSur un client Linux ou macOS, testez le tunnel puis l’adresse de sortie :
ping -c 3 10.8.0.1
curl -4 https://ifconfig.meLe 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 :
PostUp = iptables -I FORWARD -i %i -o %i -j ACCEPT
PreDown = iptables -D FORWARD -i %i -o %i -j ACCEPTPour les interdire :
PostUp = iptables -I FORWARD -i %i -o %i -j DROP
PreDown = iptables -D FORWARD -i %i -o %i -j DROPLes changements de la section [Interface] demandent un redémarrage, qui coupe brièvement le VPN :
systemctl restart wg-quick@wg0Ré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 :
ufw allow in on wg0 to any port 22 proto tcpDepuis un client connecté au VPN, ouvrez une nouvelle session :
ssh VOTRE_USER@10.8.0.1Si la connexion fonctionne, retirez la règle publique, puis contrôlez le résultat :
ufw status numbered
ufw delete allow 22/tcp
ufw status verboseSi 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 :
nano /etc/wireguard/wg0.conf
systemctl reload wg-quick@wg0
wg showLe 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 :
apt update
apt upgrade -y
wg --versionRedé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 :
tar -czf /root/wireguard-$(date +%F).tar.gz -C /etc wireguard sysctl.d/99-wireguard.conf
chmod 600 /root/wireguard-$(date +%F).tar.gzCette 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 :
tar -xzf /root/wireguard-AAAA-MM-JJ.tar.gz -C /etc
sysctl -p /etc/sysctl.d/99-wireguard.conf
systemctl enable --now wg-quick@wg0Si 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 :
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
PublicKeycôté client avecserver.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 :
sysctl net.ipv4.ip_forward
ip -4 route show default
iptables -t nat -S POSTROUTING
iptables -S FORWARDL’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 :
apt install -y iptables
systemctl restart wg-quick@wg0RTNETLINK answers: Operation not supported
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 :
wg-quick down wg0
systemctl restart wg-quick@wg0Certains 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.
RTNETLINK answers: Permission denied avec ::/0
L’IPv6 est désactivé sur le client Linux. Retirez ::/0 de AllowedIPs.