Panneau graphique 3X-UI¶

Dans cet article

• Fonctionnalités de déploiement
• Prise en main après le déploiement de 3X-UI
• Configurer une nouvelle connexion
• La connexion à 3X-UI depuis un PC
• Appareils mobiles Android
• Appareils mobiles iOS
• Mettre à jour 3X-UI
• Réinitialiser le nom d'utilisateur et le mot de passe pour 3X-UI
• Caractéristiques principales de 3X-UI
• Fonctionnalités de déploiement
• Tutoriel vidéo
• Commander un serveur avec 3X-UI via l'API

Fonctionnalités de déploiement¶

Prise en main après le déploiement de 3X-UI¶

Après le paiement de la commande, une notification confirmant que le serveur est prêt à fonctionner sera envoyée à l'adresse e-mail spécifiée lors de l'inscription. Elle contiendra l'adresse IP du VPS, ainsi que l'identifiant et le mot de passe pour la connexion. Les clients de notre entreprise gèrent l'équipement dans le panneau de contrôle du serveur et l'API - Invapi.

Vous pouvez également trouver ici les identifiants, qui peuvent se trouver soit dans l'onglet Configuration >> Tags du panneau de contrôle du serveur, soit dans l'e-mail qui vous a été envoyé :

• Lien pour accéder au webpanel 3X-UI : dans la balise webpanel . Le lien exact sous la forme https://3x-ui{Server_ID_from_Invapi}.hostkey.in:port figure dans l'e-mail envoyé lors de la remise du serveur ;
• Login : root ou admin;
• Password : Envoyé à votre adresse e-mail une fois que le serveur est prêt à être utilisé après le déploiement du logiciel. Il correspond à votre mot de passe SSH.

Configurer une nouvelle connexion¶

1. Après vous être connecté au panneau 3X-UI, allez sur l'onglet Inbounds et cliquez sur le bouton Add Inbound :

   

2. Remplissez les champs suivants dans le menu ouvert :

   • Remark - nommez la connexion en utilisant le type de protocole (ex: VLESS) ou le type de groupe client. Ce nom s'affichera dans la liste des connexions entrantes ;
   • Protocol - la sélection du protocole est réglée sur vless par défaut, mais elle peut être modifiée et configurée manuellement si vous le souhaitez ;
   • Listen IP - si vous laissez ce champ vide, le serveur écoutera sur toutes les adresses IP ;
   • Port - spécifiez le port 443.

   Remarque

   Les champs Total Flow (GB) et Expire Date sont optionnels.

   

3. Vous devez sélectionner l'onglet Stream et choisir le paramètre reality dans le champ Security.

   

4. Ensuite, passez aux paramètres du client. Développez la section Protocol et remplissez les champs requis :

   • Email - spécifie l'identifiant unique du client. Vous pouvez entrer une adresse e-mail, mais elle doit être unique pour chaque protocole. Si vous n'avez qu'un seul utilisateur, laissez l'ID généré automatiquement ou créez-en un nouveau en cliquant sur l'icône (Refresh) à côté du champ de saisie de l'e-mail. Si vous avez plusieurs utilisateurs, attribuez un identifiant lisible tel que [email protected].
   • ID - il s'agit de l'identifiant unique pour la connexion entrante. L'ID doit être composé de 32 caractères et ne peut contenir que des chiffres et des lettres latines minuscules. Il peut être généré automatiquement en cliquant sur l'icône (Refresh) à côté du champ de saisie de la clé.
   • Flow - réglez la valeur sur xtls-rprx-vision.

   

5. Passez aux paramètres Stream. Dans le champ uTLS, il est recommandé de sélectionner chrome, mais vous pouvez choisir n'importe quelle autre valeur dans la liste fournie.

6. Dans les champs Target et SNI (Server names dans l'interface avant la v.2.1.0), saisissez le domaine pour le masquage (ou laissez la valeur par défaut yahoo.com).

   Attention

   Il est recommandé de sélectionner un domaine différent du domaine par défaut. Choisissez l'une des options suggérées et remplacez la valeur par défaut dans les champs correspondants :

   • Dest: www.microsoft.com:443 et SNI: www.microsoft.com
   • Dest: dl.google.com:443 et SNI: dl.google.com

7. Dans Short IDs, cliquez sur l'icône (Refresh). Cette action générera un ID aléatoire.

8. Cliquez sur le bouton Get New Cert pour générer de nouvelles clés pour la Private Key et la Public Key.

   

9. Après avoir saisi les données, cliquez sur le bouton Create.

Si la configuration est correcte, vous aurez une entrée avec le protocole.

Les connexions pour d'autres protocoles peuvent être configurées de la même manière.

La connexion à 3X-UI depuis un PC¶

Divers clients peuvent être utilisés pour se connecter à 3X-UI : v2rayN, Invisible Man XRay, v2rayU, Nekoray et d'autres. Pour les appareils macOS, il est recommandé d'utiliser Hiddify.

Utilisation du client Hiddify sur Windows, Linux ou macOS¶

Pour se connecter à 3X-UI en utilisant le client Hiddify, suivez ces étapes :

1. Téléchargez la version de Hiddify avec le tag Latest et installez le paquet ou le fichier pour votre système d'exploitation.

2. Dans l'Explorateur, naviguez vers le chemin d'installation (généralement C:\Program Files\hiddify), sélectionnez Properties dans le menu contextuel du clic droit sur le fichier HiddifyNext.exe, et cliquez sur l'onglet Compatibility dans la fenêtre qui s'ouvre.

   Cliquez sur Change settings for all users, cochez la case Run this program as administrator, et cliquez sur OK.

   

3. Ouvrez le client Hiddify et configurez les paramètres suivants :

   • Allez dans Settings et choisissez Region - Other.

   

   • Allez dans Settings >> Config Options et réglez Service Mode - VPN (Experimental).

   

4. Ajoutez les données du serveur en suivant ces étapes :

   • Ouvrez le code QR avec les paramètres de connexion dans le panneau graphique 3X-UI :

     

   • Copiez le code QR contenant le nom de la connexion depuis le panneau graphique 3X-UI dans le presse-papiers (un seul clic suffit) ;

     

   • Naviguez vers la page Home et établissez une connexion au serveur en sélectionnant soit + New Profile, soit l'icône + située dans le coin supérieur droit.

   • Cliquez sur le panneau intitulé Add From Clipboard :

   

Une fois les données ajoutées avec succès, un message contextuel apparaîtra et le profil du serveur sera ajouté à la liste :

![](./images/hiddifynext_windows_5.png)

Pour se connecter à 3X-UI, appuyez sur le gros bouton rond. Si la connexion réussit, l'icône deviendra verte et affichera Connected. La déconnexion se fait de la même manière en cliquant sur le bouton.

Utilisation du client Nekoray sur Windows ou Linux¶

Pour se connecter à 3X-UI en utilisant le client Nekoray, suivez ces étapes :

1. Téléchargez l'archive contenant le programme Windows ou téléchargez et installez le paquet sur Linux.

   Pour utiliser Nekoray sur Windows, extrayez le dossier nekoray de l'archive sur votre disque et lancez nekoray.exe depuis le dossier.

2. Lors du premier lancement du client, spécifiez le noyau - sing-box. Vous pouvez changer le noyau dans le client déjà installé en allant dans Preference >> Basic settings >> Core.

3. Ajoutez les données du serveur. Pour ce faire :

   • Ouvrez le code QR avec les paramètres de connexion dans le panneau graphique 3X-UI :

     

     

   • Sans minimiser la fenêtre du navigateur contenant le code QR, allez dans le menu Program de Nekoray et sélectionnez Scan QR Code :

     

   ou

   • Copiez le code QR dans le panneau graphique 3X-UI dans le presse-papiers (cliquez simplement dessus) ;

   • Dans le client Nekoray, sélectionnez Program >> Add profile from clipboard.

4. Cochez la case à côté de Tun mode ;

5. Démarrez la connexion en faisant un clic droit sur son nom et en sélectionnant Start :

Appareils mobiles Android¶

Connexion via Hiddify¶

Pour se connecter à 3X-UI en utilisant Hiddify, suivez ces étapes :

1. Téléchargez et installez Hiddify depuis Google Play ou téléchargez l'APK approprié pour votre architecture sur le site du développeur.

2. Pour configurer les préréglages, ouvrez l'application Hiddify :

   • Allez dans l'élément de menu Settings sous l'icône (Burger) et sélectionnez Region - Other ;
   • Dans le menu (Burger), allez dans Settings >> Config Options. De là, réglez le Service Mode - VPN.

   

3. Incluez les données du serveur en suivant ces étapes :

   • Ouvrez le code QR avec les paramètres de connexion dans le panneau graphique 3X-UI sur le serveur :

     

     

   • Pour ajouter une connexion de serveur dans l'application Hiddify, naviguez vers l'écran principal et cliquez soit sur le bouton + New Profile, soit sur l'icône + située en haut à droite. Ensuite, sélectionnez Scan QR Code et scannez le code :

     

4. Une fois le scan terminé avec succès, un message s'affichera et le profil du serveur sera ajouté à la liste. Pour se connecter à 3X-UI, cliquez sur le gros bouton rond. Une fois la connexion établie, l'icône deviendra verte et affichera Connected. Pour vous déconnecter, cliquez simplement à nouveau sur le bouton.

5. Pour activer le mode proxy pour des applications spécifiques, allez dans (Burger) >> Settings et activez l'interrupteur Per-app Proxy. Ensuite, sélectionnez les applications souhaitées en cochant la case du mode proxy à côté d'elles.

   

Connexion via v2rayNG¶

Pour se connecter à 3X-UI en utilisant v2rayNG, suivez ces étapes :

1. Téléchargez et installez v2rayNG depuis Google Play.

2. Ouvrez l'application v2rayNG et cliquez sur le bouton (Plus) :

1. Dans le menu, choisissez l'option Import profile from QR code et scannez le code QR dans le panneau graphique 3X-UI :

Vous devez scanner le code QR avec les paramètres de connexion dans lepanneau graphique 3X-UI :

1. Activez la connexion.

Appareils mobiles iOS¶

Dans notre exemple, nous utiliserons le client Hiddify (https://apps.apple.com/us/app/hiddify-proxy-vpn/id6596777532). Alternativement, vous pouvez utiliser les clients v2box ou Shadowrocket. Pour se connecter à 3X-UI, suivez des instructions similaires à celles d'Android

Mettre à jour 3X-UI¶

Pour mettre à jour le panneau de contrôle vers la dernière version, connectez-vous à votre serveur via SSH ou via la Console Native et entrez le mot de passe root :

ssh root@<server_IP_address>

cd 3x-ui
docker compose down
docker compose pull 3x-ui
docker compose up -d

Réinitialiser le nom d'utilisateur et le mot de passe pour 3X-UI¶

Pour réinitialiser le nom d'utilisateur et le mot de passe du webpanel, utilisez l'algorithme suivant :

1. Connectez-vous via SSH au serveur en tant que root et installez les paquets nécessaires :

   apt update
   apt install sqlite3 python3 python3-pip
   pip install bcrypt
   

2. Générez un nouveau hachage de mot de passe :

   python3 -c "import bcrypt; print(bcrypt.hashpw(b'new_password', bcrypt.gensalt(rounds=10)).decode())"
   

   Attention

   Le mot de passe doit être configuré en utilisant uniquement des lettres latines, des chiffres et des caractères spéciaux.

   Copiez le résultat (par exemple $2b$10$ld5ru8ozYTOUX51uvwwXNuoue/G7l3Jp4irSXZuWO3IejUvBvReIW)

3. Ajoutez le mot de passe à la base de données x-ui. Pour ce faire, exécutez :

   sqlite3 /data/3x-ui/db/x-ui.db
   

   Ensuite, changez le nom d'utilisateur et le mot de passe en saisissant la commande à l'invite sqlite>

   UPDATE users SET username = 'root', password = 'hash_generated_earlier' WHERE id = 1;
   

   Puis quittez la console sqlite3 en entrant .quit ou en appuyant sur Ctrl+D.

Caractéristiques principales de 3X-UI¶

• Chiffrement du trafic : VLESS, Shadowsocks-2022 et XRay (XTLS) permettent de chiffrer le trafic de l'utilisateur, le rendant impossible à lire ou à surveiller par le fournisseur d'accès Internet ou des tiers.
• Authentification multi-facteurs : La prise en charge de l'authentification multi-facteurs renforce la sécurité et protège les données des utilisateurs contre tout accès non autorisé.
• Paramètres flexibles : La possibilité de configurer les paramètres de connexion tels que le type de chiffrement, les ports et les protocoles. Cela offre une flexibilité dans la configuration de la connexion et une facilité d'utilisation.
• Optimisation de la vitesse : Optimisation pour une connexion réseau rapide. Ils peuvent utiliser diverses technologies telles que TCP Fast Open et le Congestion Control, qui accélèrent latransmission des données et améliorent laqualité de la connexion.
• Support de divers systèmes d'exploitation : Windows, MacOS, Linux, Android et iOS. Cela garantit l'universalité et l'accessibilité du produit pour les utilisateurs sur n'importe quelle plateforme.
• Open Source : Il offre aux développeurs la possibilité d'étudier le code et d'apporter leurs propres modifications, ce qui peut aider à améliorer le produit et ses fonctionnalités.
• Fiabilité et stabilité : VLESS, Shadowsocks-2022 et XRay (XTLS) sont des protocoles fiables et stables. Ils offrent une vitesse de connexion et une stabilité élevées, ainsi qu'une protection des données de l'utilisateur.

Fonctionnalités de déploiement¶

• Sur les systèmes d'exploitation de type RHEL, les protocoles VLESS et Shadowsocks-2022 ne sont ouverts que sur le port 443 par défaut.
• Le temps d'installation est de 15 à 20 minutes, incluant l'OS.
• Installation conteneurisée de 3X-UI + SSL dans la zone hostkey.in.
• Logiciels installés :
  • Docker CE
  • Docker Compose.
• Xray Panel - le canal du développeur du panneau sur Telegram.
• La version utilisée est MHSanaei/3x-ui.
• Conteneurs utilisés :
  • ghcr.io/mhsanaei/3x-ui
  • jonasal/nginx-certbot:latest
• Chemin vers compose : /root/3x-ui.
• Chemin vers les répertoires montés : /data.

• Pour personnaliser l'installation, vous devez apporter des modifications dans /root/3x-ui/compose.yml, puis redémarrer compose via les commandes suivantes :

  • Pour arrêter les conteneurs, exécutez la commande :

    docker compose -f /root/3x-ui/compose.yml down
    

  • Pour activer les conteneurs, vous devez exécuter la commande :

    docker compose -f /root/3x-ui/compose.yml up -d
    

Tutoriel vidéo¶

Commander un serveur avec 3X-UI via l'API¶

Pour installer ce logiciel via l'API, suivez ces instructions.