Tovanix
Tovanix

nexcore-s-ui Installations- & Konfigurationsanleitung (sing-box)

Komplette Anleitung für Astrenix/nexcore-s-ui: sing-box Ein-Befehl-Setup, musl-Builds, Cloudflare-DNS-01-SSL-Zertifikate, /api/v1 API und CLI.

  • Neu geschriebene Vue 3 + Element Plus Oberfläche für sing-box-Inbounds, Outbounds, Routing und Benutzer.
  • Statische musl-Binärdateien für amd64, arm64 und weitere Linux-Architekturen ohne Host-GLIBC-Abhängigkeit.
  • Vollständige /api/v1 REST-API mit Audit-Log, kompatibel zu nexcore-x-ui-Controller-Abläufen.
  • Integriertes Cloudflare API Token für vollautomatische DNS-01-SSL-Zertifikate ohne Port-80-Konflikte.

Architektur und Hauptmerkmale

Auf Basis von alireza0/s-ui für sing-box und API-Automatisierung neu entwickelt, bietet nexcore-s-ui:

  • Neu geschriebene Vue 3 + Element Plus Oberfläche für sing-box-Inbounds, Outbounds, Routing und Benutzer.
  • Statische musl-Binärdateien für amd64, arm64 und weitere Linux-Architekturen ohne Host-GLIBC-Abhängigkeit.
  • Vollständige /api/v1 REST-API mit Audit-Log, kompatibel zu nexcore-x-ui-Controller-Abläufen.
  • Integriertes Cloudflare API Token für vollautomatische DNS-01-SSL-Zertifikate ohne Port-80-Konflikte.

System- und Architekturanforderungen

  • Unterstütztes OS — Ubuntu 24.04 LTS (Ende-zu-Ende geprüft); kompatibel auch mit Ubuntu 20.04+, Debian 11+ und CentOS Stream 8+ mit systemd.
  • CPU-Architekturen — Statische Binärdateien für amd64, arm64, 386, armv5, armv6, armv7 und s390x.
  • Rechte — Erfordert Root-Rechte zum Binden der Ports 80 / 443, Schreiben von ACME-Zertifikaten und Anlegen von tun-Geräten.
  • Koexistenz — Eigene Pfade, systemd-Unit und zufälliger Port ermöglichen den Parallelbetrieb neben originalem s-ui.

Ein-Befehl-Installation, feste Version & Neuinstallation

Melden Sie sich per SSH als root an und starten Sie das offizielle Skript. Beim Erstsetup werden Benutzername, Passwort und Port zufällig erzeugt:

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

Um eine bestimmte Release-Version festzulegen oder Binärdateien unter Erhalt der Datenbank neu einzuspielen, übergeben Sie Tag oder --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

Die zufälligen Startdaten und die Panel-URI erscheinen nur einmal am Ende der Installation; notieren Sie sie sofort vor dem Schließen des Terminals.

Automatische SSL-Zertifikate via Cloudflare DNS-01

Für Hysteria2, Trojan, AnyTLS oder TLS-Inbounds empfiehlt sich Cloudflare DNS-01 für wartungsfreie Zertifikate:

  • Cloudflare-verwaltete Domain auf den Server zeigen lassen: Registrieren Sie eine Domain in Tovanix Cloud (oder nutzen Sie eine eigene) und legen Sie einen A- / AAAA-Eintrag auf die öffentliche Server-IP an.
  • Cloudflare API Token mit Minimalrechten erstellen: Erstellen Sie bei Cloudflare ein auf die Zielzone beschränktes API Token mit ausschließlich Zone:DNS:Edit statt des globalen Schlüssels.
  • Domain und Token im Panel hinterlegen: Wählen Sie in der Zertifikatsverwaltung von nexcore-s-ui den Modus DNS-01, tragen Sie Domain und API Token ein und speichern Sie für automatische Ausstellung und Verlängerung.

DNS-01 prüft die Domain über DNS-TXT-Einträge und funktioniert selbst dann, wenn Port 80 belegt oder geschlossen ist.

nexcore-s-ui CLI-Kurzreferenz

Mit dem Befehl nexcore-s-ui verwalten Sie Dienst, Logs, Updates und Deinstallation:

  • nexcore-s-ui — Öffnet das interaktive CLI-Verwaltungsmenü.
  • nexcore-s-ui start | stop | restart | status — Startet, stoppt, startet neu oder prüft den Status des nexcore-s-ui-Dienstes.
  • nexcore-s-ui log — Zeigt aktuelle Panel- und Core-Logs zur Analyse von Inbound- oder ACME-Fehlern.
  • nexcore-s-ui update — Aktualisiert auf das neueste GitHub Releases-Paket unter Erhalt der Datenbank.
  • nexcore-s-ui uninstall — Entfernt Binärdateien, systemd-Dienst und lokale Daten vollständig (vorher sichern).

Fehlerbehebung

  • Panel-URL antwortet nach Installation nicht — Der zufällige Panel-Port ist in der Firewall noch geschlossen oder der URI-Pfad fehlt. — Port und komplette URI aus der Installationsausgabe prüfen, Port freigeben und nexcore-s-ui status kontrollieren.
  • Cloudflare-DNS-01-Zertifikat schlägt fehl — Dem API Token fehlt Zone:DNS:Edit für diese Zone oder DNS ist noch nicht propagiert. — Token-Berechtigungen prüfen und die genaue ACME-Meldung per nexcore-s-ui log ansehen.
  • Hysteria2 oder UDP-Protokolle verbinden nicht — In der Firewall wurde nur TCP statt auch UDP freigegeben, oder Zertifikatsdomain / ALPN passen nicht. — UDP-Verkehr für den Inbound-Port freigeben und prüfen, ob der Client-SNI zur Zertifikatsdomain passt.
  • Binärdateien reparieren ohne Datenverlust — Der Befehl uninstall löscht sowohl Binärdateien als auch die Datenbank. — Kein uninstall ausführen; stattdessen install.sh --force nutzen, um nur die Binärdateien zu erneuern.

Häufig gestellte Fragen

Hängt nexcore-s-ui von einer bestimmten Host-GLIBC ab?

Nein. Die Pakete sind statisch mit musl für viele Linux-Architekturen gebaut; empfohlen wird Ubuntu 24.04 LTS.

Kann nexcore-s-ui parallel zum ursprünglichen alireza0/s-ui laufen?

Ja. Verzeichnisse, systemd-Dienst und Ports sind getrennt, sodass beide bei freien Ports parallel laufen.

Warum Cloudflare DNS-01 statt HTTP-01 wählen?

DNS-01 benötigt keinen Port 80, unterstützt Wildcard-Zertifikate und vermeidet Konflikte mit bestehenden Webservern.

Verwandte Seiten: nexcore-x-ui Installations- & Betriebsanleitung (Xray-Panel) · Node-Panel-Auswahl: nexcore-x-ui, nexcore-s-ui & dedizierter Proxy · Lösung für dedizierte Netzwerkbereitstellung · Dedizierter Proxy

Wird geladen…