Installer WireGuard avec l’interface WG-Easy

Objectif

Mettre en place un serveur VPN WireGuard avec interface graphique via le conteneur Docker WG-Easy.

Prérequis

• Une machine Debian (ou Ubuntu) avec Docker et Docker Compose installé

• Avoir accès en super-utilisateur (pas besoin de sudo dans les commandes)

• Connexion internet stable

⚠️ Ouvrir les ports suivants sur votre pare-feu :

• 51820/udp → Port principal de WireGuard

• 51821/tcp → Port de l'interface web (optionnel mais recommandé)

---

1. Installation via Stack Docker (recommandé)

a. Générer le mot de passe chiffré

Exécuter cette commande avec votre mot de passe admin souhaité :

docker run --rm ghcr.io/wg-easy/wg-easy wgpw "🚨VOTRE_MDP🚨"

Le hash qui apparaît dans la sortie est à copier pour l'étape suivante

b. Exemple de fichier docker-compose.yml

volumes:
  etc_wireguard:
services:
  wg-easy:
    environment:
      - LANG=fr
      - WG_HOST=🚨IP🚨
      - PASSWORD_HASH=🚨MDP HASH🚨
    image: ghcr.io/wg-easy/wg-easy
    container_name: wg-easy
    volumes:
      - etc_wireguard:/etc/wireguard
    ports:
      - "51820:51820/udp"
      - "51821:51821/tcp"
    restart: unless-stopped
    cap_add:
      - NET_ADMIN
      - SYS_MODULE
    sysctls:
      - net.ipv4.ip_forward=1
      - net.ipv4.conf.all.src_valid_mark=1

c. Lancer le conteneur

docker compose up -d

d. Accès à l’interface

Naviguer vers :

http://192.168.X.X:51821

Conclusion

WG-Easy est une solution simple et rapide pour déployer un serveur WireGuard avec interface de gestion. Le déploiement via Docker permet une installation portable et maintenable, adaptée à tous types de serveurs Debian.