Tovanix
Tovanix

Tutoriel d’installation et d’exploitation nexcore-x-ui (Xray)

Guide pas à pas Astrenix/nexcore-x-ui : installation en une commande, Vue 3 + binaire Go statique, durcissement systemd, API REST /api/v1 et CLI.

  • Un binaire Go statique associé à Vue 3 + Element Plus et Xray-core, supprimant la dépendance stricte à la GLIBC de l’hôte.
  • Une API REST /api/v1 complète conçue pour les contrôleurs externes, scripts et flottes multinœuds.
  • Un durcissement systemd (ProtectSystem=strict, NoNewPrivileges=true), des répertoires 0700, une base 0600 et des jetons API hachés en SHA256.
  • VLESS avec XTLS-Reality, TCP, WebSocket et gRPC pour une faible latence de traitement et une connexion stable.

Architecture et points clés

Refondu à partir de vaxilu/x-ui pour l’automatisation cloud et la sécurité en production, nexcore-x-ui inclut :

  • Un binaire Go statique associé à Vue 3 + Element Plus et Xray-core, supprimant la dépendance stricte à la GLIBC de l’hôte.
  • Une API REST /api/v1 complète conçue pour les contrôleurs externes, scripts et flottes multinœuds.
  • Un durcissement systemd (ProtectSystem=strict, NoNewPrivileges=true), des répertoires 0700, une base 0600 et des jetons API hachés en SHA256.
  • Des chemins, unité systemd et commande CLI (nexcore-x-ui) isolés sans conflit avec x-ui d’origine.

Prérequis système

  • Système d’exploitation — Linux 64 bits moderne avec systemd (Ubuntu 22.04 / 24.04 LTS propre ou Debian 12 recommandé).
  • Privilèges — Accès root requis pour enregistrer le service systemd, configurer les ports et sécuriser les données.
  • Réseau — IP publique avec accès sortant à GitHub Releases pour télécharger les binaires, plus ports du panneau et protocoles autorisés.
  • Serveurs recommandés — Idéal avec les VPS IP native, VPS double ISP, VPS résidentiels ou serveurs physiques Tovanix.

Installation en une commande et déploiement automatisé

Connectez-vous en SSH en root et exécutez le script officiel pour installer le binaire statique, démarrer le service et générer des identifiants aléatoires :

bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)

Pour un déploiement via cloud-init ou contrôleur externe, passez les variables d’entrée sécurisée et de rappel webhook avant de lancer le script :

REPORT_URL=https://your-controller.example/callback \
REPORT_KEY=your_secret \
SECURE_ENTRY=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)

Depuis la version v2.1.3, les identifiants initiaux en clair ne sont plus écrits dans install-info.txt ; ils apparaissent uniquement dans la bannière terminal et dans systemd journal.

Retrouver les identifiants initiaux

Si vous avez fermé le terminal après l’installation, récupérez la bannière via la CLI ou directement dans systemd journal :

nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"

Après votre première connexion, modifiez le mot de passe via le panneau ou nexcore-x-ui passwd et limitez l’accès au port du panneau dans votre pare-feu.

Aide-mémoire de la CLI nexcore-x-ui

L’installation enregistre la commande globale nexcore-x-ui pour gérer le service, les journaux, les mots de passe, les mises à jour et la suppression :

  • nexcore-x-ui — Ouvre le menu interactif d’administration dans le terminal.
  • nexcore-x-ui start | stop | restart | status — Démarre, arrête, redémarre ou vérifie l’état du service panneau.
  • nexcore-x-ui creds / info — Affiche le port du panneau, le chemin d’accès et les identifiants initiaux.
  • nexcore-x-ui reset — Régénère aléatoirement un identifiant, un mot de passe et un port panneau.
  • nexcore-x-ui passwd <user> <new_password> — Définit manuellement un nouveau mot de passe pour l’administrateur indiqué.
  • nexcore-x-ui log / log-tail — Affiche les 200 dernières lignes de journal ou suit la sortie en direct.
  • nexcore-x-ui update — Met à jour vers la dernière version GitHub Releases et redémarre le service.
  • nexcore-x-ui uninstall — Supprime binaires, unité systemd et répertoire de données (sauvegardez d’abord).

Protocoles et transports pris en charge

Appuyé sur Xray-core, le panneau gère les comptes individuels, quotas de trafic et dates d’expiration pour :

  • VLESS avec XTLS-Reality, TCP, WebSocket et gRPC pour une faible latence de traitement et une connexion stable.
  • VMess et Trojan pour la compatibilité clients existants et les configurations TLS.
  • Shadowsocks et Shadowsocks-2022 pour les clients légers et liaisons relais rapides.
  • SOCKS, HTTP et Dokodemo-door pour les proxies applicatifs, redirections de ports et chaînages.

Une fois l’entrée testée, vérifiez votre IP de sortie dans notre outil gratuit de contrôle qualité IP.

Dépannage

  • La page de connexion du panneau ne s’affiche pas — Le port aléatoire est bloqué par le pare-feu ou le chemin d’entrée sécurisé manque dans l’URL. — Lancez nexcore-x-ui status et nexcore-x-ui info pour vérifier port et chemin, puis ouvrez ce port TCP dans le pare-feu.
  • Mot de passe aléatoire initial perdu — À partir de v2.1.3, aucun fichier en clair n’est laissé sur disque. — Exécutez nexcore-x-ui creds pour lire le journal ou réinitialisez avec nexcore-x-ui passwd <user> <new_password>.
  • L’entrée est active mais les clients échouent à se connecter — Port protocole fermé, handshake Reality en échec ou décalage horaire du serveur trop élevé. — Vérifiez les règles TCP / UDP, synchronisez l’heure NTP et consultez les erreurs Xray via nexcore-x-ui log-tail.
  • La mise à jour depuis le panneau n’a pas pris effet — Expiration du téléchargement GitHub Releases ou ancien processus bloqué. — Lancez nexcore-x-ui update en SSH pour suivre la sortie complète puis vérifiez nexcore-x-ui status.

Questions fréquentes

nexcore-x-ui peut-il coexister avec vaxilu/x-ui sur un même serveur ?

Oui. Les binaires, données, unité systemd et CLI sont séparés ; il suffit d’éviter les doublons de ports.

La mise à jour efface-t-elle les entrées ou utilisateurs existants ?

Non. Les mises à jour panneau et nexcore-x-ui update remplacent uniquement les binaires en conservant la base SQLite.

Comment automatiser la gestion via /api/v1 ?

Créez un API Token dans les paramètres (stocké en hash SHA256 côté serveur) puis appelez les endpoints REST standards.

Pages connexes: Tutoriel d’installation et de configuration nexcore-s-ui (sing-box) · Guide de choix des panneaux : nexcore-x-ui, nexcore-s-ui et Proxy dédié · Solution de déploiement de réseau privé · VPS avec IP native et IP résidentielle

Chargement…