wg-easy : une interface web pour son VPN WireGuard

Présentation de wg-easy : serveur, QR codes clients, routage, protection de la console, déploiement Docker et coûts de l’auto-hébergement.

À quoi sert wg-easy ?

wg-easy associe un serveur WireGuard à une console web. Vous créez des pairs dans l’interface puis exportez une configuration ou un QR code pour le client WireGuard, au lieu de modifier chaque entrée à la main.

Le logiciel fonctionne sur votre propre hôte. Son adresse, sa capacité et sa disponibilité déterminent le point de sortie. Ce n’est pas un abonnement à un réseau de localisations VPN.

wg-easy : informations essentielles
ÉlémentDétails
PlateformesLinux (x86_64, arm64)
UsageRéseaux et tunnels
Source du téléchargementChoisissez la version adaptée à votre système sur la page officielle du projet.
Version et conditionsDocumentation versionnée vérifiée le 15 novembre 2026. AGPL-3.0-only ; vous fournissez serveur et trafic.

Interface et illustrations de wg-easy

L’illustration officielle combine les thèmes clair et sombre de la liste des clients. État et compteurs indiquent les échanges. Configurations exportées et QR codes contiennent des identifiants d’accès.

Télécharger wg-easy sur le site officiel

La documentation décrit Docker Compose et d’autres installations. Le guide de base demande un hôte administrable, une IP publique ou un domaine, et x86_64 ou arm64. Les appareils utilisent des clients WireGuard.

Choisissez la documentation correspondant à l’image installée. La migration de 14 vers 15 est distincte : ne recopiez pas automatiquement les anciennes variables d’environnement.

Premiers pas avec wg-easy

  1. Choisissez un hôte compatible et le besoin : réseau interne, sortie internet ou les deux.
  2. Suivez le guide actuel avec un emplacement persistant pour la configuration.
  3. Autorisez le port UDP WireGuard sur l’hôte et le pare-feu amont. La valeur documentée par défaut est 51820.
  4. Protégez la console par le proxy HTTPS ou l’alternative documentée.
  5. Créez un client test, importez sa configuration et connectez-le.
  6. Vérifiez routes et DNS, créez des pairs distincts et sauvegardez la configuration en privé.

Accéder au réseau domestique ou à des services internes

Un particulier peut créer un pair par téléphone et ordinateur. Une équipe peut ouvrir un accès contrôlé à ses services. L’administrateur définit toujours routes, pare-feu et destinations autorisées.

Serveur, console et client

Composants de wg-easy
ComposantRôleResponsabilité
Hôte LinuxExécuter le VPNMises à jour et disponibilité
Console webGérer les pairsAccès limité et HTTPS
Client WireGuardConnecter l’appareilProtéger sa configuration
RoutageJoindre les destinationsRoutes, DNS et pare-feu

Routes et distribution des configurations

Une configuration contient point d’accès, routes et clés. Déterminez si seuls certains réseaux ou un trafic plus large passent dans le tunnel. Alignez le DNS pour que résolution des noms et routes attendues concordent.

Un pair par appareil

  • Choisir un nom reconnaissable.
  • Transmettre la configuration par un canal privé.
  • Ne pas partager un pair entre appareils sans lien.
  • Désactiver ou supprimer les appareils perdus ou retirés.

Entretien et coûts réels

Aucun abonnement VPN n’est exigé par le logiciel. Comptez séparément hôte, trafic, domaine éventuel et administration. Déplacer le serveur ou modifier son IP publique peut nécessiter une mise à jour des clients.

Avant une mise à niveau

  • Lire notes de version et migration.
  • Sauvegarder la configuration persistante en privé.
  • Garder un accès au serveur indépendant du VPN modifié.
  • Tester ensuite un ancien et un nouveau pair.

Limites et protection des données dans wg-easy

Les clients ont besoin d’un serveur joignable. Derrière un NAT opérateur, une autre connexion peut être nécessaire ; la console n’efface pas cette contrainte.

Le tunnel protège le trajet entre pairs configurés. Service final, opérateur du serveur et routage déterminent le reste du parcours.

Alternatives pour des usages proches

WireGuard seul convient aux fichiers de configuration. Tailscale et NetBird proposent d’autres modèles de coordination. wg-easy convient pour une console compacte autour de son propre serveur WireGuard.

Documentation et images

Sources officielles, crédits des images et méthode de vérification

L'examen a été établi sur la documentation relative au projet. L'installation et les essais indépendants de la distribution à l'intérieur de ce matériau n'ont pas été effectués. Les droits à l'interface et les noms sont réservés aux titulaires de droits respectifs.