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.
| Élément | Détails |
|---|---|
| Plateformes | Linux (x86_64, arm64) |
| Usage | Réseaux et tunnels |
| Source du téléchargement | Choisissez la version adaptée à votre système sur la page officielle du projet. |
| Version et conditions | Documentation 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.
Illustration officielle des thèmes clair et sombre
Les sources des images figurent ci-dessous. L’interface peut varier selon la version.
wg-easyIllustration officielle des thèmes clair et sombre
1 sur 1. wg-easy: Illustration officielle des thèmes clair et sombre
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
- Choisissez un hôte compatible et le besoin : réseau interne, sortie internet ou les deux.
- Suivez le guide actuel avec un emplacement persistant pour la configuration.
- Autorisez le port UDP WireGuard sur l’hôte et le pare-feu amont. La valeur documentée par défaut est 51820.
- Protégez la console par le proxy HTTPS ou l’alternative documentée.
- Créez un client test, importez sa configuration et connectez-le.
- 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
| Composant | Rôle | Responsabilité |
|---|---|---|
| Hôte Linux | Exécuter le VPN | Mises à jour et disponibilité |
| Console web | Gérer les pairs | Accès limité et HTTPS |
| Client WireGuard | Connecter l’appareil | Protéger sa configuration |
| Routage | Joindre les destinations | Routes, 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.





