Skip to content

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), Smart DNS, 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, 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 Xray : indicateur d’état, badge « Xray », boutons de démarrage, d’arrêt et de redémarrage, et menu d’actionsEn-tête de la page du module Xray : indicateur d’état, badge « Xray », boutons de démarrage, d’arrêt et de redémarrage, et menu d’actionsMenu d’actions déplié du module Xray avec les entrées « Journaux », « Paramètres du module », « Rechercher des mises à jour », « Mettre à jour Xray », « Réinstaller Xray » et « Désinstaller Xray »Menu d’actions déplié du module Xray avec les entrées « Journaux », « Paramètres du module », « Rechercher des mises à jour », « Mettre à jour Xray », « Réinstaller Xray » et « Désinstaller Xray »

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, le domaine de camouflage et l’accès des utilisateurs VPN au réseau local du serveur. Le panneau choisit lui-même le port et le domaine à 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.

Groupe « Connexion » de la page « Général » du module Xray : champ « Port » et champ « Domaine de camouflage » avec la liste des domaines proposés ouverteGroupe « Connexion » de la page « Général » du module Xray : champ « Port » et champ « Domaine de camouflage » avec la liste des domaines proposés ouverte
  • « Port » — port TCP sur lequel Xray accepte les connexions entrantes. Il est choisi à l’installation : 443 s’il était libre, sinon 8443. 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.
  • « Accès au réseau local via le VPN » — commutateur, désactivé par défaut. Tant qu’il est désactivé, les utilisateurs VPN ne peuvent pas accéder au réseau local du serveur : les bases de données et les services internes disponibles sur ses adresses leur restent fermés. Activez-le si votre équipe a besoin de ces services pour travailler ensemble. Les services accessibles uniquement depuis le serveur lui-même (localhost) restent fermés via le VPN dans tous les cas, quelle que soit la position du commutateur.

Le bouton d’enregistrement devient actif dès que vous avez modifié au moins un paramètre. Le panneau demande de confirmer un changement de port ou de domaine : c’est une protection contre la perte de connexion de tous les utilisateurs d’un coup. Le commutateur « Accès au réseau local via le VPN » s’enregistre sans confirmation. Le service redémarre alors et les connexions actives sont coupées, mais les liens émis restent valables.

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

Boîte de dialogue « Confirmer la modification des paramètres du module » avec l’avertissement sur le redémarrage du module et la coupure des connexions activesBoîte de dialogue « Confirmer la modification des paramètres du module » avec l’avertissement sur le redémarrage du module et la coupure des connexions actives

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.

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 : seuls les services sélectionnés passent par le fournisseur, tout le reste du trafic sort directement du serveur.

  1. Dans le bloc « Smart DNS » de la page « 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. Sélectionnez des services ou ajoutez des « Domaines personnalisés ».
  4. Cliquez sur « Enregistrer ».

⚠️ L’enregistrement redémarre Xray

Les connexions actives sont alors coupées.

💡 Utilisateurs en cascade

Pour les utilisateurs en cascade, activez Smart DNS sur le nœud de sortie.

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 de Xray 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 Xray » — 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 chaînes de connexion sont conservées : inutile de réimporter le lien ou de rescanner le code QR sur l’appareil.

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. 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 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 laisse Xray sur son port actuel et avec le même domaine de camouflage. Pour déplacer le module vers un autre port, saisissez-le dans la boîte de dialogue de réinstallation ou changez-le dans le groupe « Connexion ». 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 liens vless://… et les codes QR émis auparavant cessent de fonctionner : le port y est inscrit en dur. Les identifiants ne changent pas, mais il faut de nouveau fournir les liens aux utilisateurs.

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.

Boîte de dialogue de confirmation de la désinstallation du module Xray, avec un avertissement et le bouton « Confirmer »Boîte de dialogue de confirmation de la désinstallation du module Xray, 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 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 ​

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