Hysteria. Gérer le module

Cet article fait suite à Hysteria. 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, consultation des journaux, paramètres de connexion (port, obfuscation, certificat), mise à jour, réinstallation et désinstallation. La gestion des utilisateurs VPN fait l’objet d’un article distinct : Hysteria. 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’Hysteria. Le menu à trois points voisin regroupe les autres actions : ouvrir les journaux, accéder aux paramètres du module, lancer la mise à jour, réinstaller ou désinstaller le module.

Gérer le service

• « Démarrer » — lance le service Hysteria 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, le changement est pris en compte immédiatement. Le lien de l’utilisateur reste alors le même : inutile de l’ajouter de nouveau dans l’application.

⚠️ 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). 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.

Connexion

Dans le menu d’actions, choisissez « Paramètres du module » : la page « Général » s’ouvre, avec le groupe « Connexion ». Il regroupe les paramètres par lesquels les appareils joignent le serveur : le port et l’obfuscation. Le mode du certificat y figure aussi, en lecture seule. Si la connexion ne passe plus par le port actuel, ou si le fournisseur d’accès bloque QUIC, vous pouvez modifier ces paramètres sans réinstaller le module.

• « Port » — port UDP sur lequel Hysteria accepte les connexions. Il est choisi à l’installation : 443 s’il était libre, sinon 2053. Les numéros de 1 à 65535 sont acceptés. Changez-le si un autre service du serveur occupe ce port ou si la connexion n’y passe plus. Si le port est déjà occupé par un autre module BeAdmin, un avertissement s’affiche sous le champ. S’il est occupé par un processus étranger, le panneau signale une erreur et conserve l’ancien port.
• « Obfuscation » — commutateur, désactivé par défaut. Activez-le si le fournisseur d’accès bloque QUIC ou HTTP/3. Avec l’obfuscation, le serveur ne ressemble plus à un site HTTP/3 et n’affiche plus de page de maintenance ; le principe est décrit dans Hysteria. Comment fonctionne le service.
• « Certificat » — indique le certificat utilisé par le serveur : « Let's Encrypt sur l’IP du serveur » ou « Auto-signé ». Le mode ne peut pas être changé dans les paramètres : il est choisi à la première installation, voir Certificat.

Le bouton « Enregistrer » n’est actif que si vous avez modifié le port ou l’obfuscation. Au clic, le panneau demande de confirmer le changement : c’est une protection contre la perte de connexion de tous les utilisateurs d’un coup.

‼️ Changer le port ou l’obfuscation coupe toutes les connexions et invalide les liens

Le port et les paramètres d’obfuscation sont inscrits dans chaque lien hysteria2://… émis et dans chaque code QR. Une fois la confirmation donnée, le service redémarre, les connexions actives sont coupées et tous les liens et codes QR émis auparavant cessent de fonctionner : les applications clientes ne parviennent plus à se connecter. Il faut transmettre de nouveau le lien à chaque utilisateur et l’ajouter dans l’application. Prévoyez le changement pendant une fenêtre de maintenance et prévenez les utilisateurs à l’avance. Si vous rétablissez les anciennes valeurs, les anciens liens refonctionnent.

Si le service ne démarre pas après le changement de port, vérifiez que le port choisi est libre et choisissez-en un autre.

Certificat

Le panneau choisit le mode du certificat une seule fois, à la première installation du module : s’il possède un certificat Let’s Encrypt pour l’adresse IP du serveur, il l’utilise ; sinon, il crée un certificat auto-signé. Les deux modes conviennent au fonctionnement du module et à la connexion des utilisateurs. La différence se voit dans le lien : avec un certificat auto-signé, il contient l’empreinte du certificat, avec laquelle l’application vérifie le serveur.

La réinstallation du module conserve le mode. Si vous avez besoin d’un autre mode, désinstallez le module puis installez-le à nouveau — mais gardez à l’esprit que la désinstallation supprime tous les utilisateurs et les liens émis, voir Désinstaller le module.

Mettre à jour le module

Dans le menu d’actions, choisissez « Mettre à jour Hysteria ». Le panneau vérifie si une version plus récente d’Hysteria est disponible, l’installe par-dessus la version actuelle et redémarre le service. La liste des utilisateurs, le port, l’obfuscation et les liens sont conservés : inutile d’ajouter de nouveau le lien dans les applications.

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 « Hysteria » 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. Si une version est sortie dont la compatibilité avec le panneau n’a pas encore été vérifiée, le panneau le signale aussi : cette version sera disponible avec une mise à jour du panneau.

Réinstaller le module

Dans le menu d’actions, choisissez « Réinstaller Hysteria ». Le panneau demande de confirmer la réinstallation : cliquez sur « Confirmer ». Le module est installé de nouveau et le service redémarre. Les utilisateurs, le port, l’obfuscation et le mode du certificat sont conservés, et les liens émis continuent de fonctionner.

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, elle n’efface pas les utilisateurs et ne change pas les liens.

La réinstallation laisse Hysteria sur son port actuel. Pour déplacer le module vers un autre port, saisissez-le dans le champ « Port » de la boîte de dialogue de réinstallation ou changez-le dans le groupe « Connexion ». Après le déplacement, les liens et les codes QR émis auparavant cessent de fonctionner — le port y est inscrit — et il faut les remettre de nouveau aux utilisateurs.

Si des utilisateurs n’arrivent plus à se connecter après la réinstallation, copiez de nouveau le lien depuis la ligne dépliée de l’utilisateur ou affichez le code QR. 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 Hysteria ». Le panneau demande de confirmer la désinstallation : avec le module sont supprimés les utilisateurs, le certificat et les paramètres.

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

La désinstallation est irréversible : avec le module disparaissent tous les utilisateurs Hysteria, leurs mots de passe et les liens hysteria2://…. Les applications où ces liens ont déjà été ajoutés ne pourront plus se connecter après la désinstallation. Après une nouvelle installation, il faudra recréer les utilisateurs : les liens seront différents, et il faudra les ajouter de nouveau dans chaque application. Les emplacements de la licence Hysteria 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

• Hysteria. Démarrage rapide — installation du module et première connexion.
• Hysteria. Gérer les utilisateurs — création, modification et suppression des utilisateurs, achat d’emplacements.
• Hysteria. Configurer les applications clientes — quelle application installer et que faire si la connexion échoue.
• Comment configurer un relais SMTP pour l’envoi d’e-mails — pour pouvoir envoyer aux utilisateurs leur lien de connexion par e-mail.