Skip to content

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, Smart DNS, version du protocole, 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, rechercher des mises à jour, réinstaller ou désinstaller le module.

En-tête de la page du module Amnezia : indicateur d’état, badge « AmneziaWG », boutons de démarrage, d’arrêt et de redémarrage, et menu d’actionsEn-tête de la page du module Amnezia : indicateur d’état, badge « AmneziaWG », boutons de démarrage, d’arrêt et de redémarrage, et menu d’actionsMenu d’actions du module Amnezia déplié, avec les entrées « Journaux », « Paramètres du module », « Rechercher des mises à jour », « Mettre à jour Amnezia », « Réinstaller Amnezia » et « Désinstaller Amnezia »Menu d’actions du module Amnezia déplié, avec les entrées « Journaux », « Paramètres du module », « Rechercher des mises à jour », « Mettre à jour Amnezia », « Réinstaller Amnezia » et « Désinstaller Amnezia »

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.

Smart DNS ​

Smart DNS est un service payant d’un fournisseur tiers qui débloque les services comme Netflix ou Gemini lorsqu’ils ne fonctionnent pas depuis l’adresse IP de votre serveur. BeAdmin ne le vend pas, il se contente de le connecter : l’adresse du serveur DNS du fournisseur est inscrite dans les configurations de vos utilisateurs.

  1. Dans le bloc « Smart DNS » de l’onglet « Général », activez « Utiliser Smart DNS » et saisissez dans le champ « Adresse du serveur DNS » l’adresse IPv4 indiquée dans votre compte chez le fournisseur.
  2. Enregistrez chez le fournisseur l’adresse IP du serveur affichée dans le bloc.
  3. Cliquez sur « Enregistrer », puis fournissez de nouveau leurs configurations aux utilisateurs : celles déjà importées sur les appareils ne se mettent pas à jour toutes seules.

Le « Serveur DNS » défini pour un utilisateur est conservé et revient dans ses configurations une fois Smart DNS désactivé.

⚠️ Si le serveur DNS du fournisseur est inaccessible

Les sites ne s’ouvriront plus par leur nom chez vos utilisateurs : désactivez Smart DNS et fournissez de nouveau les configurations.

Version du protocole ​

AmneziaWG existe en plusieurs versions du protocole, et toutes les applications clientes et tous les routeurs ne les prennent pas en charge. Le serveur fait tourner une seule version pour tous ses utilisateurs : choisissez-la en fonction des appareils depuis lesquels ils se connectent.

  • « AmneziaWG 3.1 » — la plus résistante aux blocages. Elle demande des applications récentes : AmneziaVPN 5.0.1.5 ou ultérieure, AmneziaWG pour Android 3.1.20260814 ou ultérieure, AmneziaWG pour Windows 3.1.0 ou ultérieure. Les routeurs Keenetic ne prennent pas en charge cette version.
  • « AmneziaWG 2.0 » — pour les routeurs Keenetic avec micrologiciel 5.1 ou ultérieur, et pour les appareils dont l’application ne prend pas encore en charge la 3.1. Elle fonctionne avec AmneziaVPN 4.8.12.9 ou ultérieure et AmneziaWG pour Android et Windows 2.0.0 ou ultérieure.
  • « AmneziaWG 1.0 » — uniquement pour les routeurs Keenetic avec micrologiciel 4.x.

La version se choisit à l’installation du module. Le bouton « Installer » installe « AmneziaWG 3.1 » ; pour en choisir une autre, cliquez sur le bouton en forme de roue dentée à droite de « Installer » et sélectionnez-la dans le champ « Version du protocole » de la boîte de dialogue « Paramètres d’installation ». Les serveurs où le module était déjà installé restent sur « AmneziaWG 1.0 », et les configurations déjà distribuées continuent de fonctionner comme avant. La version ne se change que par une réinstallation du module — voir Changer de version du protocole.

Mettre à jour le module ​

La recherche de mises à jour et la mise à jour du module se lancent depuis le menu d’actions.

  • « Rechercher des mises à jour » — vérifie si une nouvelle version d’AmneziaWG est sortie. La recherche s’effectue en arrière-plan : vous pouvez continuer à utiliser la page. Le résultat s’affiche dans une notification. Si une mise à jour est disponible, la notification contient un bouton « Mettre à jour ».
  • « Mettre à jour Amnezia » — apparaît dans le menu lorsque la recherche a trouvé une nouvelle version. Il permet de lancer la mise à jour même si vous avez déjà fermé la notification.

Avant la mise à jour, le panneau affiche une fenêtre avec la version qui sera installée et un avertissement : le module redémarre pendant la mise à jour, et les clients connectés perdent brièvement la connexion. La mise à jour démarre quand vous cliquez sur « Mettre à jour » dans cette fenêtre ; la nouvelle version est installée par-dessus la version actuelle. 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 change pas la version du protocole : un serveur en « AmneziaWG 2.0 » reçoit une version plus récente de la 2.0, mais ne passe pas à la 3.1. Pour changer de version, il faut réinstaller le module — voir Changer de version du protocole.

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. S’il n’y a pas de version plus récente, le panneau indique que le module est à jour.

Réinstaller le module ​

Dans le menu d’actions, choisissez « Réinstaller Amnezia ». Dans la boîte de dialogue de réinstallation, le champ « Version du protocole » est déjà réglé sur la version qui tourne actuellement sur le serveur, rappelée aussi sous le champ. Conservez-la et cliquez sur « Confirmer » : le module est redéployé et le service redémarre. La liste des utilisateurs, leurs clés et les fichiers .conf distribués sont conservés : il n’est pas nécessaire de les réimporter 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 : tant que la version du protocole reste la même, les configurations .conf déjà distribuées continuent de fonctionner, sans reconnexion ni réimport.

La réinstallation laisse AmneziaWG sur son port actuel. Pour déplacer le module vers un autre port, saisissez-le dans la boîte de dialogue de réinstallation ou changez-le dans « Paramètres du module » — voir Changer le port UDP. Si le nouveau port est occupé, le module ne démarre pas tant que le port n’est pas libéré.

Après le déplacement, les fichiers .conf et les codes QR émis auparavant cessent de fonctionner : le port y est inscrit en dur. Les clés ne changent pas, mais il faut de nouveau fournir les configurations aux utilisateurs.

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.

Changer de version du protocole ​

Pour faire passer le serveur à une autre version, sélectionnez-la dans le champ « Version du protocole » lors de la réinstallation, puis cliquez sur « Confirmer ». Le changement est possible dans les deux sens : par exemple de la 1.0 vers la 3.1, ou de la 3.1 vers la 2.0 si un utilisateur doit connecter un routeur Keenetic.

Changer de version génère de nouveaux paramètres de camouflage du trafic. Les utilisateurs sont conservés, mais tous les fichiers .conf et codes QR distribués auparavant cessent de fonctionner. Après la réinstallation :

  1. Fournissez de nouveau les configurations aux utilisateurs : téléchargez le fichier .conf ou ouvrez le code QR dans la ligne dépliée de l’utilisateur.
  2. Demandez aux utilisateurs d’importer la nouvelle configuration sur leurs appareils.
  3. Si l’application d’un utilisateur est plus ancienne que la version minimale requise pour le protocole choisi (voir Version du protocole), il faut la mettre à jour.

Si le serveur est le nœud de sortie d’une cascade, reliez de nouveau les deux serveurs après le changement — voir Relier les deux serveurs. La cascade ne fonctionne que si les deux panneaux sont à jour, dans une version qui propose le choix de la version du protocole.

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.

Boîte de dialogue de confirmation de la désinstallation du module Amnezia, avec un avertissement et le bouton « Confirmer »Boîte de dialogue de confirmation de la désinstallation du module Amnezia, avec un avertissement et le bouton « Confirmer »

‼️ 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 ​

BeAdmin © 2025. Tous droits réservés.