Panneau 3X-UI sur un VPS : configuration VLESS Reality et connexion des clients

Dès que votre serveur est prêt, nous vous envoyons par e-mail son adresse IP, le mot de passe root et le lien vers votre panneau 3X-UI. Le lien contient le port du panneau. Les mêmes informations figurent dans votre espace client, dans les détails du serveur.

1. Ouvrez le lien du panneau indiqué dans l’e-mail.
2. Connectez-vous avec l’identifiant root (admin sur certaines installations).
3. Saisissez le mot de passe root de votre serveur, le même que pour SSH.

Cet exemple utilise VLESS avec Reality : le trafic VPN ressemble alors à une visite HTTPS ordinaire d’un site connu.

1. Ouvrez l’onglet Inbounds et cliquez sur Add Inbound.
2. Remark : nommez la connexion, par exemple VLESS. Le nom apparaît dans la liste des inbounds.
3. Protocol : laissez vless.
4. Listen IP : laissez vide pour que le serveur écoute sur toutes les adresses.
5. Port : saisissez 443.

Dans la même fenêtre, réglez la sécurité du transport et les informations du client :

1. Dans la section Stream (Transport), réglez Security sur reality.
2. Sous Client, gardez l’Email généré ou saisissez un libellé lisible comme user1. Il doit être unique pour chaque client.
3. Gardez l’ID généré ou cliquez sur l’icône d’actualisation pour en obtenir un nouveau.
4. Réglez Flow sur xtls-rprx-vision.
5. Réglez uTLS sur chrome.
6. Remplacez les valeurs par défaut de Target (Dest) et SNI par un autre site, par exemple www.microsoft.com:443 et www.microsoft.com, ou dl.google.com:443 et dl.google.com.
7. Cliquez sur l’icône d’actualisation à côté de Short IDs pour en générer un.
8. Cliquez sur Get New Cert pour créer les clés privée et publique.
9. Cliquez sur Create.

Hiddify est le client le plus simple pour débuter, sur les trois systèmes.

1. Téléchargez la dernière version de Hiddify pour votre système sur sa page GitHub et installez-la.
2. Sous Windows, ouvrez C:\Program Files\hiddify, faites un clic droit sur HiddifyNext.exe, choisissez Propriétés > Compatibilité > Modifier les paramètres pour tous les utilisateurs, cochez Exécuter ce programme en tant qu’administrateur et cliquez sur OK.
3. Dans Hiddify, allez dans Settings et réglez Region sur Other.
4. Dans Settings > Config Options, réglez Service Mode sur VPN.
5. Dans le panneau 3X-UI, ouvrez le QR code de la connexion et cliquez dessus une fois pour copier le lien.
6. Dans Hiddify, cliquez sur + New Profile (ou + en haut à droite) et choisissez Add From Clipboard.
7. Cliquez sur le grand bouton rond. Il devient vert et affiche Connected. Cliquez à nouveau pour vous déconnecter.

Nekoray offre plus de contrôle sur le routage. v2rayN est une alternative similaire sous Windows.

1. Téléchargez Nekoray. Sous Windows, extrayez le dossier nekoray et lancez nekoray.exe ; sous Linux, installez le paquet.
2. Au premier lancement, choisissez le cœur sing-box. Vous pourrez le changer dans Preferences > Basic settings > Core.
3. QR code ouvert dans le panneau 3X-UI, choisissez Program > Scan QR Code. Ou copiez le lien dans le panneau et choisissez Program > Add profile from clipboard.
4. Cochez Tun mode.
5. Faites un clic droit sur le profil et choisissez Start.

Utilisez Hiddify depuis Google Play (ou l’APK de son site), ou v2rayNG.

1. Dans Hiddify, ouvrez le menu, allez dans Settings et réglez Region sur Other.
2. Dans Settings > Config Options, réglez Service Mode sur VPN.
3. Sur l’écran principal, touchez + New Profile (ou +), choisissez Scan QR Code et scannez le code du panneau 3X-UI.
4. Touchez le grand bouton rond pour vous connecter.
5. Pour ne faire passer que certaines applications par le VPN, activez Per-app Proxy dans Settings et cochez-les.
6. Avec v2rayNG : touchez +, choisissez Import config from QR code, scannez le code et démarrez la connexion.

Installez Hiddify depuis l’App Store. V2Box et Shadowrocket fonctionnent aussi.

1. Ouvrez Hiddify et touchez + New Profile (ou +).
2. Choisissez Scan QR Code et scannez le code du panneau 3X-UI.
3. Touchez le grand bouton rond pour vous connecter.

Pour passer à la dernière version du panneau, connectez-vous au serveur en SSH en tant que root et récupérez la nouvelle image :

ssh root@SERVER_IP
cd /root/3x-ui
docker compose down
docker compose pull 3x-ui
docker compose up -d

Si vous avez perdu l’accès au panneau, définissez-en un nouveau dans sa base de données. Connectez-vous en SSH en tant que root, puis :

apt update
apt install -y sqlite3 python3-bcrypt

# générer le hash du nouveau mot de passe
python3 -c "import bcrypt; print(bcrypt.hashpw(b'NEW_PASSWORD', bcrypt.gensalt(rounds=10)).decode())"

# l’enregistrer (exécutez la ligne UPDATE à l’invite sqlite>)
sqlite3 /data/3x-ui/db/x-ui.db
UPDATE users SET username = 'root', password = 'HASH' WHERE id = 1;
.quit

cd /root/3x-ui && docker compose restart

Le panneau tourne dans des conteneurs Docker que vous pouvez modifier si besoin.

1. Docker CE et Docker Compose.
2. 3X-UI (ghcr.io/mhsanaei/3x-ui), le panneau et le cœur Xray.
3. Nginx avec Certbot (jonasal/nginx-certbot), qui sert le panneau en HTTPS.
4. Fichier Compose : /root/3x-ui/compose.yml. Données : /data.

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