## 🌍 Lire ceci dans d’autres langues: - 🇬🇧 [English](../README.md) - 🇧🇷 [Português](README.pt-br.md) - 🇪🇸 [Español](README.es.md) - 🇫🇷 [Français](README.fr.md) - 🇩🇪 [Deutsch](README.de.md) ✨ Si vous constatez un problème dans la traduction ou souhaitez demander une nouvelle langue, veuillez ouvrir une [issue](https://github.com/eduardogsilva/wireguard_webadmin/issues). # wireguard_webadmin wireguard_webadmin est une interface web complète et facile à configurer pour gérer des instances WireGuard VPN. Conçue pour simplifier l’administration des réseaux WireGuard, elle fournit une interface conviviale prenant en charge plusieurs utilisateurs avec différents niveaux d’accès, plusieurs instances WireGuard avec gestion individuelle des pairs, ainsi que le crypto‑key‑routing pour les interconnexions site‑à‑site. ## Fonctionnalités - **Historique de transfert par pair**: suivez les volumes de téléchargement et d’envoi pour chaque pair. - **Gestion avancée du pare‑feu**: administration VPN simple et efficace des règles de pare‑feu. - **Redirection de ports**: redirigez facilement des ports TCP ou UDP vers des pairs ou des réseaux situés derrière ces pairs. - **Serveur DNS**: prise en charge d’hôtes personnalisés et de listes de blocage pour une sécurité renforcée et une meilleure confidentialité. - **Prise en charge multi‑utilisateur**: gérez l’accès avec différents niveaux d’autorisation. - **Instances WireGuard multiples**: gérez séparément les pairs de plusieurs instances. - **Crypto Key Routing**: simplifie la configuration des interconnexions site‑à‑site. - **Partage d’invitations VPN**: générez et distribuez instantanément des invitations VPN sécurisées et limitées dans le temps par e‑mail ou WhatsApp, avec QR code et fichier de configuration. Ce projet vise à offrir une solution intuitive et conviviale pour l’administration de WireGuard, sans compromettre la puissance et la flexibilité du protocole. ## Licence Ce projet est distribué sous licence MIT – consultez le fichier [LICENSE](../LICENSE) pour plus de détails. ## Captures d’écran ### Liste des pairs Affiche une liste complète des pairs, y compris leur état et d’autres détails, pour un suivi et une gestion aisés des connexions WireGuard. ![WireGuard Peer List](../screenshots/peerlist.png) ### Détails d’un pair Affiche les informations clés du pair, des métriques détaillées et un historique complet du volume de trafic. Comprend également un QR code pour une configuration facile. ![WireGuard Peer Details](../screenshots/peerinfo.png) ### Invitation VPN Génère des invitations VPN sécurisées et limitées dans le temps pour un partage facile de la configuration via e‑mail ou WhatsApp, avec QR code et fichier de configuration. ![VPN Invite](../screenshots/vpninvite.png) ### Filtrage DNS avancé Bloquez les contenus indésirables grâce aux listes de filtrage DNS intégrées. Des catégories prédéfinies comme pornographie, jeux d’argent, fake news, adware et malware sont incluses, avec la possibilité d’ajouter des catégories personnalisées pour une sécurité adaptée. ![DNS Server](../screenshots/dns.png) ### Gestion du pare‑feu Interface complète pour créer, modifier et supprimer des règles de pare‑feu avec une syntaxe de type iptables. Permet un contrôle précis du trafic réseau, améliorant la sécurité et la connectivité des instances WireGuard. ![Firewall Rule List](../screenshots/firewall-rule-list.png) ![Firewall Rule Manager](../screenshots/firewall-manage-rule.png) ### Paramètres de l’instance WireGuard Un hub centralisé pour gérer les paramètres d’une ou plusieurs instances WireGuard, permettant des ajustements de configuration simples. ![WireGuard Server Configuration](../screenshots/serverconfig.png) ### Console Accès rapide aux outils de débogage courants afin de diagnostiquer et résoudre les problèmes potentiels dans l’environnement WireGuard. ![Console](../screenshots/console.png) ### Gestion des utilisateurs Prend en charge les environnements multi‑utilisateur en permettant d’assigner différents niveaux d’autorisation, du simple accès restreint aux droits administrateur complets. ![User Manager](../screenshots/usermanager.png) ## Instructions de déploiement Suivez ces étapes pour déployer WireGuard WebAdmin: 1. **Préparer l’environnement** Créez d’abord un répertoire pour le projet et placez‑vous dedans: ```bash mkdir wireguard_webadmin && cd wireguard_webadmin ``` 2. **Télécharger le fichier Docker Compose** Choisissez l’une des commandes suivantes pour récupérer la dernière version du `docker-compose.yml` directement depuis le dépôt GitHub. ### Avec NGINX (recommandé) ```bash wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose.yml ``` Ce mode est recommandé pour exécuter l’interface web. Le déploiement générera automatiquement un certificat auto‑signé. Pour utiliser vos propres certificats, remplacez `nginx.pem` et `nginx.key` dans le volume `certificates`. ### Sans NGINX (mode debug/test uniquement) ```bash wget -O docker-compose.yml https://raw.githubusercontent.com/eduardogsilva/wireguard_webadmin/main/docker-compose-no-nginx.yml ``` 3. **Créer le fichier `.env`** Dans le même répertoire que `docker-compose.yml`, créez un fichier `.env`: ```env # Configurez SERVER_ADDRESS avec le nom DNS ou l’adresse IP du serveur. # Une mauvaise valeur provoquera des erreurs CSRF. SERVER_ADDRESS=my_server_address DEBUG_MODE=False ``` Remplacez `my_server_address` par l’adresse réelle de votre serveur. 4. **Lancer Docker Compose** #### Avec NGINX (recommandé) ```bash docker compose up -d ``` Accédez à l’interface via `https://votreserveur.exemple.com`. Avec un certificat auto‑signé, votre navigateur demandera une exception. #### Sans NGINX (mode debug/test) ```bash docker compose -f docker-compose-no-nginx.yml up -d ``` Accédez à l’interface via `http://127.0.0.1:8000`. Après ces étapes, WireGuard WebAdmin sera opérationnel. ## Instructions de mise à jour Pour profiter des dernières fonctionnalités et correctifs: 1. **Si vous utilisiez un clone Git** ```bash cd /chemin/vers/wireguard_webadmin_git_clone ``` 2. **Arrêter les services** ```bash docker compose down ``` 3. **Mettre à jour les images** ```bash docker compose pull ``` 4. **Sauvegarder vos données** ```bash tar cvfz wireguard-webadmin-backup-$(date +%Y-%m-%d-%H%M%S).tar.gz /var/lib/docker/volumes/wireguard_webadmin_wireguard/_data/ ``` Adaptez le chemin si nécessaire. 5. **Déployer à nouveau** Suivez les [instructions de déploiement](#instructions-de-déploiement) et récupérez la dernière version de `docker-compose.yml`. ### Vérifications post‑mise à jour - Vérifiez l’interface web et les journaux pour détecter d’éventuels problèmes. - Besoin d’aide ? Consultez la section [Discussions](https://github.com/eduardogsilva/wireguard_webadmin/discussions). ## Contribuer Les contributions sont **grandement appréciées**! Rejoignez‑nous pour améliorer ce projet open‑source. ## Support En cas de problème, ouvrez une *issue* sur la page GitHub du projet.