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
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.1reste 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.
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.
sudo apt install -y wireguard wireguard-toolsLe 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 genkeyfabrique la clé privée, etwg pubkeyen tire la clé publique.teeécrit la clé privée dans un fichier tout en la laissant continuer verswg pubkey.sudoagit en root, le compte administrateur qui peut tout lire et tout écrire : les fichiers lui appartiendront.sh -clance un petit interpréteur de commandes en root pour tout le morceau entre guillemets.umask 077rè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.
sudo sh -c 'umask 077; wg genkey | tee /etc/wireguard/server.key | wg pubkey > /etc/wireguard/server.pub'
sudo cat /etc/wireguard/server.pubi//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.
sudo sh -c 'umask 077; wg genkey | tee /etc/wireguard/client.key | wg pubkey > /etc/wireguard/client.pub'
sudo cat /etc/wireguard/client.pubSaURc9GeiHt6LO1wPzJu4cnt5xPEWp7C/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.
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/24veut dire que les trois premiers nombres (10.77.0) sont fixes et que seul le dernier varie : tout le réseau10.77.0.xest dans ce tunnel. Choisissez une plage différente de celle de votre box, souvent en192.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.
sudo ufw allow 51820/udpRule 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.
sudo wg-quick up wg0[#] 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 wg0Chaque 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.
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.
sudo wg-quick up wg0[#] 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 wg0Et 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.
ping -c 3 10.77.0.1PING 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 2046msLes 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.
sudo wg showinterface: 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 sentTrois 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.
sudo wg-quick down wg0[#] ip link delete dev wg0Pour 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.
sudo wg-quick down wg0
sudo systemctl enable --now wg-quick@wg0Votre 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.
sudo systemctl enable --now wg-quick@wg0Faire 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.
echo 'net.ipv4.ip_forward=1' | sudo tee /etc/sysctl.d/99-wireguard.conf
sudo sysctl --systemDeuxiè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.
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 MASQUERADEsudo ufw route allow in on wg0 out on eth0
sudo wg-quick down wg0
sudo wg-quick up wg0Troisiè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.
sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1net.ipv6.conf.all.disable_ipv6 = 1Ce 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. Lancezsudo wg-quick down wg0, puisupsi vous voulez le recréer avec un fichier modifié.- Le
pingreste muet etwg shown'affiche pas delatest handshake. Sur la lignetransfer, vous lisez0 B received: le client appelle, mais personne ne répond. Vérifiez d'abord quesudo ufw statusliste51820/udpsur le serveur. Relisez ensuite l'Endpointet 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.confn'a aucun effet. Le fichier n'est lu qu'à la montée du tunnel. Faites unwg-quick down wg0puis unwg-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.