Xray. Gérer le module
Cet article fait suite à Xray. 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 et domaine de camouflage), mise à jour, réinstallation et désinstallation. La gestion des utilisateurs VPN fait l’objet d’un article distinct : Xray. 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 de Xray. Le menu à trois points voisin regroupe les autres actions : ouvrir les journaux, lancer la mise à jour, réinstaller ou désinstaller le module.
Gérer le service
- « Démarrer » — lance le service Xray 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. Après la modification d’un utilisateur, sa chaîne de connexion reste la même : inutile de réimporter le lien ou de rescanner le code QR sur l’appareil.
⚠️ 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
La page « Général » des paramètres du module contient le groupe « Connexion », où se règlent les paramètres qui permettent aux appareils de joindre le serveur : le port et le domaine de camouflage. Le panneau les choisit lui-même à l’installation, mais si la connexion ne passe plus par le port ou le domaine actuel, vous pouvez les changer sans réinstaller le module.
- « Port » — port TCP sur lequel Xray accepte les connexions entrantes. Il est choisi à l’installation :
443s’il était libre, sinon8443. Changez-le si un autre service de l’hôte occupe ce port ou si la connexion n’y passe plus. - « Domaine de camouflage » — le vrai site public sous le trafic HTTPS ordinaire duquel se camoufle le vôtre (le camouflage est détaillé dans Xray. Comment fonctionne le service). Vous pouvez saisir votre propre domaine ou en choisir un parmi ceux proposés dans la liste : le panneau suggère quelques sites éprouvés. Indiquez le domaine sans
https://et sans port. Si la connexion ne fonctionne plus avec le domaine actuel, passez à un autre.
Le bouton d’enregistrement ne devient actif qu’une fois le port ou le domaine modifié. Au clic, le panneau demande une confirmation : ce n’est pas une précaution superflue, mais une protection contre la perte de connexion de tous les utilisateurs d’un coup.
‼️ Changer le port ou le domaine coupe toutes les connexions en cours
Le port et le domaine de camouflage sont intégrés à chaque lien vless://… émis et à chaque code QR. Dès que vous les modifiez, le panneau affiche la boîte de dialogue « Confirmer la modification des paramètres du module » avec un avertissement : le changement redémarre le module et coupe les connexions actives. Une fois la confirmation donnée, tous les liens et codes QR émis auparavant deviennent définitivement invalides : les applications clientes cessent de se connecter. Vous devrez émettre de nouveau le lien pour chaque utilisateur actif et le réimporter sur ses appareils. Prévoyez le changement pendant une fenêtre de maintenance et prévenez les utilisateurs à l’avance.
Si vous n’avez sur le module que des droits de lecture, les champs du groupe « Connexion » sont en lecture seule : seul un utilisateur disposant des droits de modification peut changer ces paramètres.
Mettre à jour le module
Dans le menu d’actions, choisissez « Mettre à jour Xray ». Le panneau vérifie si une version plus récente de Xray 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 chaînes de connexion sont conservées : inutile de réimporter le lien ou de rescanner le code QR sur l’appareil.
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 « Xray » 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 Xray ». Le panneau vous demande de confirmer la réinstallation dans la boîte de dialogue « Confirmer la réinstallation de Xray » : cliquez sur « Confirmer ». La même version de Xray est redéployée par-dessus la version actuelle et le service redémarre. La liste des utilisateurs, leurs identifiants et leurs chaînes de connexion sont conservés : il n’est pas nécessaire de réimporter le lien ni de rescanner le code QR dans l’application cliente.
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 identifiants : les chaînes de connexion vless://… déjà émises continuent de fonctionner sans reconnexion.
La réinstallation ne modifie pas les paramètres de connexion : le module redémarre sur le même port et avec le même domaine de camouflage qu’avant. Aucune boîte de dialogue de paramètres ne s’affiche avant la réinstallation, vous n’avez donc rien à ressaisir ; si le port ou le domaine doit changer, cela se fait séparément, dans le groupe « Connexion ».
Si des clients 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 rescannez le code QR dans l’application cliente. 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 Xray ». Le panneau demande de confirmer la désinstallation dans la boîte de dialogue « Confirmer la désinstallation du module Xray » : avec le module sont supprimées toutes les données associées, y compris les paramètres des utilisateurs ; après une nouvelle installation, le module 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 Xray, leurs identifiants et les chaînes de connexion vless://… générées. Les applications clientes déjà configurées ne pourront plus se connecter après la désinstallation : leurs paramètres deviennent invalides. Après une nouvelle installation, il faudra recréer le module et les utilisateurs ; de nouveaux identifiants et de nouveaux liens seront émis, et les clients devront réimporter la configuration. Les emplacements de la licence Xray 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
- Xray. Démarrage rapide — installation du module et première connexion.
- Xray. Gérer les utilisateurs — création, modification et suppression des utilisateurs, achat d’emplacements.
- Comment configurer un relais SMTP pour l’envoi d’e-mails — pour pouvoir envoyer aux utilisateurs leur lien de connexion par e-mail.