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…