Que fait Xray ?
Aperçu
Déployez et configurez Xray-core — la plateforme proxy avancée prenant en charge les protocoles VLESS, VMess, Trojan et Shadowsocks avec des transports modernes comme Reality, XTLS-Vision, WebSocket, gRPC et HTTP/2. Cette compétence couvre le déploiement du serveur, la sélection de protocole, la configuration TLS/Reality, le routage du trafic, la gestion multi-utilisateur, l'intégration CDN, la configuration client et la surveillance.
Instructions
Étape 1 : Installation
bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ install
xray version
# Binaire : /usr/local/bin/xray
# Configuration : /usr/local/etc/xray/config.json
# Générer UUID et clés X25519
xray uuid
xray x25519 # Paire de clés privée + publique pour Reality
Étape 2 : VLESS + Reality (Recommandé)
La configuration la plus sécurisée. Reality imite la poignée de main TLS d'un site web HTTPS réel, éliminant le besoin d'un nom de domaine ou d'un certificat TLS.
Configuration serveur (/usr/local/etc/xray/config.json):
{
"log": { "loglevel": "warning" },
"inbounds": [{
"listen": "0.0.0.0",
"port": 443,
"protocol": "vless",
"settings": {
"clients": [
{ "id": "VOTRE-UUID", "flow": "xtls-rprx-vision", "email": "user1@proxy" }
],
"decryption": "none"
},
"streamSettings": {
"network": "tcp",
"security": "reality",
"realitySettings": {
"dest": "www.microsoft.com:443",
"serverNames": ["www.microsoft.com", "microsoft.com"],
"privateKey": "VOTRE-CLÉ-PRIVÉE",
"shortIds": ["", "0123456789abcdef"]
}
},
"sniffing": { "enabled": true, "destOverride": ["http", "tls", "quic"] }
}],
"outbounds": [
{ "protocol": "freedom", "tag": "direct" },
{ "protocol": "blackhole", "tag": "block" }
],
"routing": {
"rules": [{ "type": "field", "ip": ["geoip:private"], "outboundTag": "block" }]
}
}
Lien de partage client :
vless://UUID@IP_DU_SERVEUR:443?encryption=none&flow=xtls-rprx-vision&security=reality&sni=www.microsoft.com&fp=chrome&pbk=CLÉ_PUBLIQUE&sid=0123456789abcdef&type=tcp#MonProxy
systemctl enable --now xray
Étape 3 : VLESS + WebSocket + TLS (Compatible CDN)
Pour le routage via le CDN Cloudflare afin de masquer l'adresse IP du serveur. Nécessite un nom de domaine avec proxy Cloudflare et un certificat TLS.
apt install -y certbot
certbot certonly --standalone -d proxy.votredomaine.com
{
"inbounds": [
{
"port": 443, "protocol": "vless",
"settings": {
"clients": [{ "id": "VOTRE-UUID" }],
"decryption": "none",
"fallbacks": [
{ "dest": 8080 },
{ "path": "/chemin-ws", "dest": 8443, "xver": 1 }
]
},
"streamSettings": {
"network": "tcp", "security": "tls",
"tlsSettings": {
"certificates": [{
"certificateFile": "/etc/letsencrypt/live/proxy.votredomaine.com/fullchain.pem",
"keyFile": "/etc/letsencrypt/live/proxy.votredomaine.com/privkey.pem"
}]
}
}
},
{
"listen": "127.0.0.1", "port": 8443, "protocol": "vless",
"settings": { "clients": [{ "id": "VOTRE-UUID" }], "decryption": "none" },
"streamSettings": { "network": "ws", "wsSettings": { "path": "/chemin-ws" } }
}
],
"outbounds": [{ "protocol": "freedom", "tag": "direct" }]
}
Configurez nginx sur le port 8080 comme site de repli, et dans Cloudflare : SSL/TLS Complet (Strict), WebSockets activé.
Étape 4 : Trojan et Shadowsocks
Trojan (ressemble à du HTTPS normal) :
{
"inbounds": [{
"port": 443, "protocol": "trojan",
"settings": {
"clients": [{ "password": "votre-mot-de-passe-fort", "email": "user1@trojan" }],
"fallbacks": [{ "dest": 8080 }]
},
"streamSettings": {
"network": "tcp", "security": "tls",
"tlsSettings": { "certificates": [{ "certificateFile": "...", "keyFile": "..." }] }
}
}]
}
Shadowsocks 2022 (chiffrements AEAD modernes) :
{
"inbounds": [{
"port": 8388, "protocol": "shadowsocks",
"settings": { "method": "2022-blake3-aes-128-gcm", "password": "CLÉ_BASE64", "network": "tcp,udp" }
}]
}
Générez la clé : openssl rand -base64 16 (ou -base64 32 pour aes-256)
Étape 5 : Gestion multi-utilisateur
"clients": [
{ "id": "uuid-1", "email": "alice@proxy", "flow": "xtls-rprx-vision" },
{ "id": "uuid-2", "email": "bob@proxy", "flow": "xtls-rprx-vision" },
{ "id": "uuid-3", "email": "carol@proxy", "flow": "xtls-rprx-vision" }
]
Statistiques de trafic par utilisateur — activez l'API de statistiques :
{
"stats": {},
"policy": {
"levels": { "0": { "statsUserUplink": true, "statsUserDownlink": true } },
"system": { "statsInboundUplink": true, "statsInboundDownlink": true }
},
"api": { "tag": "api", "services": ["StatsService", "HandlerService"] },
"inbounds": [
{ "listen": "127.0.0.1", "port": 10085, "protocol": "dokodemo-door",
"settings": { "address": "127.0.0.1" }, "tag": "api" }
],
"routing": { "rules": [{ "type": "field", "inboundTag": ["api"], "outboundTag": "api" }] }
}
Interroger et gérer les utilisateurs en cours d'exécution :
xray api stats --server=127.0.0.1:10085 -name "user>>>alice@proxy>>>traffic>>>uplink"
xray api adi --server=127.0.0.1:10085 --inbound-tag proxy --id "nouvel-uuid" --email "nouvelutilisateur@proxy"
xray api rmi --server=127.0.0.1:10085 --inbound-tag proxy --email "ancienutilisateur@proxy"
Étape 6 : Règles de routage et surveillance
Router par domaine/IP/géo :
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{ "type": "field", "domain": ["geosite:category-ads-all"], "outboundTag": "block" },
{ "type": "field", "ip": ["geoip:private"], "outboundTag": "block" },
{ "type": "field", "network": "tcp,udp", "outboundTag": "proxy" }
]
}
}
Surveillance :
systemctl status xray
journalctl -u xray -f
grep "accepted" /var/log/xray/access.log | awk '{print $3}' | sort | uniq -c | sort -rn
Pare-feu :
ufw allow 443/tcp && ufw allow 443/udp && ufw enable
Exemples
Exemple 1 : Déployer un serveur proxy VLESS + Reality pour une petite équipe
Demande utilisateur : "Configure Xray sur notre VPS Debian 12 à 198.51.100.30 en utilisant VLESS avec le transport Reality. Crée des comptes pour alice, bob et carol. Utilise microsoft.com comme cible Reality et donne-moi les liens de partage pour v2rayNG."
L'agent installera Xray via le script officiel, générera un UUID pour chaque utilisateur et une paire de clés X25519, construira un fichier config.json avec une entrée VLESS sur le port 443 utilisant les paramètres Reality ciblant www.microsoft.com, ajoutera trois entrées client avec le flux xtls-rprx-vision, ajoutera des règles de routage pour bloquer les IP privées, activera et démarrera le service xray, ouvrira le port 443 dans le pare-feu, et produira trois liens de partage vless:// avec l'adresse IP du serveur, la clé publique, l'identifiant court et le SNI.
Exemple 2 : Mettre en place un proxy VLESS fronté par CDN avec Cloudflare et un site de repli
Demande utilisateur : "J'ai proxy.monsite.com pointant vers notre serveur via Cloudflare. Configure Xray avec VLESS sur WebSocket sur /chemin-secret-ws pour que le trafic passe par le CDN de Cloudflare. Les visiteurs non-proxy doivent voir un site nginx normal."
L'agent obtiendra un certificat Let's Encrypt avec certbot, configurera Xray avec une entrée principale VLESS+TLS sur le port 443 avec un repli vers nginx sur le port 8080, ajoutera une deuxième entrée VLESS+WebSocket sur localhost:8443 avec le chemin /chemin-secret-ws, configurera nginx pour servir un site statique sur le port 8080, vérifiera que le SSL Cloudflare est réglé sur Complet (Strict) avec WebSockets activé, et fournira la chaîne de connexion client avec le chemin WebSocket et le SNI Cloudflare.
Directives
- Utilisez toujours VLESS + Reality pour les nouveaux déploiements ; cela ne nécessite ni nom de domaine ni certificat et est le protocole le plus difficile à détecter et à bloquer
- Définissez
"alterId": 0pour tous les utilisateurs VMess afin d'activer le chiffrement AEAD obligatoire ; un alterId non nul utilise le format hérité, déprécié et moins sécurisé - Bloquez l'accès aux plages d'adresses IP privées (geoip:private) dans les règles de routage pour empêcher le proxy d'être utilisé pour des attaques SSRF contre les services internes
- Utilisez les commandes
xray apipour ajouter et supprimer des utilisateurs en cours d'exécution sans redémarrer le service, ce qui évite de déconnecter les utilisateurs actifs - Choisissez la cible Reality
destet lesserverNamesparmi un site web populaire (microsoft.com, apple.com) hébergé sur une adresse IP différente de celle de votre serveur, et assurez-vous que ce site prend en charge TLS 1.3 et HTTP/2 - Activez l'API de statistiques avec le suivi par utilisateur (
statsUserUplink/statsUserDownlink) pour surveiller l'utilisation de la bande passante et détecter les abus