Tutoriel d’installation et de configuration nexcore-s-ui (sing-box)
Guide complet Astrenix/nexcore-s-ui : installation sing-box en une commande, binaires musl, certificats SSL Cloudflare DNS-01, API /api/v1 et CLI.
- Une interface Vue 3 + Element Plus réécrite pour piloter entrées, sorties, routage et utilisateurs sing-box.
- Des binaires statiques musl pour amd64, arm64 et autres architectures Linux sans dépendance GLIBC.
- Une API REST /api/v1 complète avec journal d’audit, compatible avec les contrôleurs nexcore-x-ui.
- Un support natif Cloudflare API Token pour émettre et renouveler les certificats SSL via DNS-01 sans bloquer le port 80.
Architecture et points clés
Repensé à partir d’alireza0/s-ui pour sing-box et l’automatisation par API, nexcore-s-ui offre :
- Une interface Vue 3 + Element Plus réécrite pour piloter entrées, sorties, routage et utilisateurs sing-box.
- Des binaires statiques musl pour amd64, arm64 et autres architectures Linux sans dépendance GLIBC.
- Une API REST /api/v1 complète avec journal d’audit, compatible avec les contrôleurs nexcore-x-ui.
- Un support natif Cloudflare API Token pour émettre et renouveler les certificats SSL via DNS-01 sans bloquer le port 80.
Prérequis système et architecture
- OS pris en charge — Ubuntu 24.04 LTS (validé de bout en bout) ; compatible aussi avec Ubuntu 20.04+, Debian 11+ et CentOS Stream 8+ avec systemd.
- Architectures CPU — Binaires statiques disponibles pour amd64, arm64, 386, armv5, armv6, armv7 et s390x.
- Privilèges — Nécessite root pour lier les ports 80 / 443, écrire les certificats ACME et créer des interfaces tun si besoin.
- Cohabitation — Répertoires, unité systemd et port aléatoire séparés permettant la coexistence avec s-ui d’origine.
Installation en une commande, version fixe et réinstallation
Connectez-vous en SSH en root et exécutez le script officiel. La première installation génère un utilisateur, un mot de passe et un port aléatoires :
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)
Pour épingler une version précise ou réécrire les binaires sans perdre votre base actuelle, ajoutez le tag ou --force :
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) --force
# bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) v1.0.0
Les identifiants aléatoires initiaux et l’URI du panneau ne s’affichent qu’une seule fois en fin d’installation ; copiez-les avant de fermer le terminal.
Configurer les certificats SSL automatiques via Cloudflare DNS-01
Pour Hysteria2, Trojan, AnyTLS ou toute entrée TLS, utilisez Cloudflare DNS-01 pour une gestion entièrement automatisée :
- Pointer un domaine géré par Cloudflare vers le serveur: Enregistrez un domaine sur Tovanix Cloud (ou utilisez le vôtre) et créez un enregistrement A / AAAA vers l’IP publique du nœud.
- Créer un Cloudflare API Token à privilèges minimaux: Dans Cloudflare, générez un API Token restreint à votre zone avec le seul droit Zone:DNS:Edit plutôt que la clé globale.
- Renseigner le domaine et le Token dans le panneau: Dans la gestion des certificats de nexcore-s-ui, choisissez DNS-01, saisissez votre domaine et le Token puis enregistrez pour lancer émission et renouvellement automatiques.
DNS-01 prouve le contrôle du domaine via des enregistrements DNS TXT et fonctionne même si le port 80 est occupé ou fermé.
Aide-mémoire de la CLI nexcore-s-ui
Utilisez la commande nexcore-s-ui pour gérer le service, consulter les journaux, mettre à jour ou désinstaller :
- nexcore-s-ui — Ouvre le menu CLI interactif d’administration.
- nexcore-s-ui start | stop | restart | status — Démarre, arrête, redémarre ou vérifie l’état du service nexcore-s-ui.
- nexcore-s-ui log — Affiche les journaux récents du panneau et du moteur pour diagnostiquer entrées ou ACME.
- nexcore-s-ui update — Met à jour vers la dernière version GitHub Releases en conservant la base de données.
- nexcore-s-ui uninstall — Désinstalle complètement binaires, service systemd et données locales (sauvegardez d’abord).
Dépannage
- L’URL du panneau ne répond pas après l’installation — Le port aléatoire n’est pas autorisé dans le pare-feu ou le chemin URI généré est incomplet. — Vérifiez port et URI dans la sortie d’installation, ouvrez le port et contrôlez avec nexcore-s-ui status.
- Échec d’émission du certificat Cloudflare DNS-01 — Le Token manque du droit Zone:DNS:Edit sur cette zone ou la propagation DNS est incomplète. — Vérifiez la portée du token puis inspectez le message ACME exact via nexcore-s-ui log.
- Hysteria2 ou les protocoles UDP ne se connectent pas — Seul le TCP est ouvert dans le pare-feu alors que l’UDP reste bloqué, ou le domaine / ALPN du certificat diffère. — Autorisez le trafic UDP sur le port d’entrée et vérifiez que le SNI client correspond au domaine du certificat.
- Réparer les binaires sans perdre la configuration — La commande uninstall supprime aussi la base de données. — N’exécutez pas uninstall ; lancez install.sh --force pour remplacer les binaires en conservant la base intacte.
Questions fréquentes
nexcore-s-ui dépend-il d’une version précise de GLIBC ?
Non. Les binaires sont compilés statiquement avec musl pour de nombreuses architectures Linux ; Ubuntu 24.04 LTS est recommandé.
nexcore-s-ui peut-il coexister avec alireza0/s-ui ?
Oui. Répertoires, service systemd et ports sont isolés et permettent une coexistence sans conflit.
Pourquoi privilégier Cloudflare DNS-01 plutôt que HTTP-01 ?
DNS-01 n’utilise pas le port 80, gère les certificats génériques et évite tout conflit avec un serveur web existant.
Pages connexes: Tutoriel d’installation et d’exploitation nexcore-x-ui (Xray) · Guide de choix des panneaux : nexcore-x-ui, nexcore-s-ui et Proxy dédié · Solution de déploiement de réseau privé · Proxy dédié
Chargement…