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 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
| 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
| 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
| 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
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
| 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
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
| Funktion | Unterstützt |
|---|---|
| Hysteria-2-Protokoll: 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 (Brutal auf dem Server) | ✅ |
| Upload-Bandbreite (Brutal von deinem Gerät) | ❌ |
| 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, sing-box, mihomo oder Xray.
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
Ein hysteria2://-Link enthält einen ganzen Server in einer Zeile. hy2:// ist derselbe Link mit kürzerem Namen.
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 die Ports hier auf, etwa 443,20000-30000. |
name |
Optional. Der Name des Servers in Potatso. |
Die Parameter folgen dem offiziellen Format:
| 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
Jedes Beispiel zeigt den Link zum Importieren. Das Passwort ist secret.
Ein einfacher Server:
hysteria2://secret@hy2.example.com:443/?sni=hy2.example.com#BasicSalamander-Verschleierung mit dem Passwort hidden:
hysteria2://secret@hy2.example.com:443/?obfs=salamander&obfs-password=hidden#SalamanderPort-Hopping zwischen 20000 und 30000:
hysteria2://secret@hy2.example.com:443,20000-30000/?sni=hy2.example.com#HoppingEin selbstsigniertes Zertifikat, gepinnt:
hysteria2://secret@203.0.113.7:443/?sni=hy2.example.com&pinSHA256=abababababababababababababababababababababababababababababababab#Pinned