3X-UI kurz vorgestellt

3X-UI ist ein modernes Open-Source-Webpanel für die bequeme Verwaltung von Xray-core. Es verlagert die routinemäßigen Verwaltungsaufgaben in eine vertraute Weboberfläche und verkürzt die Zeit, die Sie für die Pflege Ihrer Dienste brauchen.

Diese Lösung erleichtert den Betrieb – sie bündelt die Verwaltung von Verbindungen, Benutzern und Auswertungen an einer Stelle und bietet schnellen Zugriff auf Konfigurationen und Logs, damit Provider, Systemadministratoren und erfahrene Nutzer Dienste ohne unnötigen Aufwand starten und betreiben können.

Eine ausführliche Übersicht der Funktionen finden Sie unten im Abschnitt „Funktionen des 3X-UI-Panels“.

Bevor Sie das Panel in Betrieb nehmen, empfehlen wir, die Zugriffseinstellungen zu prüfen und regelmäßige Backups der Konfiguration einzurichten.

Funktionen des 3X-UI-Panels

• Unterstützung gängiger Protokolle – VMess, VLESS, Trojan, Shadowsocks, WireGuard, SOCKS, HTTP und weitere.
• Mehrsprachige Oberfläche – Russisch, Englisch, 中文, español und weitere, umschaltbar mit einem Klick.
• Verwaltung von Benutzern und Kontingenten – Konten anlegen und löschen, Traffic-Limits, Laufzeiten, Sperren und Prioritäten.
• Automatische Ausstellung und Verlängerung von SSL – Integration mit Let’s Encrypt und Unterstützung eigener Zertifikate.
• Unterstützung des Reality-Transports – Konfigurationen zum Umgehen von Sperren und für die sichere Übertragung des Datenverkehrs.
• Überwachung und Statistik in Echtzeit – Traffic, aktive Verbindungen, Diagramme, Logs und Datenexport.
• Integration mit Docker – fertige Images und Bereitstellung über Docker / Docker-Compose.
• Vollwertige Weboberfläche – alle Verwaltungsaufgaben erledigen Sie über die GUI (die Konsole wird nicht benötigt).

---

Manuelle Installation

Um 3X-UI zu installieren, führen Sie folgenden Befehl aus:

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

Während der Installation:

• wählen Sie bei der Frage nach den Panel-Parametern y, um den Schutz zu aktivieren;
• verwenden Sie für den Zugriff auf die Weboberfläche einen nicht standardmäßigen Port.

---

Eine bestimmte Version installieren

Um die gewünschte Version des Panels zu installieren, geben Sie ihre Nummer im Installationsbefehl an. Zum Beispiel für die Version v1.7.9:

VERSION=v1.7.9 && bash <(curl -Ls "https://raw.githubusercontent.com/mhsanaei/3x-ui/$VERSION/install.sh") $VERSION

---

1. Installation über Docker

bash <(curl -sSL https://get.docker.com)
git clone https://github.com/mhsanaei/3x-ui.git
cd 3x-ui
docker compose up -d

Alternative Variante:

docker run -itd \
  -e XRAY_VMESS_AEAD_FORCED=false \
  -v $PWD/db/:/etc/x-ui/ \
  -v $PWD/cert/:/root/cert/ \
  --network=host \
  --restart=unless-stopped \
  --name 3x-ui \
  ghcr.io/mhsanaei/3x-ui:latest

---

SSL-Zertifikate einrichten

In 3x-ui gibt es mehrere Wege, ein SSL-Zertifikat einzurichten.

Methode 1. SSL-Zertifikat über ACME im 3X-UI-Panel einrichten

1. Stellen Sie sicher, dass Ihre Domain korrekt auf den Server zeigt (der A-Eintrag im DNS ist richtig gesetzt).
2. Führen Sie im Terminal den Befehl aus:
   x-ui
   Wählen Sie dann den Punkt SSL Certificate Management.
3. Im geöffneten Menü stehen folgende Aktionen zur Verfügung:
   • Get SSL – ein neues Zertifikat ausstellen.
   • Revoke – ein vorhandenes Zertifikat entfernen.
   • Force Renew – das Zertifikat manuell erneuern.
   • Show Existing Domains – die Liste der verfügbaren Zertifikate anzeigen.
   • Set Cert paths for the panel – die Pfade zu den Zertifikatsdateien festlegen, die das Control Panel verwenden soll.

---

Methode 2. SSL-Zertifikat über Certbot einrichten

apt install certbot -y
certbot certonly --standalone --agree-tos --register-unsafely-without-email -d yourdomain.com
certbot renew --dry-run

Ersetzen Sie yourdomain.com durch Ihre Domain.

---

Anmeldung im Webpanel

Führen Sie nach der Installation aus:

x-ui

Wählen Sie den Punkt 10, um die aktuellen Einstellungen des Panels anzuzeigen, darunter URL, Login und Passwort.

Öffnen Sie den Link aus Access URL und melden Sie sich mit den erhaltenen Daten an.

---

Verbindungen einrichten (Inbounds)

Verbindung anlegen

1. Öffnen Sie den Bereich Inbounds.
2. Klicken Sie auf Add Inbound.
3. Tragen Sie im Feld Remark einen beliebigen Namen ein.
4. Wählen Sie ein Protokoll (VMess, VLESS, Trojan, ShadowSocks oder WireGuard).
5. Speichern Sie die Einstellungen.

---

Protokolle einrichten

VLESS + Reality

(empfohlen zum Umgehen von Sperren)

1. Wählen Sie im Feld Security die Option Reality.

2. Wählen Sie im Feld uTLS den Wert firefox statt des voreingestellten chrome.

3. Füllen Sie die Felder Target (in älteren Versionen Dest) und SNI aus.

   Tragen Sie keine großen fremden Websites wie google.com, dl.google.com, microsoft.com oder apple.com ein – das ist heute eines der wichtigsten Merkmale, an denen Server erkannt und gesperrt werden. Am zuverlässigsten tarnen Sie sich als Ihre eigene Domain nach dem Self-Steal-Schema. Tragen Sie dafür bei Target 127.0.0.1:8443 und bei SNI Ihre Domain ein und lassen Sie Xver auf 0. Wie Sie Domain und Website vorbereiten, steht im Artikel „Self-Steal für VLESS Reality“.

4. Klicken Sie auf Get New Cert, um die Schlüssel automatisch zu erzeugen.

5. Klicken Sie auf Create, um die Verbindung zu speichern und anzulegen.

INFO

Warum firefox und nicht chrome

Seit Ende 2025 bewerten die Systeme zur Traffic-Filterung bei russischen Providern (TSPU) eine TLS-Verbindung anhand mehrerer Merkmale zugleich – des Subnetzes des Hosters, des Namens der Website (SNI) und des Fingerprints des Clients. Der Fingerprint chrome ist in fast allen VPN-Apps und Panels voreingestellt, deshalb ist die Kombination „Chrome-Fingerprint und IP-Adresse eines Rechenzentrums“ für die Filter zu einem verlässlichen Hinweis auf einen Proxy geworden. Nutzer berichten, dass die Verbindung bei mehreren gleichzeitigen Verbindungen mit diesem Fingerprint für einige Minuten „einfriert“ und der Wechsel auf firefox hilft.

Der Fingerprint edge hat früher ebenfalls geholfen, ist aber seit September 2026 mit neuen Xray-Versionen nicht mehr kompatibel. Ab Xray 26.9.8 (enthalten zum Beispiel in 3X-UI 3.8.0 und neuer) akzeptiert ein Reality-Server nur noch Clients mit dem Post-Quanten-Schlüsselaustausch ML-KEM. Das Profil edge entspricht in Xray dem alten Edge 85 ohne ML-KEM, eine Verbindung damit kommt nicht zustande. Das Profil firefox unterstützt ML-KEM, wenn die App den Xray-Kern 26.3.23 oder neuer enthält, halten Sie Ihre Clients also aktuell. Auch die Werte random und randomized sollten Sie nicht verwenden, weil sie ein Profil ohne ML-KEM wählen können.

---

Limits einrichten

Für jede Verbindung können Sie festlegen:

• ein Traffic-Limit (GB);
• eine Laufzeit (in Tagen);
• ein IP-Limit (gleichzeitige Verbindungen);
• die automatische Abschaltung bei Überschreiten des Limits.

---

Benutzer verwalten

1. Klicken Sie im Bereich Inbounds auf + neben der Verbindung.
2. Wählen Sie Add Client.
3. Geben Sie einen Namen, Limits, eine eindeutige ID und die Laufzeit an.

---

Clients verbinden

1. Klicken Sie im 3X-UI-Panel beim Benutzer auf das QR-Code-Symbol.
2. Kopieren Sie den Link oder speichern Sie den QR-Code.
3. Importieren Sie die Konfiguration in die App, wie in der Anleitung zum Import gezeigt.

---

Überwachung und Statistik

Das Panel zeigt:

• das gesamte Traffic-Volumen;
• den Traffic-Verbrauch pro Benutzer;
• den Status der Verbindungen;
• Laufzeit und Status der Konten;
• die IP-Adressen der Verbindungen.

---

3X-UI aktualisieren

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

Für Docker:

cd 3x-ui
docker compose down
docker compose pull 3x-ui
docker compose up -d

---

Probleme lösen

Die Standardparameter sind:

• Port des Panels – 2053
• Datenbank – /etc/x-ui/x-ui.db
• Konfiguration von Xray – /usr/local/x-ui/bin/config.json

---

Weitere Funktionen

• Sperren von Werbung und IP-Adressen;
• Routing des Datenverkehrs (Google, Netflix, Spotify, OpenAI) über WARP;
• die Unterstützung für WARP ist ab Version v2.1.0 eingebaut.

Schalten Sie einfach die gewünschte Option im Control Panel ein.