> Die vollständige Liste der Artikel steht in [llms.txt](https://docs.f3cloud.com/llms.txt). Jede Seite gibt es auch als Markdown, dazu einfach .md an die Adresse anhängen. Diese Seite als Markdown: [https://docs.f3cloud.com/de/vpn-guide/marzban-installation.md](https://docs.f3cloud.com/de/vpn-guide/marzban-installation.md).

# Marzban auf einem VPS installieren und VLESS mit Xray einrichten

Wie Sie Marzban mit einem einzigen Befehl auf einem VPS installieren. Das Skript von F3 Cloud richtet VLESS Reality selbst ein, wählt eine Website zur Tarnung, setzt den Fingerprint firefox und schließt überflüssige Ports. Anmeldung im Panel, Anlegen eines Benutzers, Verbindung in der App und häufige Fragen.

**Marzban** ist ein Webpanel für Ihr eigenes VPN auf Basis des Xray-Kerns. Darin legen Sie bequem Benutzer an, geben ihnen Links für die Verbindung und behalten den Datenverbrauch im Blick.

Damit Sie nicht alles von Hand einrichten müssen, haben wir ein Skript vorbereitet. Ein einziger Befehl installiert Marzban und richtet gleich das Protokoll **VLESS Reality** ein, Ihnen bleibt dann nur, sich im Panel anzumelden und einen Benutzer anzulegen. Alle Schritte haben wir auf einem Server von F3 Cloud mit Debian 12 und Marzban 0.8.4 getestet.

***

### Was Sie brauchen

Für ein privates VPN reicht ein Server mit **1 Kern** und **1 GB** Arbeitsspeicher, zum Beispiel im Tarif **DE-PROMO**. Achten Sie bei der Bestellung auf zwei Einstellungen.

1. Wählen Sie im Feld **Operating system** das System **Debian** und die Version **Debian 12**. Die Versionen öffnen sich über den Pfeil neben dem Namen des Systems.

<figure><img src="https://docs.f3cloud.com/img/order-os.png" alt="Auswahl von Debian 12 bei der Bestellung eines Servers"><figcaption><p>Auswahl von Debian 12</p></figcaption></figure>

2. Lassen Sie im Feld **Preinstalled software** den Wert **не установлен** (nicht installiert) stehen. Marzban installiert unser Skript, deshalb müssen Sie in dieser Liste nichts auswählen.

<figure><img src="https://docs.f3cloud.com/img/order-software.png" alt="Feld Preinstalled software mit dem Wert nicht installiert" width="440"><figcaption><p>Vorinstallierte Software wird nicht benötigt</p></figcaption></figure>

Die übrigen Bestellschritte sind wie gewohnt, wir haben sie im Artikel [„Virtuellen Server bestellen“](https://docs.f3cloud.com/de/client-area/order-vps.md) ausführlich gezeigt. Nach der Zahlung erhalten Sie die IP-Adresse und das Passwort des Servers per E-Mail, außerdem finden Sie beides im Kundenbereich über die Schaltfläche [Instructions](https://docs.f3cloud.com/de/client-area/order-vps.md#access).

> **Sie haben schon einen Server.**
>
> Das Skript ist für einen neuen Server gedacht. Wenn auf Ihrem Server schon etwas eingerichtet ist, [installieren Sie das System](https://docs.f3cloud.com/de/client-area/reinstall-os.md) zuerst mit Debian 12 neu.

***

### Schritt 1. Skript starten

Verbinden Sie sich [per SSH](https://docs.f3cloud.com/de/vps/termius-connection.md) als Benutzer root mit dem Server. Kopieren Sie den Befehl, fügen Sie ihn ins Terminal ein und drücken Sie <kbd>Enter</kbd>.

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/f3cloud-host/Marzban/main/marzban-setup.sh)
```

Das Skript arbeitet selbstständig und stellt keine Fragen. Die Installation dauert ein paar Minuten, auf unserem Testserver war sie in weniger als einer Minute erledigt.

Das macht das Skript der Reihe nach:

1. Es installiert die benötigten Programme.
2. Es wählt eine Website zur Tarnung aus. Wozu sie dient, erklären wir [weiter unten](#sait-dlya-maskirovki).
3. Es installiert Marzban mit dem offiziellen Installer.
4. Es legt eine Verbindung **VLESS Reality** auf Port 443 mit neuen Schlüsseln an.
5. Es öffnet das Panel auf einem zufälligen Port, legt den Administrator `admin` mit einem zufälligen Passwort an und setzt in den Links den Fingerprint `firefox`.
6. Es schaltet die Firewall ein und lässt nur die Ports **22** (SSH), **443** (VPN) und den Port des Panels offen.

Wenn alles fertig ist, zeigt das Skript die Adresse des Panels, den Benutzernamen und das Passwort an.

<figure><img src="https://docs.f3cloud.com/img/marzban-script-done.png" alt="Ergebnis des Skripts mit Adresse des Panels, Benutzername und Passwort"><figcaption><p>Marzban ist installiert und eingerichtet</p></figcaption></figure>

> **Wo Sie das Passwort finden.**
>
> Die Zugangsdaten speichert das Skript auf dem Server, deshalb können Sie sie jederzeit mit diesem Befehl ansehen.
>
> ```bash
> cat /root/marzban-credentials.txt
> ```

Der Code des Skripts ist offen, Sie können ihn auf [GitHub](https://github.com/f3cloud-host/Marzban) ansehen.

***

### Schritt 2. Im Panel anmelden

Öffnen Sie im Browser die Adresse aus der Ausgabe des Skripts, sie sieht etwa so aus wie `http://SERVER-IP:Port/dashboard/`. Melden Sie sich mit dem Benutzernamen `admin` und dem Passwort aus derselben Ausgabe an.

Falls das Panel in einer anderen Sprache erscheint, stellen Sie die Sprache über die Schaltfläche mit dem Übersetzungssymbol oben rechts um.

> **Das Panel öffnet sich über HTTP.**
>
> Das Passwort wird bei der Anmeldung im Panel unverschlüsselt übertragen. Melden Sie sich nicht über ein öffentliches WLAN an und schicken Sie die Adresse nicht zusammen mit dem Passwort in offenen Chats.

***

### Schritt 3. Benutzer anlegen

Ein Benutzer in Marzban ist ein eigener Zugang zum VPN. Legen Sie für sich und für Ihre Angehörigen lieber getrennte Benutzer an, denn so können Sie jeden Zugang abschalten, ohne die anderen anzurühren.

1. Klicken Sie auf <kbd>Create User</kbd>.
2. Geben Sie einen **Username** ein, zum Beispiel `phone`.
3. Prüfen Sie im Block **Protocols**, ob die Karte **Vless** umrandet ist. Falls nicht, klicken Sie darauf.
4. Die Felder **Data Limit** und **Expiry Date** können Sie leer lassen, dann gilt der Zugang ohne Einschränkungen.
5. Klicken Sie auf <kbd>Create User</kbd>.

<figure><img src="https://docs.f3cloud.com/img/marzban-user-create.png" alt="Fenster zum Anlegen eines Benutzers in Marzban mit ausgewähltem Protokoll Vless" width="448"><figcaption><p>Benutzer anlegen</p></figcaption></figure>

Der Benutzer erscheint in der Liste. Rechts daneben gibt es drei Schaltflächen, ihre Namen werden angezeigt, wenn Sie mit der Maus darüberfahren.

<figure><img src="https://docs.f3cloud.com/img/marzban-user-list.png" alt="Benutzerliste in Marzban mit den Schaltflächen für Abonnement, Konfiguration und QR-Code"><figcaption><p>Der Benutzer ist angelegt</p></figcaption></figure>

| Schaltfläche | Was sie macht |
| --- | --- |
| Copy Subscription Link | Kopiert den Abonnement-Link. Wir empfehlen, genau diesen Link in die App einzufügen, dann übernimmt die App neue Einstellungen von selbst, wenn Sie sie im Panel ändern |
| Copy Configs | Kopiert den Link zur Verbindung selbst, er beginnt mit `vless://` |
| QR Code | Zeigt die QR-Codes für Abonnement und Verbindung, die sich bequem mit dem Smartphone scannen lassen |

***

### Schritt 4. Mit dem VPN verbinden

Verbinden können Sie sich mit jeder App auf Basis des Xray-Kerns. Wir empfehlen **Incy** oder **Happ**, Links zu diesen und weiteren Apps finden Sie [weiter unten](#klientskie-prilozheniya).

1. Installieren Sie die App auf Ihrem Smartphone oder Computer.
2. Tippen Sie in der App auf die Schaltfläche zum Hinzufügen einer Verbindung.
3. Wählen Sie den Import aus der Zwischenablage und fügen Sie den Abonnement-Link ein. Auf dem Smartphone ist es bequemer, den QR-Code **Subscribe Link** zu scannen.
4. Schalten Sie die Verbindung ein.

<figure><img src="https://docs.f3cloud.com/img/marzban-user-qr.png" alt="Fenster mit den QR-Codes für Abonnement und Verbindung in Marzban" width="420"><figcaption><p>QR-Codes des Benutzers, im Screenshot sind sie verdeckt</p></figcaption></figure>

Um zu prüfen, ob Ihr Datenverkehr über das VPN läuft, öffnen Sie im Browser [api.ipify.org](https://api.ipify.org). Dort sollte die IP-Adresse Ihres Servers angezeigt werden.

> **Abonnement-Link und QR-Code sind der Schlüssel zu Ihrem VPN.**
>
> Abonnement-Link und QR-Code sind der Schlüssel zu Ihrem VPN. Jeder, der sie in die Hände bekommt, kann sich damit verbinden. Veröffentlichen Sie sie deshalb nicht und schicken Sie sie nicht über offene Chats.

***

### TLS-Fingerabdruck (Fingerprint) {#otpechatok-tls-fingerprint}

Der Fingerprint legt fest, als welcher Browser sich die App beim Verbinden ausgibt. Marzban trägt standardmäßig `chrome` in die Links ein, das Skript ändert ihn aber sofort auf `firefox`, sodass Sie von Hand nichts tun müssen.

Prüfen oder ändern können Sie den Fingerprint im Panel.

1. Öffnen Sie oben rechts das Menü <kbd>☰</kbd> und wählen Sie **Host Settings**.
2. Klicken Sie auf **VLESS TCP REALITY** und dann auf **Advanced options**.
3. Im Feld **Fingerprint** sollte `firefox` stehen. Wenn Sie den Wert geändert haben, klicken Sie auf <kbd>Apply</kbd>.
4. Aktualisieren Sie das Abonnement in der App, damit sie die neuen Einstellungen erhält.

<figure><img src="https://docs.f3cloud.com/img/marzban-host-fingerprint.png" alt="Feld Fingerprint mit dem Wert firefox in den Host-Einstellungen von Marzban" width="293"><figcaption><p>Fingerprint firefox in den Host-Einstellungen</p></figcaption></figure>

> **Warum firefox und nicht chrome.**
>
> Seit Ende 2025 bewerten die Systeme zur Verkehrsfilterung russischer Provider (TSPU) eine TLS-Verbindung nach mehreren Merkmalen zugleich – dem Subnetz des Hosters, dem Namen der Website (SNI) und dem Fingerprint 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 zuverlässigen Erkennungszeichen für einen Proxy geworden. Nutzer berichten, dass die Verbindung bei mehreren gleichzeitigen Verbindungen mit diesem Fingerprint für einige Minuten „einfriert“, und dass der Wechsel auf `firefox` hilft.
>
> Der Fingerprint `edge` hat früher ebenfalls geholfen, ist aber seit September 2026 mit neuen Versionen von Xray nicht mehr kompatibel. Ab Xray 26.9.8 (enthalten zum Beispiel in 3X-UI 3.8.0 und neuer) akzeptiert der Reality-Server nur Clients mit dem Post-Quanten-Schlüsselaustausch ML-KEM. Das Profil `edge` entspricht in Xray dem alten Edge 85 ohne ML-KEM, und eine Verbindung damit kommt nicht zustande. Das Profil `firefox` unterstützt ML-KEM, wenn die App den Xray-Kern 26.3.23 oder neuer nutzt, halten Sie Ihre Clients deshalb aktuell. Verwenden Sie auch die Werte `random` und `randomized` nicht – sie können ein Profil ohne ML-KEM auswählen.

***

### Website zur Tarnung {#sait-dlya-maskirovki}

VLESS Reality tarnt die Verbindung zum VPN als gewöhnlichen Aufruf einer beliebigen Website. Von außen sieht es so aus, als würden Sie einfach diese Website öffnen.

Das Skript wählt eine solche Website selbst aus. Es hat eine Liste kleiner europäischer Websites und prüft vor der Auswahl, ob die Website mit TLS 1.3 und HTTP/2 arbeitet und nicht hinter Cloudflare oder einem anderen CDN versteckt ist. Mit solchen Websites arbeitet Reality am zuverlässigsten. Welche Website gewählt wurde, sehen Sie in der Ausgabe des Skripts und in der Datei `/root/marzban-credentials.txt`.

> **Tarnung als eigene Domain.**
>
> Damit Ihr VPN Sperren besser standhält, können Sie die Verbindung nach dem Self-steal-Verfahren als Ihre eigene Domain tarnen. Wie das in Marzban geht, beschreibt der Artikel [„Self-steal für VLESS Reality“](https://docs.f3cloud.com/de/vpn-guide/reality-self-steal.md#self-steal-in-panels).

***

### Client-Apps {#klientskie-prilozheniya}

Mit dem Server können Sie sich aus jeder App auf Basis des Xray-Kerns verbinden. Unten finden Sie die Varianten in der Reihenfolge unserer Empfehlung. Die Angaben zur Verfügbarkeit in den App-Stores entsprechen dem Stand von Oktober 2026.

#### 1. Incy <a href="#incy" id="incy"></a>

Eine kostenlose App auf Basis von Xray-core für alle gängigen Plattformen. Sie unterstützt VLESS (auch Reality und XTLS Vision), VMess, Trojan, Shadowsocks, Hysteria2 und WireGuard sowie den Transport XHTTP. Links, QR-Codes und Abonnements lassen sich importieren. Derzeit ist Incy im russischen App Store verfügbar.

> **Hinweis.**
>
> Download-Links:
>
> * [App Store](https://apps.apple.com/de/app/incy/id6756943388) – iPhone, iPad, Apple TV und Mac mit Apple-M1-Chip oder neuer;
> * [Google Play](https://play.google.com/store/apps/details?id=llc.itdev.incy) – Android und Android TV;
> * [APK-Datei](https://github.com/INCY-DEV/incy-platforms/releases/latest/download/Incy.apk) – falls Google Play nicht verfügbar ist;
> * [Windows](https://github.com/INCY-DEV/incy-platforms/releases/latest/download/incy-windows-setup.exe), [macOS Apple Silicon](https://github.com/INCY-DEV/incy-platforms/releases/latest/download/incy-macos-arm64.dmg), [macOS Intel](https://github.com/INCY-DEV/incy-platforms/releases/latest/download/incy-macos-intel.dmg) und [Linux](https://github.com/INCY-DEV/incy-platforms/releases/latest) – die Desktop-Versionen befinden sich noch in einem frühen Entwicklungsstadium.

#### 2. Happ <a href="#happ" id="happ"></a>

Ein beliebter Client auf Basis von Xray-core für alle Plattformen. Er unterstützt VLESS, VMess, Trojan, Shadowsocks, Hysteria2 und Abonnements.

> **Achtung.**
>
> Seit März 2026 wurde Happ auf Verlangen von Roskomnadzor mehrmals aus dem russischen App Store entfernt. Derzeit ist die Version für iPhone, iPad und Mac nur in Stores außerhalb Russlands erhältlich und erfordert eine Apple-ID aus einem anderen Land. Im russischen App Store ist nur die Version für Apple TV geblieben. Hüten Sie sich vor Klonen mit ähnlichen Namen – den echten Happ veröffentlicht der Entwickler Flyfrog LLC.

> **Hinweis.**
>
> Download-Links:
>
> * [App Store (außerhalb Russlands)](https://apps.apple.com/us/app/happ-proxy-utility/id6504287215) – iPhone, iPad und Mac;
> * [App Store, Version für Apple TV](https://apps.apple.com/de/app/happ-proxy-utility-for-tv/id6748297274);
> * [Google Play](https://play.google.com/store/apps/details?id=com.happproxy) – Android und Android TV;
> * [APK-Datei](https://github.com/Happ-proxy/happ-android/releases/latest/download/Happ.apk) – falls Google Play nicht verfügbar ist;
> * [Windows](https://github.com/Happ-proxy/happ-desktop/releases/latest/download/setup-Happ.x64.exe), [macOS](https://github.com/Happ-proxy/happ-desktop/releases/latest/download/Happ.macOS.universal.dmg) und [Linux](https://github.com/Happ-proxy/happ-desktop/releases/latest).

#### 3. v2RayTun <a href="#v2raytun" id="v2raytun"></a>

Ein einfacher Client auf Basis von Xray-core. Die Version für iPhone und Mac ist bis Oktober 2026 in allen Ländern aus dem App Store verschwunden, deshalb eignet sich v2RayTun für Android und Windows.

> **Hinweis.**
>
> Download-Links:
>
> * [Google Play](https://play.google.com/store/apps/details?id=com.v2raytun.android) – Android und Android TV;
> * [Windows](https://storage.v2raytun.com/v2RayTun_Setup.exe).

#### 4. v2rayN und v2rayNG <a href="#v2rayn" id="v2rayn"></a>

Open-Source-Clients auf Basis von Xray-core – v2rayN für Computer und v2rayNG für Android. Sie eignen sich für erfahrene Nutzer, die die Einstellungen vollständig selbst in der Hand haben möchten.

> **Hinweis.**
>
> Download-Links:
>
> * [v2rayN](https://github.com/2dust/v2rayN/releases/latest) – Windows, macOS und Linux;
> * [v2rayNG](https://github.com/2dust/v2rayNG/releases/latest) – Android.

#### Weitere Clients

* **Streisand** – ein Client für iPhone, iPad und Mac. Im März 2026 aus dem russischen App Store entfernt, in [Stores außerhalb Russlands](https://apps.apple.com/us/app/streisand/id6450534064) weiterhin erhältlich.
* **V2Box** – im März 2026 aus dem russischen App Store entfernt.
* **Hiddify**, **NekoBox**, **Throne** und **NekoRay** arbeiten mit dem Kern sing-box.

> **Achtung.**
>
> Clients auf Basis des Kerns sing-box (Hiddify, NekoBox, Throne, NekoRay, Karing) können sich nicht mit Reality auf Servern mit Xray 26.9.8 und neuer verbinden – das betrifft zum Beispiel 3X-UI ab Version 3.8.0. Außerdem unterstützt sing-box den Transport XHTTP nicht. Verwenden Sie für solche Server Clients auf Basis des Xray-Kerns.

***

### Häufige Fragen

<details>

<summary>Das Skript meldet, dass der Server nicht neu ist</summary>

Das Skript bricht ab, wenn auf dem Server bereits Marzban installiert ist, Port 443 von einem anderen Programm belegt ist oder in Nginx andere Websites eingerichtet sind. So macht es nichts kaputt, was bereits funktioniert. [Installieren Sie das System](https://docs.f3cloud.com/de/client-area/reinstall-os.md) im Kundenbereich neu und starten Sie das Skript erneut.

</details>

<details>

<summary>Das Skript ist mit einem Fehler abgebrochen</summary>

Details zum Fehler schreibt das Skript in die Datei `/root/marzban-setup.log`. Wenn der Fehler bei der Auswahl der Website zur Tarnung aufgetreten ist, warten Sie ein paar Minuten und starten Sie das Skript noch einmal. In allen anderen Fällen installieren Sie das System neu und starten das Skript von vorn. Wenn der Fehler wieder auftritt, erstellen Sie im Kundenbereich ein Ticket und hängen Sie diese Datei an.

</details>

<details>

<summary>Das Panel öffnet sich nicht</summary>

Prüfen Sie, ob Sie die Adresse mit `http://` und nicht mit `https://` öffnen und den Port aus der Ausgabe des Skripts angeben. Ob Marzban läuft, zeigt der Befehl `marzban status`. In der Antwort sollte die Zeile `marzban: running` stehen.

</details>

<details>

<summary>Passwort für das Panel vergessen</summary>

Benutzername und Passwort, die das Skript angelegt hat, liegen auf dem Server. Sie können sie mit diesem Befehl ansehen.

```bash
cat /root/marzban-credentials.txt
```

</details>

<details>

<summary>Marzban aktualisieren</summary>

Führen Sie einen einzigen Befehl aus. Benutzer und Einstellungen bleiben beim Update erhalten.

```bash
marzban update
```

</details>

<details>

<summary>Das VPN verbindet sich nicht</summary>

Aktualisieren Sie die App auf die neueste Version und aktualisieren Sie darin das Abonnement. Prüfen Sie, ob der Benutzer im Panel den Status **Active** hat und ob in den [Host-Einstellungen](#otpechatok-tls-fingerprint) der Fingerprint `firefox` eingestellt ist.

</details>

***

### Unsere Ressourcen

**Telegram-Kanal:** [https://t.me/f3cloud_news](https://t.me/f3cloud_news)\
**Hosting-Website:** [https://f3cloud.com](https://f3cloud.com/de)