3X-UI Panneau Graphique¶

Dans cet article

• Fonctionnalités de déploiement
• Démarrage après le déploiement de 3X-UI
• Configurer une nouvelle connexion
• La connexion à 3X-UI depuis 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
• Commander un serveur avec 3X-UI via l’API

Fonctionnalités de déploiement¶

Démarrage après le déploiement de 3X-UI¶

Après le paiement de la commande, une notification indiquant 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 le login et le mot de passe pour la connexion. Les clients de notre société gèrent l'équipement dans le panneau de contrôle du serveur et l'API - Invapi.

Ici, vous pouvez également trouver les identifiants, qui peuvent être trouvés soit dans l'onglet Info >> Tags du panneau de contrôle du serveur, soit dans l'e-mail qui vous a été envoyé:

• Link to access the 3X-UI webpanel: dans le tag webpanel. Le lien exact sous la forme https://{Server_ID_from_Invapi}.hostkey.in:XXXXX apparaît dans l'e-mail envoyé lors de la remise du serveur;
• Login: root;
• Password: Envoyé à votre adresse e-mail après que le serveur soit prêt à être utilisé suite au déploiement du logiciel.

Configurer une nouvelle connexion¶

1. Après vous être connecté au panneau 3X-UI, accédez à 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 ex. 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 changé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 ;

   Note

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

   

3. Sélectionnez l'onglet REALITY situé sous Security en bas de la fenêtre.

   

4. Accédez aux paramètres client et remplissez les champs nécessaires dans la section Client.

   • Email - identifiant client, doit être unique. Si vous entrez un e-mail, il doit également être unique pour chaque protocole. Si vous avez un utilisateur, conservez l'existant ou créez un nouvel utilisateur en cliquant sur l'icône (Actualiser) à côté du champ e-mail. S'il y a plusieurs utilisateurs, choisissez un identifiant lisible tel que [email protected] .
   • ID - identifiant unique pour la connexion entrante. L'ID doit comporter 32 caractères et ne peut contenir que des chiffres et des lettres minuscules de l'alphabet latin. Il peut être généré automatiquement en cliquant sur l'icône (Actualiser) devant le champ de saisie de clé.
   • Flow - la valeur est définie sur xtls-rprx-vision .

   

5. Accédez au paramètre REALITY et sélectionnez chrome dans le champ uTLS, ou choisissez une autre option dans la liste.

6. Entrez le domaine à masquer dans les champs Dest et SNI. L'option par défaut est yahoo.com.

   Attention

   Envisagez de sélectionner un domaine différent parmi les options proposées et de remplacer le domaine 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 ShortIds, 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 entré les données, cliquez sur le bouton Create.

Si configuré correctement, vous disposerez d'une entrée avec le protocole.

![](./images/3x-ui_add_inbound_6.png)

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

La connexion à 3X-UI depuis 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 le client FoXray ou 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 Hiddify avec le tag Latest et installez le paquet ou le fichier correspondant à 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, puis 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.

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

   • Accédez à Settings et choisissez Region - Other.

   

   • Accédez à Settings >> Config Options et définissez Service Mode - VPN (Experimental).

   

2. 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 du panneau graphique 3X-UI dans le presse-papiers (simplement en cliquant 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 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 :

   

Pour se connecter à 3X-UI, appuyez sur le gros bouton rond. Si la connexion réussit, l'icône deviendra verte et affichera Connected. Pour se déconnecter, procédez 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. Download 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 ce dossier.

1. La première fois que vous lancez le 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.

2. 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, accédez au menu Program dans Nekoray et sélectionnez Scan QR Code :

     

   ou

   • Copiez le code QR du panneau graphique 3X-UI dans le presse-papiers (simplement en cliquant dessus) ;
   • Dans le client Nekoray, sélectionnez Program >> Add profile from clipboard.

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

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

Appareils mobiles Android¶

Connexion avec Hiddify¶

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

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

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

   • Allez dans le menu Settings sous l'icône (Burger) et sélectionnez Region - Other ;
   • Dans le menu (Burger), accédez à Settings >> Config Options. De là, définissez le Service Mode - VPN.

   

3. 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 sur le serveur :
   • Pour ajouter une connexion serveur dans l'application Hiddify, accédez à l'écran principal et cliquez sur le bouton + New Profile ou 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 se connecter à 3X-UI, cliquez sur le gros bouton rond. Une fois la connexion établie, l'icône deviendra verte et affichera Connected. Pour se 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 que vous souhaitez en cochant la case de mode proxy à côté d'elles.

   

Connexion avec v2rayNG¶

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

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

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

   

3. 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 :

![](./images/3x-ui_qr_code.png)

1. Activez la connexion.

   

Appareils mobiles iOS¶

Pour configurer une connexion sur l'appareil local, commencez par configurer une nouvelle connexion dans le panneau GUI 3X-UI.

Dans notre exemple, nous utiliserons le client FoXray. Alternativement, vous pouvez utiliser le client v2box ou Shadowrocket.

Pour connecter 3X-UI en utilisant FoXray, suivez ces étapes :

1. Téléchargez et installez FoXray depuis l'App Store.

2. Ouvrez l'application FoXray et cliquez sur le bouton (Plus) (il vous permettra d'ajouter la configuration manuellement) ou scannez le code QR dans le panneau graphique 3X-UI :

1. Cliquez sur le bouton Play et autorisez l'application à ajouter la configuration VPN au dispositif :

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 HTML5] et entrez le mot de passe root :

ssh root@<IP-адрес сервера>

Ensuite, exécutez les commandes suivantes :

# Update the control panel to the latest version
cd /usr/local/3x-ui
git pull
npm install
pm2 restart 3x-ui

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 paquets nécessaires :

apt update
apt install python3 python3-pip

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

python3 -c "import hashlib; print(hashlib.sha256('new_password'.encode()).hexdigest())"

Copiez la sortie (par exemple $2b$10$ld5ru8ozYTOUX51uvwwXNuoue/G7l3Jp4irSXZuWO3IejUvBvReIW).

1. 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 des utilisateurs, rendant impossible sa lecture ou sa surveillance par le fournisseur d’accès Internet ou d’autres tiers.
• Authentification multi‑facteurs : Le support de l’authentification multi‑facteurs renforce la sécurité et protège les données des utilisateurs contre un 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 Contrôle de congestion, qui accélèrent la transmission des données et améliorent la qualité de la connexion.
• Support pour 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 de réaliser leurs propres modifications, ce qui peut contribuer à 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 grande vitesse de connexion et une stabilité, ainsi qu’une protection des données des utilisateurs.

Fonctionnalités de déploiement¶

• Sur 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, incluant 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
• Route vers compose : /root/3x-ui.
• Route 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
    

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

Pour installer ce logiciel en utilisant l’API, suivez ces instructions.