nexcore-x-ui Installations- & Betriebsanleitung (Xray-Panel)
Schritt-für-Schritt-Anleitung für Astrenix/nexcore-x-ui: Ein-Befehl-Setup, Vue 3 + Go-Binary, systemd-Härtung, /api/v1 REST-API und CLI.
- Statisches Go-Binary zusammen mit Vue 3 + Element Plus SPA und Xray-core ohne strikte Host-GLIBC-Bindung.
- Strukturierte /api/v1 REST-API für externe Controller, Skripte und Multi-Node-Orchestrierung.
- Strenge systemd-Härtung (ProtectSystem=strict, NoNewPrivileges=true), 0700-Verzeichnisse, 0600-Datenbankrechte und SHA256-gehashte API-Tokens.
- VLESS mit XTLS-Reality, TCP, WebSocket und gRPC für geringen Overhead und hohe Stabilität.
Architektur und Hauptmerkmale
Aus vaxilu/x-ui für moderne Cloud-Automatisierung und hohe Betriebssicherheit neu aufgebaut, bietet nexcore-x-ui:
- Statisches Go-Binary zusammen mit Vue 3 + Element Plus SPA und Xray-core ohne strikte Host-GLIBC-Bindung.
- Strukturierte /api/v1 REST-API für externe Controller, Skripte und Multi-Node-Orchestrierung.
- Strenge systemd-Härtung (ProtectSystem=strict, NoNewPrivileges=true), 0700-Verzeichnisse, 0600-Datenbankrechte und SHA256-gehashte API-Tokens.
- Isolierte Pfade, systemd-Unit und CLI (nexcore-x-ui) ohne Konflikte mit dem ursprünglichen x-ui.
Systemanforderungen
- Betriebssystem — Modernes 64-Bit-Linux mit systemd (empfohlen: sauberes Ubuntu 22.04 / 24.04 LTS oder Debian 12).
- Rechte — Root-Rechte sind erforderlich, um den systemd-Dienst einzurichten, Ports zu konfigurieren und das Datenverzeichnis zu schützen.
- Netzwerk — Öffentliche IP mit Zugriff auf GitHub Releases zum Laden der Binärdateien sowie freigegebene Panel- und Protokoll-Ports.
- Empfohlene Server — Harmoniert mit Tovanix Native-IP-VPS, Dual-ISP-VPS, Residential-IP-VPS oder physischen Servern.
Ein-Befehl-Installation & automatisierte Bereitstellung
Melden Sie sich per SSH als root an und starten Sie das offizielle Skript für Download, Diensteinrichtung und zufällige Zugangsdaten:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
Für cloud-init oder eigene Controller übergeben Sie vor dem Aufruf Umgebungsvariablen für sicheren Einstiegspfad und Webhook-Callback:
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)
Ab v2.1.3 werden initiale Klartext-Zugangsdaten nicht mehr in install-info.txt auf die Platte geschrieben, sondern nur im Terminal-Banner und im systemd-Journal protokolliert.
Initiale Zugangsdaten nachträglich auslesen
Falls das Terminal nach der Installation geschlossen wurde, lesen Sie das Setup-Banner über die CLI oder direkt aus dem systemd-Journal aus:
nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"
Ändern Sie nach dem ersten Login das zufällige Passwort im Panel oder mit nexcore-x-ui passwd und begrenzen Sie den Zugriff auf den Panel-Port in der Firewall.
nexcore-x-ui CLI-Kurzreferenz
Nach dem Setup steht der globale Befehl nexcore-x-ui für Dienststeuerung, Logs, Passwortwechsel, Updates und Deinstallation bereit:
- nexcore-x-ui — Öffnet das interaktive Verwaltungsmenü im Terminal.
- nexcore-x-ui start | stop | restart | status — Startet, stoppt, startet neu oder zeigt den Status des Panel-Dienstes.
- nexcore-x-ui creds / info — Zeigt Panel-Port, Einstiegspfad und initiale Zugangsdaten an.
- nexcore-x-ui reset — Erzeugt Benutzername, Passwort und Panel-Port zufällig neu.
- nexcore-x-ui passwd <user> <new_password> — Setzt manuell ein neues Login-Passwort für den angegebenen Administrator.
- nexcore-x-ui log / log-tail — Gibt die letzten 200 Logzeilen aus oder verfolgt das Log live.
- nexcore-x-ui update — Aktualisiert nahtlos auf das neueste GitHub Releases-Paket und startet neu.
- nexcore-x-ui uninstall — Entfernt Binärdateien, systemd-Dienst und Datenverzeichnis vollständig (vorher sichern).
Unterstützte Protokolle und Transporte
Auf Basis von Xray-core verwaltet das Panel individuelle Benutzer, Traffic-Limits und Laufzeiten für:
- VLESS mit XTLS-Reality, TCP, WebSocket und gRPC für geringen Overhead und hohe Stabilität.
- VMess und Trojan für bestehende Clients und TLS-Domain-Konfigurationen.
- Shadowsocks und Shadowsocks-2022 für schlanke Clients und schnelle Relay-Strecken.
- SOCKS, HTTP und Dokodemo-door für App-Proxys, Portweiterleitung und mehrstufige Ketten.
Prüfen Sie nach dem Verbindungstest die Ausgangs-IP mit unserer kostenlosen IP-Qualitätsprüfung auf Native- und Carrier-Merkmale.
Fehlerbehebung
- Panel-Login lädt im Browser nicht — Der zufällige Panel-Port ist in der Firewall gesperrt oder der sichere Einstiegspfad fehlt. — Mit nexcore-x-ui status und nexcore-x-ui info Port und Pfad prüfen und den TCP-Port in der Firewall freigeben.
- Zufälliges Startpasswort verloren — Versionen ab v2.1.3 speichern keine Klartextdatei mehr auf der Festplatte. — Mit nexcore-x-ui creds aus dem Journal lesen oder per nexcore-x-ui passwd <user> <new_password> neu setzen.
- Inbound läuft, aber Clients verbinden sich nicht — Protokoll-Port blockiert, Reality-Handshake schlägt fehl oder die Serveruhr weicht stark ab. — TCP-/UDP-Firewall und NTP-Zeitsynchronisierung prüfen und Fehler per nexcore-x-ui log-tail auslesen.
- Upgrade über das Panel wurde nicht übernommen — Download von GitHub Releases lief in ein Timeout oder ein alter Prozess hing fest. — Per SSH nexcore-x-ui update ausführen, den Verlauf verfolgen und anschließend nexcore-x-ui status prüfen.
Häufig gestellte Fragen
Kann nexcore-x-ui neben vaxilu/x-ui auf demselben Server laufen?
Ja. Binärdateien, Datenverzeichnis, systemd-Unit und CLI sind getrennt, sodass beide bei unterschiedlichen Ports koexistieren.
Löscht ein Upgrade bestehende Inbounds oder Benutzer?
Nein. Sowohl Panel-Updates als auch nexcore-x-ui update ersetzen nur das Binary und behalten die SQLite-Datenbank bei.
Wie automatisiere ich Knoten über /api/v1?
Erstellen Sie in den Panel-Einstellungen ein API-Token (serverseitig als SHA256-Hash gespeichert) und verwalten Sie Inbounds, Benutzer und Traffic per REST.
Verwandte Seiten: nexcore-s-ui Installations- & Konfigurationsanleitung (sing-box) · Node-Panel-Auswahl: nexcore-x-ui, nexcore-s-ui & dedizierter Proxy · Lösung für dedizierte Netzwerkbereitstellung · VPS mit nativer und Residential-IP
Wird geladen…