Amnezia. Gérer le module

Cet article fait suite à Amnezia. Démarrage rapide. Si vous n’avez pas encore installé le module ni créé le premier utilisateur, commencez par là. Vous trouverez ici les opérations sur le module lui-même : démarrage et arrêt du service, changement du port UDP, mise à jour, réinstallation et désinstallation. La gestion des utilisateurs VPN fait l’objet d’un article distinct : Amnezia. Gérer les utilisateurs.

En-tête de la page et menu d’actions

L’en-tête de la page donne accès aux actions principales sur le module : démarrer, arrêter et redémarrer le service. L’état du service est indiqué par un indicateur et par un badge portant la version d’AmneziaWG. Le menu à trois points voisin regroupe les autres actions : ouvrir les journaux, accéder aux paramètres du module, lancer la recherche et l’installation d’une mise à jour, réinstaller ou désinstaller le module.

Gérer le service

• « Démarrer » — lance le service AmneziaWG lorsqu’il est à l’arrêt.
• « Arrêter » — éteint le service. Toutes les connexions VPN actives sont coupées et aucune nouvelle connexion n’est possible.
• « Redémarrer » — arrête puis relance aussitôt le service. Les connexions ouvertes sont réinitialisées.

Le serveur applique à chaud les changements dans la liste des utilisateurs, sans redémarrer le service : que vous en ajoutiez, désactiviez ou supprimiez un, la nouvelle configuration est prise en compte immédiatement. En revanche, si le DNS du client ou le persistent keepalive est modifié dans la fiche d’un utilisateur, le fichier .conf doit être réimporté sur l’appareil — voir l’article Amnezia. Gérer les utilisateurs.

⚠️ L’arrêt du service coupe toutes les connexions VPN

Tant que le service est arrêté, aucun utilisateur ne peut se connecter. Planifiez l’arrêt et le redémarrage pendant une fenêtre de maintenance, ou prévenez les utilisateurs à l’avance.

Pendant la mise à jour, la réinstallation ou la désinstallation du module, les boutons de gestion du service et le menu d’actions sont temporairement indisponibles.

Journaux du module

Dans le menu d’actions, choisissez « Journaux » : le journal des opérations du cycle de vie du module s’ouvre (installation, mise à jour, réinstallation, désinstallation, changement de port). Chaque entrée indique son état et la sortie complète de l’exécution. Pratique si une action s’est terminée par une erreur et que vous voulez en comprendre la cause.

Paramètres du module

La partie serveur du module se configure sur une page distincte. Ouvrez-la par le menu d’actions → « Paramètres du module ». Dans l’onglet « Général », la section « Connexion » indique le port UDP sur lequel AmneziaWG accepte les connexions entrantes ; il est choisi à l’installation : 443 s’il était libre, sinon 51720.

Changer le port UDP

1. Dans le menu d’actions, choisissez « Paramètres du module », puis ouvrez l’onglet « Général ».
2. Dans le champ « Port » de la section « Connexion », saisissez le nouveau numéro. Pour un camouflage supplémentaire, on utilise souvent 80, 443 ou 8443, mais un conflit avec d’autres modules BeAdmin est possible : le panneau vous en avertit sous le champ.
3. Cliquez sur « Enregistrer ». Le panneau demande confirmation dans la boîte de dialogue « Confirmer la modification des paramètres du module ». Une fois la modification confirmée, le nouveau port est enregistré et le service redémarre automatiquement.

⚠️ Le changement de port interrompt les connexions actives

Une fois le nouveau port appliqué, les configurations client existantes cessent de fonctionner : le fichier .conf contient l’adresse et le port de l’ancien serveur. Il faut régénérer les configurations et les réimporter sur les appareils. Si vous rétablissez l’ancien port, les anciennes configurations fonctionnent de nouveau, sans qu’il soit nécessaire de réémettre les clés.

Mettre à jour le module

Dans le menu d’actions, choisissez « Mettre à jour Amnezia ». Le panneau vérifie si une version plus récente d’AmneziaWG est disponible dans le dépôt, l’installe par-dessus la version actuelle et redémarre le service. La liste des utilisateurs et leurs clés sont conservées : il n’est pas nécessaire de réimporter les fichiers .conf sur les appareils.

La mise à jour ne demande aucune confirmation : l’action démarre aussitôt. Pendant la mise à jour, les boutons de gestion du service et les entrées du menu sont indisponibles ; la version actuelle du module est visible sur le badge « AmneziaWG » de l’en-tête. Si la version installée est déjà la plus récente, la mise à jour ne démarre pas, et le panneau vous le signale.

Réinstaller le module

Dans le menu d’actions, choisissez « Réinstaller Amnezia ». Le panneau vous demande de confirmer la réinstallation : cliquez sur « Confirmer ». La même version d’AmneziaWG est déployée par-dessus la version actuelle et le service redémarre. La liste des utilisateurs, leurs clés et les connexions actives sont conservées : il n’est pas nécessaire de réimporter les fichiers .conf sur les appareils.

Utilisez la réinstallation si le module fonctionne de façon instable et que vous voulez rejouer l’installation sans perdre les utilisateurs. Contrairement à la désinstallation, la réinstallation n’efface ni les utilisateurs ni leurs clés : les configurations .conf déjà distribuées continuent de fonctionner, sans reconnexion ni réimport.

La réinstallation ne modifie pas le port : le module redémarre sur le même port UDP. Pour changer de port et réinstaller en même temps, effectuez les deux étapes séparément, dans l’ordre de votre choix : le changement de port dans « Paramètres du module » et la réinstallation du module.

Si les clients n’arrivent plus à se connecter après une réinstallation, téléchargez de nouveau le fichier .conf ou régénérez le code QR dans la ligne dépliée de l’utilisateur. Si les erreurs persistent, le dernier recours est de désinstaller complètement le module puis de l’installer à nouveau.

Désinstaller le module

Dans le menu d’actions, choisissez « Désinstaller Amnezia ». Le panneau demande de confirmer la désinstallation dans la boîte de dialogue « Confirmer la désinstallation du module Amnezia » : avec le module, tous les réglages des connexions des utilisateurs sont supprimés ; après une nouvelle installation, le serveur repart de zéro.

‼️ La désinstallation du module efface tous les utilisateurs VPN

La désinstallation est irréversible : avec le module disparaissent tous les utilisateurs Amnezia, leurs clés et les fichiers de configuration .conf générés. Les configurations client déjà importées ne pourront plus se connecter. Après une nouvelle installation, vous devrez recréer le module et les utilisateurs ; de nouvelles clés seront émises, et les clients devront réimporter leur configuration. Les emplacements de licence Amnezia sont libérés : vous pouvez les réutiliser ou oublier le module jusqu’à la prochaine installation.

Après la confirmation, le panneau lance la désinstallation. Une fois celle-ci terminée, la page du module revient à son état initial, avec le bouton « Installer ».

Étapes suivantes

• Amnezia. Démarrage rapide — installation du module et première connexion.
• Amnezia. Gérer les utilisateurs — création, modification et suppression des utilisateurs, achat d’emplacements supplémentaires.
• Comment configurer un relais SMTP pour l’envoi d’e-mails — pour pouvoir envoyer aux utilisateurs leur fichier .conf par e-mail.