Panneau graphique 3X-UI¶

Dans cet article

• Fonctionnalités de déploiement
• Premiers pas 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
• Mise à jour de 3X-UI
• Réinitialisation du nom d'utilisateur et du mot de passe pour 3X-UI
• Fonctionnalités clés de 3X-UI
• Fonctionnalités de déploiement
• Tutoriel vidéo
• Commande d'un serveur avec 3X-UI en utilisant l'API

Fonctionnalités de déploiement¶

Premiers pas après le déploiement de 3X-UI¶

Après le paiement de la commande, une notification de la disponibilité du serveur sera envoyée à l'adresse e-mail spécifiée lors de l'inscription. Elle contiendra l'adresse IP du VPS, ainsi que le nom d'utilisateur 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 y trouver les identifiants, qui se trouvent soit dans l'onglet Configuration >> Tags du panneau de contrôle du serveur, soit dans l'e-mail qui vous a été envoyé :

• Lien d'accès au panneau web 3X-UI : dans la balise webpanel. Le lien exact de la forme https://3x-ui{Server_ID_from_Invapi}.hostkey.in:port est envoyé par e-mail lors de la remise du serveur ;
• Login : root ;
• Mot de passe : Envoyé à votre adresse e-mail après que le serveur est prêt à être utilisé suite au déploiement du logiciel.

Configurer une nouvelle connexion¶

1. Après vous être connecté au panneau 3X-UI, allez dans 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 (par exemple VLESS) ou le type de groupe client. Ce nom sera affiché dans la liste des connexions entrantes ;
   • Protocol - la sélection du protocole est définie sur vless par défaut, mais elle peut être modifiée et configurée manuellement si souhaité ;
   • 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 facultatifs.

   

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

   

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

   • Email - spécifie l'ID client unique. Vous pouvez entrer une adresse e-mail, mais elle doit également être unique pour chaque protocole. Si vous avez un seul utilisateur, laissez l'ID généré automatiquement ou créez-en un nouveau en cliquant sur l'icône (Actualiser) à côté du champ de saisie de l'e-mail. Si vous avez plusieurs utilisateurs, attribuez un identifiant lisible tel que [email protected].
   • ID - c'est l'identifiant unique pour la connexion entrante. L'ID doit comporter 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 (Actualiser) à côté du champ de saisie de la clé.
   • Flow - définissez 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 de la liste fournie.

6. Dans les champs Target et SNI (Server names dans l'interface avant la v.2.1.0), entrez 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 plutôt que celui 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 (Actualiser). 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 Private Key et 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 autres. Pour les appareils macOS, il est recommandé d'utiliser Hiddify.

Utilisation du client Hiddify sur Windows, Linux ou macOS¶

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

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

2. Dans l'Explorateur, accédez au chemin d'installation (généralement C:\Program Files\hiddify), sélectionnez Properties dans le menu contextuel du 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 définissez 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 dans le panneau graphique 3X-UI dans le presse-papiers (il suffit de cliquer dessus) ;

   • Accédez à 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 étiqueté Add From Clipboard :

   

   Après l'ajout réussi des données, un message contextuel apparaîtra et le profil du serveur sera ajouté à la liste :

   

Pour vous connecter à 3X-UI, appuyez sur le grand bouton rond. Si la connexion est réussie, 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 vous 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 package sur Linux.

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

2. Lors du premier démarrage 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 réduire la fenêtre du navigateur avec le code QR, allez dans le menu Program dans Nekoray et sélectionnez Scan QR Code :

     

   ou

   • Copiez le code QR dans le panneau graphique 3X-UI dans le presse-papiers (il suffit de cliquer 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 avec Hiddify¶

Pour vous 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 depuis le site Web du développeur.

2. Pour compléter 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. À partir de là, définissez 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 serveur dans l'application Hiddify, accédez à l'écran principal et cliquez soit sur le bouton + New Profile soit sur l'icône + située dans le coin supérieur droit. 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 vous connecter à 3X-UI, cliquez sur le grand 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 avec v2rayNG¶

Pour vous 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 le panneau 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 le client v2box ou Shadowrocket. Pour vous connecter à 3X-UI, veuillez suivre des instructions similaires à celles d'Android

Mise à jour de 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éinitialisation du nom d'utilisateur et du mot de passe pour 3X-UI¶

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

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

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

2. Générez un nouveau hash 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 défini en utilisant uniquement des lettres latines, des chiffres et des caractères spéciaux.

   Copiez la sortie (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, modifiez le nom d'utilisateur et le mot de passe en entrant la commande à sqlite>

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

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

Fonctionnalités clés de 3X-UI¶

• Chiffrement du trafic : VLESS, Shadowsocks-2022 et XRay (XTLS) permettent de chiffrer le trafic de l'utilisateur, rendant impossible la lecture ou la surveillance par le fournisseur de services Internet ou d'autres tiers.
• Authentification multi-facteurs : La prise en charge de l'authentification multi-facteurs améliore la sécurité et protège les données des utilisateurs contre les accès non autorisés.
• 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 Congestion Control, qui accélèrent la transmission des données et améliorent la qualité de la connexion.
• Prise en charge de divers systèmes d'exploitation : Windows, MacOS, Linux, Android et iOS. Cela assure 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 et une stabilité de connexion élevées, ainsi que la protection des données des utilisateurs.

Fonctionnalités de déploiement¶

• Dans les systèmes d'exploitation de type RHEL, les protocoles VLESS et Shadowsocks-2022 sont ouverts uniquement sur le port 443 par défaut.
• Le temps d'installation est de 15 à 20 minutes, y compris le système d'exploitation.
• Installation conteneurisée de 3X-UI + SSL dans la zone hostkey.in.
• Logiciels installés :
  • Docker CE
  • Docker Compose.
• Xray Panel - le canal du panneau du développeur sur Telegram.
• La build 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 Ensuite, redémarrez compose via les commandes :

  • 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 -d up
    

Tutoriel vidéo¶

Commande d'un serveur avec 3X-UI en utilisant l'API¶

Pour installer ce logiciel en utilisant l'API, suivez les instructions suivantes.