Xray. Gérer les utilisateurs

Cet article couvre les opérations sur la liste des utilisateurs VPN : comment elle est organisée, comment obtenir le lien de connexion, modifier un utilisateur, le désactiver temporairement ou le supprimer, et acheter des emplacements au-delà du quota gratuit. Le scénario minimal « installer le module et connecter le premier appareil » est décrit dans Xray. Démarrage rapide ; ici, nous entrons dans le détail.

La liste des utilisateurs

La liste s’ouvre par défaut sur la page du module Xray et contient tous les utilisateurs créés, avec l’état actuel de chacun. Au-dessus de la liste figure le nombre d’emplacements de licence encore libres : il indique s’il reste de la place pour un nouvel utilisateur. On crée un utilisateur avec le bouton « Créer un utilisateur » ; quand la limite est atteinte, le bouton devient inactif et une infobulle en donne la raison. Pour la limite et les emplacements, voir la section Limite d’utilisateurs.

Chaque utilisateur occupe une ligne qui se déplie d’un clic. Repliée, elle affiche le nom, l’adresse e-mail et le commutateur « Activé » pour une désactivation temporaire. Les actions sur l’utilisateur apparaissent quand la ligne est dépliée : cliquez dessus pour la déplier.

S’il n’y a pas encore d’utilisateurs

Juste après l’installation, la liste est vide : le panneau affiche la carte « Aucun utilisateur pour l’instant », qui propose de créer le premier utilisateur, avec le bouton « Créer un utilisateur ». Dès que le premier utilisateur est créé, la carte disparaît et la liste habituelle prend sa place.

Ligne d’utilisateur dépliée

La ligne dépliée est l’endroit où l’utilisateur récupère la configuration de son appareil et où se trouvent les actions sur lui.

Code QR et lien de connexion

Juste sous l’avatar, la ligne affiche un code QR : il contient un lien de la forme vless://… pour un client compatible Xray. Montrez ce code QR à l’utilisateur sur l’écran pour qu’il le scanne avec la caméra de son appareil, ou enregistrez l’image avec le bouton « Code QR » et envoyez-la par le moyen de votre choix. Le bouton « Lien » copie dans le presse-papiers la même chaîne vless://…. Si vous avez ouvert le panneau depuis l’appareil à partir duquel vous allez vous connecter, copiez directement le lien : le panneau le place dans le presse-papiers, et vous pouvez le coller dans le client sans caméra.

Xray n’utilise pas de fichier .conf : les clients n’acceptent que le lien, ou un code QR contenant ce même lien.

Envoi par e-mail

Le bouton « Envoyer par e-mail » envoie le lien de connexion à l’adresse figurant sur la fiche de l’utilisateur. Il est disponible si SMTP est configuré dans le panneau. Sinon, la ligne dépliée affiche l’indication « L’envoi d’e-mails n’est pas configuré sur ce serveur. », accompagnée du lien « Configurer » qui mène aux paramètres système du panneau, où l’on active le relais SMTP. Tant que le relais n’est pas configuré, le bouton « Envoyer par e-mail » reste inactif ; la copie du lien et le téléchargement du code QR fonctionnent indépendamment. Pour configurer le relais, consultez l’article Comment configurer un relais SMTP pour l’envoi d’e-mails.

Modification et suppression

Le bouton « Modifier » ouvre la boîte de dialogue des paramètres de l’utilisateur (détails dans la section Modifier un utilisateur). Le bouton « Supprimer » lance la suppression ; voir la section Supprimer un utilisateur.

Tuiles de l’adresse e-mail et des statistiques de trafic

Sous les boutons se trouvent une tuile avec l’adresse e-mail de l’utilisateur et des tuiles de statistiques de trafic pour cet utilisateur : entrant et sortant. Les compteurs proviennent des statistiques de Xray, se mettent à jour automatiquement et indiquent le volume cumulé depuis le démarrage du service. Lorsque le service Xray redémarre, les compteurs sont remis à zéro.

Créer un utilisateur

Le scénario minimal est décrit dans Xray. Démarrage rapide : ouvrez la boîte de dialogue avec le bouton « Créer un utilisateur », dans l’en-tête de la liste, et remplissez les champs « E-mail » et « Nom », obligatoires. Choisissez éventuellement la « Langue de l’utilisateur » pour le message contenant le lien ; le commutateur « Activé », dans le pied de la boîte de dialogue, détermine l’état de l’utilisateur dès sa création. Le bouton « Créer » est actif tant que les champs obligatoires sont remplis sans erreur de validation et que la licence dispose d’un emplacement libre (voir Limite d’utilisateurs).

Le sélecteur « Mode » figure en premier dans la boîte de dialogue : pour un utilisateur ordinaire, laissez-le sur « Autonome ». L’autre valeur, « Cascade », fait de l’utilisateur un maillon d’une chaîne de deux serveurs ; voir plus bas la section Mode : autonome ou cascade.

⚠️ Restrictions des fournisseurs d’accès

Le chiffrement du trafic fait du VPN un moyen fiable de protéger une connexion, mais dans certains pays et régions les fournisseurs d’accès appliquent des mesures techniques contre les protocoles VPN. Une disponibilité totale du service ne peut donc pas être garantie, quel que soit le type de connexion. Si un protocole ne fonctionne pas chez vous, essayez un autre module VPN du panneau. Si aucun ne fonctionne sur votre réseau, écrivez à l’assistance : nous vous rembourserons la licence.

Modifier un utilisateur

Dans la ligne dépliée, cliquez sur « Modifier » : la boîte de dialogue « Modifier l’utilisateur » s’ouvre.

Elle permet de changer :

• « Mode » — « Autonome » ou « Cascade ». Le mode peut être changé pour un utilisateur existant sans le recréer ; détails dans Mode : autonome ou cascade.
• « E-mail » — identifiant de l’utilisateur dans Xray. Mêmes règles qu’à la création : l’adresse doit être valide et unique parmi les utilisateurs existants.
• « Nom » — libellé libre pour s’y retrouver dans la liste.
• « Langue de l’utilisateur » — langue du message contenant le lien de connexion. Par défaut : « Anglais ».
• « Activé » — permet de désactiver temporairement le compte sans le supprimer.

Le bouton « Enregistrer » n’est actif que si le formulaire a changé par rapport à l’état actuel.

ℹ️ Changement d’adresse e-mail et connexions actives

L’adresse e-mail est l’identifiant de l’utilisateur dans Xray, et elle est intégrée au lien de connexion. Si l’utilisateur a déjà enregistré le lien dans une application cliente, celui-ci cessera de convenir après le changement d’adresse côté serveur : pour que le client continue à se connecter, récupérez le nouveau lien dans la ligne dépliée et réimportez-le dans l’application.

Mode : autonome ou cascade

Dans les boîtes de dialogue de création et de modification d’un utilisateur, le sélecteur « Mode » se trouve tout en haut : l’utilisateur fonctionne soit comme proxy autonome, soit au sein d’un VPN en cascade :

• « Autonome » — utilisateur ordinaire avec connexion directe : l’appareil accède à Internet via votre serveur. C’est la valeur par défaut, et c’est ainsi que fonctionnent tous les utilisateurs créés auparavant.
• « Cascade » — l’utilisateur devient un maillon d’une chaîne de deux installations BeAdmin (entrée → sortie). Convient lorsque le mode autonome cesse de fonctionner.

Lorsque « Cascade » est sélectionné, le sélecteur « Rôle dans la cascade » apparaît en dessous : le nœud d’entrée reçoit le trafic du client, le nœud de sortie l’envoie vers Internet :

• « Nœud d’entrée » — accepte les connexions du client et les redirige vers le nœud de sortie. C’est le lien vless://… de ce nœud que reçoit l’appareil final.
• « Nœud de sortie » — dernier maillon de la chaîne : il reçoit le trafic du nœud d’entrée et le fait sortir sur Internet. Cet utilisateur n’a pas de lien de connexion propre.

Pour une cascade, il faut un second serveur avec BeAdmin pour le nœud de sortie. Si vous n’en avez pas encore de convenable, nos partenaires proposent des VPS avec le panneau déjà installé, dans différents lieux.

Plus de 15 ans d’expérience dans l’hébergement. Votre VPS avec BeAdmin est prêt à l’emploi.

• Allemagne
• Pays-Bas
• Suède
• Suisse
• Espagne
• États-Unis

Choisir un serveur

La fiabilité européenne en toute simplicité. Lancez BeAdmin avec votre VPS en un clic.

• Allemagne
• Pays-Bas
• Suède
• Estonie
• Roumanie
• Suisse
• Espagne
• Royaume-Uni
• États-Unis

S’inscrire

Le mode se change aussi pour un utilisateur existant, sans le recréer : l’identifiant (UUID) et la chaîne de connexion sont conservés pour un utilisateur autonome et pour un nœud d’entrée. L’exception est le passage en nœud de sortie : la configuration de connexion propre à cet utilisateur est désactivée, et le panneau vous en avertit par la boîte de dialogue « Convertir en nœud de sortie » : « L’utilisateur … perdra ses paramètres de connexion en passant en mode nœud de sortie de cascade. Si une connexion est active, elle sera coupée. »

Le scénario complet — comment relier deux serveurs en chaîne, où récupérer le lien et où le coller, ce que signifie l’état de la cascade — est détaillé dans l’article Xray. Mode cascade.

Activer et désactiver un utilisateur

Chaque ligne d’utilisateur comporte un commutateur : un seul clic active ou désactive le compte, sans ouvrir de boîte de dialogue. Un utilisateur désactivé reste dans la liste et ses statistiques de trafic sont conservées, mais il est impossible de se connecter avec son lien. Les changements s’appliquent immédiatement, sans redémarrage du service.

Quand vous réactivez l’utilisateur, le lien ne change pas : la même chaîne vless://…, déjà enregistrée dans l’application cliente, refonctionne.

Supprimer un utilisateur

Dans la ligne dépliée, cliquez sur « Supprimer ». Le panneau demande de confirmer l’action dans la boîte de dialogue « Supprimer l’utilisateur », qui indique l’adresse de l’utilisateur à supprimer. Après la confirmation, l’emplacement de licence est libéré : vous pouvez créer un autre utilisateur à la place.

‼️ La suppression d’un utilisateur est irréversible

Après la confirmation, le compte et son identifiant sont perdus définitivement. Le lien vless://… importé dans l’application cliente cesse de fonctionner. Il est impossible de restaurer l’utilisateur « tel quel » : même si vous en créez un nouveau avec la même adresse, l’identifiant contenu dans le lien changera, et le client devra importer une nouvelle configuration.

Limite d’utilisateurs

ℹ️ La licence gratuite comprend un utilisateur

Avec la formule par défaut, le module Xray permet de créer un utilisateur VPN : de quoi couvrir un appareil, par exemple un smartphone personnel. Pour plusieurs appareils ou pour les membres d’une famille, il faudra acheter des emplacements supplémentaires.

Ce qui change selon le niveau d’occupation du quota :

• Dans la limite du quota (N < M) — créez de nouveaux utilisateurs librement.
• Limite atteinte (N = M) — il n’est plus possible de créer de nouveaux utilisateurs. Pour continuer, achetez des emplacements avec le lien « Acheter des emplacements », directement dans la tuile, ou supprimez les utilisateurs inutiles.
• Limite dépassée (N > M, par exemple après le passage à une formule inférieure) — les utilisateurs créés le plus récemment restent dans la liste, mais sans configuration utilisable : ni lien ni code QR ne leur sont délivrés, et l’envoi par e-mail comme la modification sont indisponibles. Pour qu’ils refonctionnent, achetez des emplacements ou supprimez les utilisateurs en trop.

Le lien « Acheter des emplacements » mène à la section « Licence » : vers l’achat d’une nouvelle licence si vous n’en avez pas encore, ou vers la modification de la licence existante, avec le nombre d’emplacements prérempli. La licence s’ajoute au quota gratuit : si elle porte, par exemple, 5 emplacements, vous disposerez au total de 6 utilisateurs (1 gratuit + 5 sous licence). Dans la section « Licence », cette option apparaît sous l’intitulé lisible « Xray VPN ».

Étapes suivantes

• Xray. Démarrage rapide — installation du module et première connexion.
• Xray. Gérer le module — gestion du service, mise à jour et désinstallation du module.
• Xray. Mode cascade — comment relier deux serveurs en une chaîne « entrée → sortie ».
• Comment configurer un relais SMTP pour l’envoi d’e-mails — pour pouvoir envoyer aux utilisateurs leur lien de connexion par e-mail.