Xray. Modul verwalten

Dieser Artikel ist die Fortsetzung von Xray-Schnellstart. Falls Sie das Modul noch nicht installiert und den ersten Benutzer noch nicht angelegt haben, beginnen Sie dort. Hier sind Operationen am Modul selbst zusammengefasst: Service starten und stoppen, aktualisieren und deinstallieren. Die Verwaltung von VPN-Benutzern ist in einen separaten Artikel ausgelagert — Xray. Benutzer verwalten.

Service verwalten

Oben rechts auf der Modulseite stehen drei Schaltflächen zur Verwaltung des Xray-Service zur Verfügung: «Start», «Stopp» und «Neustart».

• «Start» — startet den Service aus dem gestoppten Zustand. Die Schaltfläche ist nur aktiv, wenn der Service derzeit ausgeschaltet ist.
• «Stopp» — schaltet den Service ab. Alle aktiven VPN-Verbindungen werden getrennt, neue können nicht aufgebaut werden.
• «Neustart» — stoppt den Service und startet ihn sofort wieder. Offene Verbindungen werden getrennt. Nützlich nach manuellen Konfigurationsänderungen oder wenn der Service instabil läuft.

Änderungen in der Benutzerliste übernimmt das Panel selbst, ohne den Service neu zu starten.

⚠️ Das Stoppen des Service trennt alle VPN-Verbindungen

Solange der Service ausgeschaltet ist, kann sich kein Benutzer verbinden. Planen Sie Stopps und Neustarts in einem Wartungsfenster oder informieren Sie die Benutzer rechtzeitig.

Während das Modul aktualisiert oder deinstalliert wird, sind die Service-Schaltflächen vorübergehend nicht verfügbar.

ℹ️ Port

Xray läuft auf TCP-Port 8443.

⚠️ Einschränkungen durch Provider

Die Verschlüsselung des Datenverkehrs macht ein VPN zu einem zuverlässigen Mittel zum Schutz der Verbindung. In einigen Ländern und Regionen setzen Internetanbieter jedoch technische Maßnahmen gegen VPN-Protokolle ein. Eine vollständige Verfügbarkeit des Dienstes kann deshalb nicht garantiert werden — unabhängig von der Art der Verbindung. Wenn ein Protokoll bei Ihnen nicht funktioniert, probieren Sie ein anderes VPN-Modul aus dem Panel. Funktioniert keines davon in Ihrem Netzwerk, wenden Sie sich an den Support — wir erstatten die Lizenzgebühr.

Hinweis auf nicht konfiguriertes SMTP

Im Header der Modulseite kann ein Banner «E-Mail nicht konfiguriert» mit einem Link «Einrichten» erscheinen. Es bedeutet, dass im Panel kein funktionierendes SMTP vorhanden ist — Verbindungslinks lassen sich nicht per E-Mail an Benutzer senden. Das VPN selbst funktioniert weiterhin: Das Banner betrifft nur den E-Mail-Versand. Die SMTP-Einrichtung ist im Artikel SMTP-Relay für den E-Mail-Versand einrichten beschrieben.

Modul aktualisieren

Wählen Sie im Aktionsmenü des Moduls neben dem Titel «Xray» den Punkt «Xray aktualisieren». Das Panel lädt die aktuelle Xray-Version aus dem Repository und installiert sie über die bestehende. Die Benutzerliste und ihre Verbindungslinks bleiben erhalten.

Eine Bestätigung gibt es bei der Aktualisierung nicht — die Aktion startet sofort. Während sie läuft, erscheint im Header die Anzeige «Aktualisierung von Xray», und die Service-Schaltflächen sowie die Menüpunkte sind nicht verfügbar.

Modul neu installieren

Wählen Sie im Aktionsmenü des Moduls neben dem Titel «Xray» den Punkt «Xray neu installieren». Das Panel installiert dieselbe Xray-Version über die bestehende neu und startet den Service neu. Die Benutzerliste und ihre aktiven Verbindungen bleiben erhalten — Verbindungslinks und Einstellungen müssen in den Client-Apps nicht erneut importiert werden.

Vor dem Start bittet das Panel um eine Bestätigung; klicken Sie auf «Bestätigen». Während die Neuinstallation läuft, erscheint im Header die Anzeige «Xray wird neu installiert», und die Service-Schaltflächen sowie die Menüpunkte sind nicht verfügbar.

ℹ️ Sichere Operation

Im Gegensatz zur Deinstallation löscht die Neuinstallation keine Moduldaten: Benutzer, ihre Kennungen und Verbindungslinks bleiben unverändert.

ℹ️ Wenn die Verbindung nicht wiederhergestellt wird

Kann sich ein Benutzer nach der Neuinstallation nicht verbinden, deaktivieren Sie ihn in der Liste, aktivieren Sie ihn erneut und fügen Sie den VLESS-Link neu hinzu oder scannen Sie den QR-Code in seiner Client-App. Bleiben die Fehler bestehen, ist als letztes Mittel das Modul vollständig zu deinstallieren und neu zu installieren.

Anwendungsfall: Wenn der Service instabil läuft oder die Installation beschädigt erscheint, ist eine Neuinstallation ein sicherer erster Schritt, bevor Sie sich an den Support wenden.

Modul deinstallieren

Wählen Sie im Aktionsmenü des Moduls «Xray deinstallieren». Das Panel bittet Sie, das Löschen zu bestätigen, und weist darauf hin, dass zusammen mit dem Modul alle zugehörigen Daten einschließlich der Benutzereinstellungen entfernt werden; das Modul lässt sich anschließend erneut installieren.

‼️ Beim Deinstallieren des Moduls werden alle VPN-Benutzer gelöscht

Die Aktion ist nicht rückgängig zu machen: Zusammen mit dem Modul gehen alle Xray-Benutzer, ihre Kennungen und die erzeugten Verbindungslinks verloren. Bereits installierte Client-Apps können sich nach der Deinstallation nicht mehr verbinden — die dort hinterlegten Konfigurationen sind ungültig. Nach einer erneuten Installation müssen Modul und Benutzer neu angelegt werden; auch die Verbindungslinks ändern sich, und die Konfiguration in den Clients muss aktualisiert werden.

Nach der Bestätigung startet das Panel die Deinstallation; der Vorgang wird im Header durch die Anzeige «Deinstallation von Xray» dargestellt. Nach Abschluss kehrt die Modulseite in ihren Ausgangszustand mit der Schaltfläche «Installieren» zurück.

Aufgabenprotokoll

Unter den Service-Schaltflächen befindet sich ein Link zum Aufgabenprotokoll des Moduls. Es zeichnet alle Lifecycle-Operationen am Modul auf — Installation, Aktualisierung, Deinstallation — mit Status und Ausführungs-Logs. Nützlich, wenn Installation oder Aktualisierung mit einem Fehler endet und Sie die Ursache klären müssen.

Nützliche Links

• Xray-Schnellstart — Installation des Moduls und erste Verbindung.
• Xray. Benutzer verwalten — Anlegen, Bearbeiten und Löschen von Benutzern sowie Zukauf von Plätzen.