LibraHostDocumentation

Documentation

Guides complets pour tous nos services d'hébergement

🔐 Installation d'un VPN WireGuard#

Ce guide vous explique comment installer et configurer un serveur VPN WireGuard sur votre VPS Linux.

📋 Prérequis#

  • Un VPS Linux avec accès root (Ubuntu/Debian recommandé)
  • Connexion SSH au serveur
  • Ports 51820 (UDP) ouvert dans le pare-feu

📥 Téléchargement du script d'installation#

Étape 1 : Télécharger le script automatisé#

Nous utiliserons le script d'installation automatique d'Angristan qui simplifie grandement le processus :

curl -O https://raw.githubusercontent.com/angristan/wireguard-install/master/wireguard-install.sh chmod +x wireguard-install.sh

Étape 2 : Lancer l'installation#

Exécutez le script d'installation :

./wireguard-install.sh

⚙️ Configuration du serveur#

Étape 3 : Configuration des paramètres#

Le script vous demandera plusieurs informations de configuration :

Paramètres recommandés :

  • IPv4 ou IPv6 : Laissez les valeurs par défaut détectées automatiquement
  • Interface publique : Généralement eth0 (détectée automatiquement)
  • Port WireGuard : 51820 (port par défaut, recommandé)
  • Premier serveur DNS : 1.1.1.1 (Cloudflare) ou 8.8.8.8 (Google)
  • Second serveur DNS : 1.0.0.1 (Cloudflare) ou 8.8.4.4 (Google)

💡 Conseil : Vous pouvez laisser tous les paramètres par défaut en appuyant simplement sur Entrée pour chaque question.

Étape 4 : Lancement de l'installation#

Une fois tous les paramètres configurés, vous verrez :

Press any key to continue...

Appuyez sur Entrée pour démarrer l'installation du serveur WireGuard.

👤 Création d'un client#

Étape 5 : Configuration du premier client#

Le script vous demandera ensuite de créer un premier client :

  • Nom du client : Choisissez un nom descriptif (ex: mon-telephone, laptop-perso)
  • Le script générera automatiquement les clés et la configuration

Étape 6 : Récupération de la configuration#

Une fois l'installation terminée, vous obtiendrez :

  1. Fichier de configuration : Stocké dans /root/wg0-client-[nom].conf
  2. QR Code : Affiché directement dans le terminal pour une configuration facile sur mobile

📱 Mobile : Scannez simplement le QR code avec l'application WireGuard 💻 Ordinateur : Téléchargez le fichier .conf et importez-le dans WireGuard

📱 Installation du client WireGuard#

Sur Android/iOS#

  1. Téléchargez l'application WireGuard depuis le Play Store ou App Store
  2. Ouvrez l'application et tapez sur "+"
  3. Sélectionnez "Créer à partir du code QR"
  4. Scannez le QR code affiché dans votre terminal

Sur Windows/macOS/Linux#

  1. Téléchargez WireGuard depuis wireguard.com
  2. Installez l'application
  3. Importez le fichier de configuration .conf
  4. Activez la connexion

🔧 Gestion des clients#

Ajouter un nouveau client#

Pour ajouter d'autres clients, relancez simplement le script :

./wireguard-install.sh

Le script détectera que WireGuard est déjà installé et vous proposera :

  • Ajouter un nouveau client
  • Supprimer un client existant
  • Désinstaller WireGuard

Supprimer un client#

  1. Relancez le script d'installation
  2. Choisissez l'option "Remove an existing client"
  3. Sélectionnez le client à supprimer

✅ Vérification du fonctionnement#

Test de connexion#

Pour vérifier que votre VPN fonctionne :

  1. Connectez-vous au VPN depuis votre appareil
  2. Vérifiez votre IP : Visitez whatismyipaddress.com
  3. L'IP affichée doit être celle de votre VPS

Vérification du service#

Sur le serveur, vérifiez que WireGuard fonctionne :

sudo systemctl status wg-quick@wg0 sudo wg show

🔧 Dépannage#

Problèmes de connexion#

  • Port bloqué : Vérifiez que le port 51820/UDP est ouvert
  • DNS : Essayez de changer les serveurs DNS dans la configuration
  • Pare-feu : Vérifiez les règles de pare-feu côté serveur et client

Logs de débogage#

Consultez les logs en cas de problème :

sudo journalctl -u wg-quick@wg0 -f