Anime-Sanctuary

WireGuard

Vous voulez joindre vos services de partout, sans les exposer à tout Internet. Creusons un tunnel privé entre votre ordinateur et lui avec WireGuard, un fichier de réglages de chaque côté.

Parcours
Tutoriel 26 sur 35
Durée
30 min de lecture
Vérifié avec
wireguard-tools 1.0.20210914 (Debian 13.7)
Ce que vous saurez faire
  • Expliquer ce qu'est un VPN personnel et ce que WireGuard apporte.
  • Générer les clés, puis écrire les deux fichiers wg0.conf.
  • Ouvrir le port UDP dans ufw et monter le tunnel.
  • Vérifier la poignée de main avec wg show, puis arrêter ou relancer le tunnel.

Avant de commencer : Sécuriser SSH : couper les mots de passe, Pare-feu avec ufw.

Sommaire
  1. Ce qu'est un VPN personnel
  2. Installer WireGuard
  3. Générer les clés
  4. Configurer le serveur
  5. Ouvrir le port dans ufw et démarrer le serveur
  6. Configurer le client et monter le tunnel
  7. Tester la poignée de main
  8. Arrêter, relancer, lancer au démarrage
  9. Si ça échoue
  10. La suite
  11. Sources

Comment installer WireGuard sur Debian pour avoir un VPN personnel ? Vous avez un serveur sur Internet et des appareils chez vous, et vous voulez qu'ils se parlent sans que le monde entier écoute. WireGuard creuse un tunnel privé entre eux, avec un petit fichier de réglages de chaque côté. Comptez une demi-heure, dont une bonne partie à recopier des clés sans se tromper.

Ce qu'est un VPN personnel

Un VPN, ou réseau privé virtuel, relie des machines éloignées comme si elles étaient branchées sur le même réseau. Un VPN personnel est un tunnel privé entre vos appareils et votre serveur, creusé par vous. Ce qui passe dans le tunnel est chiffré : personne sur le chemin ne le voit. Le reste de votre trafic suit votre connexion habituelle.

WireGuard est le logiciel qui creuse ce tunnel. Debian 13 en contient déjà le moteur, dans son noyau, le cœur du système : il ne reste que les outils à installer.

Chaque machine reçoit dans le tunnel une adresse qui n'existe que là : 10.77.0.1 pour le serveur, 10.77.0.2 pour votre ordinateur. Le tunnel apporte trois choses :

  • Joindre le serveur en privé. Un service qui n'écoute que sur 10.77.0.1 reste invisible d'Internet et n'est joignable qu'à travers le tunnel.
  • Relier vos appareils. Votre ordinateur, votre téléphone et d'autres machines se retrouvent sur un réseau à vous, d'où que vous soyez.
  • Faire passer tout votre trafic par le serveur, si vous le voulez. Ce n'est pas nécessaire pour la suite, donc nous le gardons pour un encadré à la fin de l'étape 7.
Le tunnel WireGuard se monte par une poignée de main Votre ordinateur envoie une poignée de main au serveur, qui répond. Le tunnel est alors ouvert et tout ce qui le traverse est chiffré. 3. tout passe chiffré Votre ordinateur 10.77.0.2 Serveur 10.77.0.1 1. poignée de main 2. réponse
Texte équivalent : votre ordinateur (10.77.0.2) envoie une poignée de main au serveur (10.77.0.1), qui répond. Une fois les clés vérifiées de part et d'autre, le tunnel est ouvert et tout ce qui le traverse est chiffré.

Chaque bout du tunnel s'appelle un pair. Ici il y en a deux : le serveur, qui attend les appels, et votre ordinateur, qui appelle. Installons WireGuard sur chacun.

1Installer WireGuard

Les deux machines ont besoin des mêmes outils. Dans cet article, votre ordinateur est un Linux de la famille Debian ou Ubuntu. Un téléphone ou un autre système suit la même logique, comme l'indique un encadré à l'étape 5. Lancez cette commande sur le serveur, puis sur votre ordinateur.

Sur le serveur, puis sur votre ordinateur
sudo apt install -y wireguard wireguard-tools

Le paquet wireguard-tools apporte les deux commandes dont nous nous servons : wg, qui fabrique les clés et affiche l'état du tunnel, et wg-quick, qui monte et descend le tunnel. Le paquet wireguard est un raccourci qui regroupe le tout. Il faut maintenant des clés.

2Générer les clés

Chaque pair a sa propre paire de clés, deux nombres liés l'un à l'autre. La clé privée reste secrète, sur la machine qui l'a créée. La clé publique se calcule à partir d'elle, et vous la donnez à l'autre pair, comme une serrure que vous lui confiez en gardant la clé. C'est le principe des clés SSH vues dans Sécuriser SSH : couper les mots de passe.

La commande ci-dessous enchaîne cinq morceaux, et chacun a son rôle :

  • wg genkey fabrique la clé privée, et wg pubkey en tire la clé publique.
  • tee écrit la clé privée dans un fichier tout en la laissant continuer vers wg pubkey.
  • sudo agit en root, le compte administrateur qui peut tout lire et tout écrire : les fichiers lui appartiendront.
  • sh -c lance un petit interpréteur de commandes en root pour tout le morceau entre guillemets.
  • umask 077 règle cet interpréteur pour que les fichiers créés ensuite ne soient lisibles que par leur propriétaire.

Lançons-la d'abord sur le serveur.

Sur le serveur
sudo sh -c 'umask 077; wg genkey | tee /etc/wireguard/server.key | wg pubkey > /etc/wireguard/server.pub'
sudo cat /etc/wireguard/server.pub
Résultat attendu
i//dgJDIO/GtBrxenXnVCcWNcUKVfJb2QIl63ItYPFU=

La ligne affichée est la clé publique du serveur : 44 caractères qui se terminent par un signe =. Les clés de cet article sont des exemples jetables, créés pour l'occasion. Ne les réutilisez pas : les vôtres seront différentes. Faites la même chose sur votre ordinateur.

Sur votre ordinateur
sudo sh -c 'umask 077; wg genkey | tee /etc/wireguard/client.key | wg pubkey > /etc/wireguard/client.pub'
sudo cat /etc/wireguard/client.pub
Résultat attendu
SaURc9GeiHt6LO1wPzJu4cnt5xPEWp7C/LJ4sKzUoTE=

Gardez ces deux clés publiques sous la main : chaque machine a besoin de celle de l'autre. Commençons par le serveur.

3Configurer le serveur

Le serveur lit ses réglages dans /etc/wireguard/wg0.conf, où wg0 est le nom du tunnel. Le fichier contient une section [Interface] pour le serveur lui-même, et une section [Peer] pour chaque pair autorisé à entrer.

Il contient la clé privée. Il est donc créé avec les droits 600, lecture et écriture pour son propriétaire seul, et il appartient à root. Les autres comptes du serveur ne le lisent pas ; vous le lisez avec sudo.

Dans la commande ci-dessous, remplacez la valeur écrite après CLIENT_PUB= par la clé publique de votre ordinateur, celle de l'étape 2. La valeur proposée est notre exemple.

Sur le serveur
sudo env CLIENT_PUB='SaURc9GeiHt6LO1wPzJu4cnt5xPEWp7C/LJ4sKzUoTE=' sh -c 'umask 077; cat > /etc/wireguard/wg0.conf <<EOF
[Interface]
Address = 10.77.0.1/24
ListenPort = 51820
PrivateKey = $(cat /etc/wireguard/server.key)

[Peer]
PublicKey = $CLIENT_PUB
AllowedIPs = 10.77.0.2/32
EOF'

Chaque ligne a un rôle précis :

  • Address : l'adresse du serveur dans le tunnel. Le /24 veut dire que les trois premiers nombres (10.77.0) sont fixes et que seul le dernier varie : tout le réseau 10.77.0.x est dans ce tunnel. Choisissez une plage différente de celle de votre box, souvent en 192.168.x.x, pour éviter les confusions.
  • ListenPort : le port sur lequel le serveur attend les appels. 51820 est l'usage habituel de WireGuard.
  • PrivateKey : la clé privée du serveur. La commande la lit dans son fichier, vous n'avez pas à la recopier.
  • PublicKey : la clé publique du pair, ici votre ordinateur.
  • AllowedIPs : les adresses autorisées pour ce pair, expliquées juste en dessous.

AllowedIPs sert deux fois, un peu comme un portier avec un carnet d'adresses. Un paquet est un petit morceau de données. Pour un paquet qui sort, le tunnel regarde la liste et l'envoie au pair dont la liste contient sa destination. Pour un paquet qui entre, il le laisse passer seulement si son expéditeur figure dans la liste de ce pair. Ici, 10.77.0.2/32 désigne exactement une adresse, celle de votre ordinateur, car le /32 fixe les quatre nombres. Il ne peut pas se faire passer pour une autre machine.

Le serveur est réglé, mais son pare-feu ne le laisse pas encore répondre.

4Ouvrir le port dans ufw et démarrer le serveur

WireGuard parle en UDP, un protocole qui envoie des paquets sans ouvrir de conversation préalable. Le pare-feu (voir Pare-feu avec ufw) refuse tout ce qu'on ne lui a pas permis, donc il faut autoriser le port 51820 en UDP.

Ce port est ouvert à tout Internet, mais il ne répond à personne sans la bonne clé : WireGuard ignore en silence tout paquet qui n'en porte pas. Les services eux-mêmes restent derrière le tunnel, hors de vue.

Sur le serveur
sudo ufw allow 51820/udp
Résultat attendu
Rule added
Rule added (v6)

Les deux lignes viennent de ce que ufw écrit la règle pour IPv4 et pour IPv6. Le port est ouvert, donc le serveur peut démarrer son tunnel.

Sur le serveur
sudo wg-quick up wg0
Résultat attendu
[#] ip link add wg0 type wireguard
[#] wg setconf wg0 /dev/fd/63
[#] ip -4 address add 10.77.0.1/24 dev wg0
[#] ip link set mtu 1420 up dev wg0

Chaque ligne [#] est une commande que wg-quick lance pour vous : il crée l'interface wg0 (la prise virtuelle du tunnel), charge vos réglages, lui donne son adresse, puis fixe le MTU, la taille maximale d'un paquet (1420 laisse la place à l'emballage du tunnel), et l'allume. Vous n'avez rien à retenir de ces lignes, sauf qu'elles ne signalent aucune erreur.

Le serveur attend désormais l'appel. Il reste à écrire le fichier de votre ordinateur.

5Configurer le client et monter le tunnel

Le fichier du client reprend celui du serveur, avec quelques différences :

  • Pas de ListenPort : le client appelle au lieu d'attendre.
  • Address : la sienne, 10.77.0.2.
  • PublicKey : celle du serveur, puisque le pair est maintenant le serveur.
  • AllowedIPs : tout le réseau du tunnel, 10.77.0.0/24.
  • Endpoint : l'adresse publique du serveur et son port, puisque le client doit savoir où appeler.
  • PersistentKeepalive = 25 : un petit signe de vie toutes les 25 secondes, qui garde le tunnel ouvert même derrière une box.

Comme celui du serveur, ce fichier est créé en droits 600, propriétaire root.

Dans la commande ci-dessous, remplacez la valeur écrite après SERVER_PUB= par la clé publique du serveur, celle de l'étape 2. Remplacez aussi 203.0.113.10 par l'adresse IP publique de votre serveur.

Sur votre ordinateur
sudo env SERVER_PUB='i//dgJDIO/GtBrxenXnVCcWNcUKVfJb2QIl63ItYPFU=' sh -c 'umask 077; cat > /etc/wireguard/wg0.conf <<EOF
[Interface]
Address = 10.77.0.2/24
PrivateKey = $(cat /etc/wireguard/client.key)

[Peer]
PublicKey = $SERVER_PUB
Endpoint = 203.0.113.10:51820
AllowedIPs = 10.77.0.0/24
PersistentKeepalive = 25
EOF'

Ici, AllowedIPs = 10.77.0.0/24 veut dire « envoie dans le tunnel tout ce qui est destiné au réseau 10.77.0.x ». Le reste de votre trafic, vos sites habituels, continue de passer par votre connexion normale. Montons le tunnel.

Sur votre ordinateur
sudo wg-quick up wg0
Résultat attendu
[#] ip link add wg0 type wireguard
[#] wg setconf wg0 /dev/fd/63
[#] ip -4 address add 10.77.0.2/24 dev wg0
[#] ip link set mtu 1420 up dev wg0
Et mon téléphone, ou un ordinateur sous Windows ou macOS ?

Les applications WireGuard existent pour ces systèmes. Chaque appareil a sa propre paire de clés, sa propre adresse dans le tunnel (10.77.0.3, 10.77.0.4, et ainsi de suite) et son propre bloc [Peer] dans le fichier du serveur. Le contenu du fichier du client est le même que ci-dessus, avec la clé et l'adresse de l'appareil.

Le tunnel est monté des deux côtés. Voyons s'il fonctionne vraiment.

6Tester la poignée de main

Quand deux pairs se retrouvent, ils font d'abord une poignée de main : un échange court où chacun vérifie la clé publique de l'autre. Sans elle, aucun paquet ne passe. Le moyen le plus rapide de la vérifier est de demander un signe de vie au serveur à travers le tunnel.

Sur votre ordinateur
ping -c 3 10.77.0.1
Résultat attendu
PING 10.77.0.1 (10.77.0.1) 56(84) bytes of data.
64 bytes from 10.77.0.1: icmp_seq=1 ttl=64 time=0.154 ms
64 bytes from 10.77.0.1: icmp_seq=2 ttl=64 time=0.241 ms
64 bytes from 10.77.0.1: icmp_seq=3 ttl=64 time=0.158 ms

--- 10.77.0.1 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2046ms

Les trois réponses prouvent que vos paquets traversent le tunnel. Les temps de votre côté seront plus longs : ils comprennent le trajet jusqu'au serveur. wg show montre ensuite l'état du tunnel, côté serveur comme côté client.

Sur le serveur
sudo wg show
Résultat attendu
interface: wg0
  public key: i//dgJDIO/GtBrxenXnVCcWNcUKVfJb2QIl63ItYPFU=
  private key: (hidden)
  listening port: 51820

peer: SaURc9GeiHt6LO1wPzJu4cnt5xPEWp7C/LJ4sKzUoTE=
  endpoint: 198.51.100.7:35515
  allowed ips: 10.77.0.2/32
  latest handshake: 7 seconds ago
  transfer: 564 B received, 476 B sent

Trois lignes comptent. latest handshake donne le moment de la dernière poignée de main. transfer compte les octets échangés, et endpoint montre d'où le client appelle, ici une adresse d'exemple. Votre sortie aura d'autres durées et d'autres nombres. Sur l'ordinateur, sudo wg show affiche la même chose du point de vue du client.

Une poignée de main ancienne ne veut pas dire que le tunnel est mort : sans trafic, il dort, et la poignée de main se refait au premier paquet. Pour savoir s'il vit, provoquez un échange avec un ping, puis relisez wg show. La date de latest handshake doit être récente, de moins de deux minutes, et transfer doit avoir grandi.

Le tunnel marche. Reste à savoir l'arrêter, le relancer et le faire démarrer tout seul.

7Arrêter, relancer, lancer au démarrage

wg-quick down défait le tunnel, et wg-quick up le remonte. Le fichier n'est lu qu'à la montée : après toute modification de wg0.conf, faites donc un down puis un up. Descendons d'abord celui de votre ordinateur.

Sur votre ordinateur
sudo wg-quick down wg0
Résultat attendu
[#] ip link delete dev wg0

Pour que le serveur remonte son tunnel après chaque redémarrage, confiez-le à systemd, le gestionnaire de services de Debian. Sur le serveur, descendez d'abord le tunnel monté à la main, sinon le nom wg0 serait déjà pris. La seconde commande le démarre tout de suite, puis à chaque démarrage.

Sur le serveur
sudo wg-quick down wg0
sudo systemctl enable --now wg-quick@wg0

Votre ordinateur est déjà descendu, donc il n'y a rien à défaire de ce côté. Si vous voulez que le tunnel soit toujours en place, lancez seulement la seconde commande. Sinon, montez-le à la demande avec wg-quick up wg0.

Sur votre ordinateur, si vous voulez un tunnel permanent
sudo systemctl enable --now wg-quick@wg0
Faire passer tout votre trafic par le serveur

Par défaut, seul le trafic vers 10.77.0.x passe par le tunnel. Si vous voulez que tout Internet passe par le serveur, par exemple pour ne pas utiliser un Wi-Fi public en clair, il faut trois étapes. Première étape : le serveur doit accepter de relayer des paquets pour d'autres machines, ce que règle l'option ip_forward du noyau. La commande sysctl sert à lire et à changer ces options.

Sur le serveur
echo 'net.ipv4.ip_forward=1' | sudo tee /etc/sysctl.d/99-wireguard.conf
sudo sysctl --system

Deuxième étape : il doit renvoyer ces paquets vers Internet sous sa propre adresse. C'est le rôle de MASQUERADE, une règle de iptables (l'outil qui dit au noyau quoi faire des paquets) : elle remplace l'adresse 10.77.x.x de l'expéditeur par celle du serveur, à la sortie (POSTROUTING). ufw doit aussi laisser passer ces paquets. Relevez d'abord le nom de la carte réseau du serveur, eth0 dans nos exemples, avec ip route show default. Dans la section [Interface] de wg0.conf, ajoutez ces deux lignes avec le bon nom.

Dans /etc/wireguard/wg0.conf, sur le serveur
PostUp = iptables -t nat -A POSTROUTING -s 10.77.0.0/24 -o eth0 -j MASQUERADE
PostDown = iptables -t nat -D POSTROUTING -s 10.77.0.0/24 -o eth0 -j MASQUERADE
Sur le serveur
sudo ufw route allow in on wg0 out on eth0
sudo wg-quick down wg0
sudo wg-quick up wg0

Troisième étape : dans le fichier du client, remplacez AllowedIPs = 10.77.0.0/24 par AllowedIPs = 0.0.0.0/0, qui signifie « toutes les adresses IPv4 » (IPv4 est le format d'adresse courant, comme 203.0.113.10), puis relancez le tunnel du client. Les adresses IPv6, le format plus récent, ne sont pas dans cette liste : si votre connexion en a, ce trafic-là sort encore hors du tunnel. Pour l'en empêcher, désactivez l'IPv6 sur le client avec la commande ci-dessous. Gardez une connexion SSH ouverte pendant l'essai : une erreur coupe votre accès à Internet, et wg-quick down wg0 le rétablit.

Sur votre ordinateur
sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1
Résultat attendu
net.ipv6.conf.all.disable_ipv6 = 1

Ce réglage disparaît au redémarrage ; remettez 0 pour réactiver l'IPv6.

Si ça échoue

Trois situations sont à connaître :

  • wg-quick: `wg0' already exists. Le tunnel est déjà monté, sur cette machine. Lancez sudo wg-quick down wg0, puis up si vous voulez le recréer avec un fichier modifié.
  • Le ping reste muet et wg show n'affiche pas de latest handshake. Sur la ligne transfer, vous lisez 0 B received : le client appelle, mais personne ne répond. Vérifiez d'abord que sudo ufw status liste 51820/udp sur le serveur. Relisez ensuite l'Endpoint et les deux clés publiques, qui doivent se croiser : celle du client dans le fichier du serveur, celle du serveur dans le fichier du client.
  • Une modification de wg0.conf n'a aucun effet. Le fichier n'est lu qu'à la montée du tunnel. Faites un wg-quick down wg0 puis un wg-quick up wg0.

La suite

Votre ordinateur et votre serveur partagent désormais un réseau privé, avec ses propres adresses. Une troisième machine peut le rejoindre de la même façon : celle qui garde vos fichiers à la maison, un NAS, c'est-à-dire un petit boîtier de stockage branché sur votre réseau. L'article suivant, Brancher son NAS, relie votre NAS au serveur par ce tunnel.

Sources (consultées le 4 novembre 2026)

  • WireGuard : démarrage rapide, installation. Manuels : wg-quick(8), wg(8).
  • Debian : WireGuard sur le wiki Debian.
  • Commandes : essais sous Debian 13.7 entre deux machines jetables ; port UDP ouvert sans réponse aux paquets sans clé vérifié, comme la commande sysctl ; non testés : systemctl enable, le transfert de tout le trafic côté client et les applications téléphone.