---
title: "Hysteria 2"
description: "Die von Potatso unterstützten Hysteria-2-Optionen, TLS-Einstellungen, Links und Funktionen."
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hysteria 2

Ein Hysteria-2-Server wird durch ein **Passwort** und seine **TLS-Einstellungen** beschrieben, optional ergänzt um **Verschleierung** und **Port-Hopping**. Hysteria 2 läuft über QUIC, das UDP-basierte Protokoll hinter HTTP/3, und behält deshalb seine Geschwindigkeit in Netzwerken, die Pakete verlieren. Potatso verbindet sich mit einem Server, wenn es dessen Einstellungen unterstützt. Prüfe anhand der Tabellen unten die Einstellungen deines Servers, wie dein Anbieter sie angibt oder wie sie in seinem `hysteria2://`-Link stehen.

Einen Hysteria-2-Server kannst du von Hand, mit einem [`hysteria2://`- oder `hy2://`-Link](#links) oder per Import hinzufügen:

- eines Clash- oder Mihomo-Abonnements,
- einer Xray-Konfiguration,
- einer Surge-Konfiguration.

Potatso importiert Hysteria-2-Server noch nicht aus einer sing-box-Konfiguration. Nutze stattdessen den `hysteria2://`-Link des Servers.

## Authentifizierung {#authentication}

| Authentifizierung des Servers | Unterstützt |
| --- | --- |
| Ein Passwort (`auth.type: password`) | ✅ |
| Ein Benutzername und Passwort (`auth.type: userpass`) | ✅ Gib sie als ein Passwort ein: `name:password` |
| Ein HTTP- oder Befehls-Authenticator | ✅ Gib das Passwort ein, das er erwartet |

Mit einem falschen Passwort kommt keine Verbindung zustande. Viele Server zeigen jedem ohne das Passwort eine gewöhnliche Website (ihre Tarnung).

## Verschleierung {#obfuscation}

| Verschleierung | Clash-Schlüssel | Link-Parameter | Unterstützt |
| --- | --- | --- | --- |
| Keine | | | ✅ |
| Salamander | `obfs: salamander`, `obfs-password` | `obfs=salamander`, `obfs-password` | ✅ |
| Gecko | `obfs: gecko` | `obfs=gecko` | ❌ |

Salamander verwürfelt jedes Paket, sodass die Verbindung nicht wie QUIC aussieht. Das Passwort muss zu dem des Servers passen. Setze es in den Servereinstellungen als **Salamander-Passwort**. Lass es bei einem Server ohne Verschleierung leer.

Potatso importiert keinen Server, der Gecko-Verschleierung nutzt, da es sich damit nicht verbinden könnte.

## Bandbreite {#bandwidth}

| Einstellung | Clash-Schlüssel | Unterstützt |
| --- | --- | --- |
| Download-Bandbreite | `down` | ✅ Der Server sendet mit dieser Rate an dich |
| Upload-Bandbreite | `up` | ❌ Potatso lädt mit BBR-Staukontrolle hoch und ignoriert diese Einstellung |
| Staukontrolle | `congestion` im offiziellen Client | ❌ Immer BBR |

Legst du eine **Download-Bandbreite** fest, etwa `100 Mbps`, sendet der Server mit dieser Rate, auch wenn Pakete verloren gehen, mithilfe der Brutal-Staukontrolle von Hysteria. Setze sie nahe an deine tatsächliche Download-Geschwindigkeit: Ist sie zu hoch, wird die Verbindung langsamer, nicht schneller. Lässt du sie leer, passt der Server seine Rate selbst an.

Die Bandbreite nimmt eine Zahl mit Einheit (`bps`, `Kbps`, `Mbps`, `Gbps`) oder eine einfache Zahl in Mbps.

## Port-Hopping {#port-hopping}

Ein Server mit Port-Hopping lauscht auf einem Bereich von UDP-Ports, und Potatso wechselt in regelmäßigen Abständen zwischen ihnen. Das hilft in Netzwerken, die einen UDP-Port nach einer Weile drosseln oder blockieren.

| Einstellung | Clash-Schlüssel | Unterstützt |
| --- | --- | --- |
| Ports | `ports` | ✅ Ein Bereich wie `20000-30000`, eine Liste wie `443,8443` oder beides |
| Wechselintervall | `hop-interval` | ✅ In Sekunden, standardmäßig 30 und mindestens 5. Ein Bereich wie `10-30` wählt ein zufälliges Intervall. |

Lege sie in den Servereinstellungen als **Port-Hopping** und **Wechselintervall** fest. Der Port des Servers wird dann nur für die erste Verbindung verwendet.

## TLS {#tls}

| Einstellung | Clash-Schlüssel | Link-Parameter | Unterstützt |
| --- | --- | --- | --- |
| Servername (SNI) | `sni` | `sni`, `peer` | ✅ Ohne Angabe verwendet Potatso die Adresse des Servers. |
| Zertifikatsprüfung überspringen | `skip-cert-verify` | `insecure` | ✅ |
| Zertifikat-Pinning (SHA-256) | `fingerprint` | `pinSHA256` | ✅ |
| ALPN | `alpn` | `alpn` | ✅ Nur `h3`, was Potatso immer verwendet |
| Eigenes CA-Zertifikat | `ca` im offiziellen Client | | ❌ |
| TLS-Clientzertifikat | `certificate`, `private-key` | | ❌ |
| Encrypted Client Hello (ECH) | `ech-opts` | `ech` | ❌ |
| Gegen einen anderen Namen prüfen | `name-cert-verify` | | ❌ |

Schaltest du die Zertifikatsprüfung aus, kann jeder zwischen dir und dem Server deinen Datenverkehr mitlesen. Viele Hysteria-2-Server nutzen ein selbstsigniertes Zertifikat: Pinne es stattdessen. Setze den SHA-256 des Zertifikats des Servers als Zertifikat-Pin. Mit einem Pin vertraut Potatso diesem Zertifikat und keinem anderen, gleich welchen Namen es trägt.

Potatso importiert keinen Server, der eine der oben genannten nicht unterstützten Einstellungen braucht, da es ohne sie verbinden würde und der Server nicht antworten würde.

## UDP {#udp}

Hysteria 2 trägt UDP in QUIC-Datagrammen, über dieselbe Verbindung wie TCP. UDP ist standardmäßig an. Schalte UDP-Relay in den Servereinstellungen nur aus, wenn dein Server UDP ausgeschaltet hat (`disableUDP`).

Über einen Xray-Server kommen UDP-Pakete, die größer als etwa 1.100 Byte sind, beschädigt an. Das ist ein Fehler im Hysteria-2-Server von Xray. Der offizielle Server, sing-box und mihomo leiten jede Größe weiter.

## Funktionsunterstützung {#features}

| Funktion | Unterstützt |
| --- | --- |
| [Hysteria-2-Protokoll](https://v2.hysteria.network/docs/developers/Protocol/): HTTP/3-Authentifizierung, TCP-Streams | ✅ |
| UDP in QUIC-Datagrammen, einschließlich großer, in Fragmente geteilter Pakete | ✅ |
| Viele Verbindungen in einer QUIC-Verbindung | ✅ |
| Salamander-Verschleierung | ✅ |
| Gecko-Verschleierung | ❌ |
| [Download-Bandbreite](#bandwidth) (Brutal auf dem Server) | ✅ |
| Upload-Bandbreite (Brutal von deinem Gerät) | ❌ |
| [Port-Hopping](#port-hopping) | ✅ |
| Fast Open (ein Round-Trip weniger pro Verbindung) | ✅ Immer an |
| Zertifikat-Pinning, Zertifikatsprüfung überspringen | ✅ |
| ECH, eigene CA, TLS-Clientzertifikate | ❌ |
| Realms (Verbinden über einen Rendezvous-Server) | ❌ |
| Fake TCP (`mimic`) | ❌ |
| Eigene QUIC-Flow-Control-Fenster, `cwnd`, `udp-mtu` | ❌ |
| `hysteria2://`- und `hy2://`-Links | ✅ |

Jede unterstützte Funktion ist gegen mindestens einen echten Hysteria-2-Server getestet: den [offiziellen Server](https://v2.hysteria.network/), [sing-box](https://sing-box.sagernet.org/), [mihomo](https://wiki.metacubex.one/) oder [Xray](https://xtls.github.io/).

Einige Funktionen des offiziellen Hysteria-Clients sind Einstellungen seines eigenen Programms, und Potatso erledigt dieselbe Aufgabe auf seine Weise:

- Routing und ACLs: Nutze Regeln in deinem Profil.
- Lokale SOCKS5- und HTTP-Server, Weiterleitung und TUN-Modus: Potatso erfasst den Datenverkehr deines Geräts selbst.
- Lazy Connection: Potatso verbindet, wenn Datenverkehr den Server braucht.

Serverseitige Einstellungen wie die Tarn-Website, der Geschwindigkeitstest oder die eigenen Bandbreitenlimits des Servers brauchen auf deinem Gerät nichts.

## `hysteria2://`-Links {#links}

Ein `hysteria2://`-Link enthält einen ganzen Server in einer Zeile. `hy2://` ist derselbe Link mit kürzerem Namen.

```text
hysteria2://password@host:port/?parameters#name
```

| Teil | Beschreibung |
| --- | --- |
| `password` | Das Passwort, prozentkodiert. Schreibe für Benutzername und Passwort `name:password`. |
| `host` | Serveradresse. Setze eine IPv6-Adresse in eckige Klammern, etwa `[2001:db8::1]`. |
| `port` | Serverport. Fehlt er, verwendet Potatso 443. Liste für [Port-Hopping](#port-hopping) die Ports hier auf, etwa `443,20000-30000`. |
| `name` | Optional. Der Name des Servers in Potatso. |

Die Parameter folgen dem [offiziellen Format](https://v2.hysteria.network/docs/developers/URI-Scheme/):

| Parameter | Beschreibung |
| --- | --- |
| `sni` | Der TLS-Servername. |
| `insecure` | `1` schaltet die Zertifikatsprüfung aus. |
| `pinSHA256` | Der SHA-256 des Zertifikats des Servers. |
| `obfs`, `obfs-password` | `salamander` und sein Passwort. |
| `mport` | Ports für Port-Hopping, wie manche Apps sie statt im Port schreiben. |
| `hop-interval` | Das Wechselintervall in Sekunden. |
| `up`, `down` | Die Upload- und Download-Bandbreite, wie manche Apps sie schreiben. |

Potatso importiert keinen Link mit `obfs=gecko` oder `ech`. Auch `hysteria2+realm://`-Links importiert es nicht.

Wenn Potatso einen Hysteria-2-Server teilt, bietet es einen `hysteria2://`-Link an, mit den Hopping-Ports entweder im Port oder als `mport`.

### Beispiele {#link-examples}

Jedes Beispiel zeigt den Link zum Importieren. Das Passwort ist `secret`.

Ein einfacher Server:

```text
hysteria2://secret@hy2.example.com:443/?sni=hy2.example.com#Basic
```

Salamander-Verschleierung mit dem Passwort `hidden`:

```text
hysteria2://secret@hy2.example.com:443/?obfs=salamander&obfs-password=hidden#Salamander
```

Port-Hopping zwischen 20000 und 30000:

```text
hysteria2://secret@hy2.example.com:443,20000-30000/?sni=hy2.example.com#Hopping
```

Ein selbstsigniertes Zertifikat, gepinnt:

```text
hysteria2://secret@203.0.113.7:443/?sni=hy2.example.com&pinSHA256=abababababababababababababababababababababababababababababababab#Pinned
```

Source: https://potatso.com/docs/de/protocols/hysteria2/index.mdx