Un serveur Hysteria 2 se décrit par un mot de passe et ses réglages TLS, et éventuellement par une obfuscation et un saut de ports. Hysteria 2 fonctionne sur QUIC, le protocole basé sur UDP derrière HTTP/3, et conserve donc sa vitesse sur les réseaux qui perdent des paquets. Potatso se connecte à un serveur lorsqu’il prend en charge ses réglages. Utilisez les tableaux ci-dessous pour vérifier les réglages de votre serveur, tels que votre fournisseur les indique ou tels qu’ils figurent dans son lien hysteria2://.
Vous pouvez ajouter un serveur Hysteria 2 à la main, avec un lien hysteria2:// ou hy2://, ou en important :
- un abonnement Clash ou Mihomo,
- une configuration Xray,
- une configuration Surge.
Potatso n’importe pas encore les serveurs Hysteria 2 d’une configuration sing-box. Utilisez plutôt le lien hysteria2:// du serveur.
Authentification
| Authentification du serveur | Pris en charge |
|---|---|
Un mot de passe (auth.type: password) |
✅ |
Un nom d’utilisateur et un mot de passe (auth.type: userpass) |
✅ Saisissez-les comme un seul mot de passe : nom:mot de passe |
| Un authentificateur HTTP ou par commande | ✅ Saisissez le mot de passe qu’il attend |
Un mot de passe incorrect ne se connecte pas. De nombreux serveurs affichent un site web ordinaire (leur camouflage) à quiconque n’a pas le mot de passe.
Obfuscation
| Obfuscation | Clé Clash | Paramètre de lien | Pris en charge |
|---|---|---|---|
| Aucune | ✅ | ||
| Salamander | obfs: salamander, obfs-password |
obfs=salamander, obfs-password |
✅ |
| Gecko | obfs: gecko |
obfs=gecko |
❌ |
Salamander brouille chaque paquet pour que la connexion ne ressemble pas à du QUIC. Le mot de passe doit correspondre à celui du serveur. Saisissez-le dans Mot de passe Salamander dans les réglages du serveur. Laissez-le vide pour un serveur sans obfuscation.
Potatso n’importe pas un serveur qui utilise l’obfuscation Gecko, car il ne pourrait pas s’y connecter.
Bande passante
| Réglage | Clé Clash | Pris en charge |
|---|---|---|
| Bande passante descendante | down |
✅ Le serveur vous envoie à ce débit |
| Bande passante montante | up |
❌ Potatso envoie avec le contrôle de congestion BBR et ignore ce réglage |
| Contrôle de congestion | congestion dans le client officiel |
❌ Toujours BBR |
Quand vous réglez une bande passante descendante, comme 100 Mbps, le serveur envoie à ce débit même en cas de perte de paquets, grâce au contrôle de congestion Brutal d’Hysteria. Réglez-la près de votre vitesse de téléchargement réelle : trop haute, la connexion devient plus lente, pas plus rapide. Laissez-la vide et le serveur adapte lui-même son débit.
La bande passante prend un nombre avec une unité (bps, Kbps, Mbps, Gbps), ou un simple nombre en Mbps.
Saut de ports
Un serveur avec saut de ports écoute sur une plage de ports UDP, et Potatso passe de l’un à l’autre de temps en temps. Cela aide sur les réseaux qui ralentissent ou bloquent un port UDP au bout d’un moment.
| Réglage | Clé Clash | Pris en charge |
|---|---|---|
| Ports | ports |
✅ Une plage comme 20000-30000, une liste comme 443,8443, ou les deux |
| Intervalle de saut | hop-interval |
✅ En secondes, 30 par défaut et 5 au minimum. Une plage comme 10-30 choisit un intervalle aléatoire. |
Saisissez-les dans Saut de ports et Intervalle de saut dans les réglages du serveur. Le port du serveur n’est alors utilisé que pour la première connexion.
TLS
| Réglage | Clé Clash | Paramètre de lien | Pris en charge |
|---|---|---|---|
| Nom du serveur (SNI) | sni |
sni, peer |
✅ Sans nom, Potatso utilise l’adresse du serveur. |
| Ignorer la vérification du certificat | skip-cert-verify |
insecure |
✅ |
| Épinglage de certificat (SHA-256) | fingerprint |
pinSHA256 |
✅ |
| ALPN | alpn |
alpn |
✅ h3 uniquement, que Potatso utilise toujours |
| Certificat CA personnalisé | ca dans le client officiel |
❌ | |
| Certificat client TLS | certificate, private-key |
❌ | |
| Encrypted Client Hello (ECH) | ech-opts |
ech |
❌ |
| Vérifier par rapport à un autre nom | name-cert-verify |
❌ |
Désactiver la vérification du certificat permet à n’importe qui entre vous et le serveur de lire votre trafic. De nombreux serveurs Hysteria 2 utilisent un certificat autosigné : épinglez-le plutôt. Saisissez le SHA-256 du certificat du serveur comme épinglage de certificat. Avec un épinglage, Potatso fait confiance à ce certificat et à aucun autre, quel que soit son nom.
Potatso n’importe pas un serveur qui exige l’un des réglages non pris en charge ci-dessus, car il se connecterait sans lui et le serveur ne répondrait pas.
UDP
Hysteria 2 transporte l’UDP dans des datagrammes QUIC, sur la même connexion que le TCP. L’UDP est activé par défaut. Désactivez Relais UDP dans les réglages du serveur uniquement si votre serveur a l’UDP désactivé (disableUDP).
Via un serveur Xray, les paquets UDP de plus de 1 100 octets environ arrivent corrompus. C’est un bogue du serveur Hysteria 2 de Xray. Le serveur officiel, sing-box et mihomo relaient toutes les tailles.
Fonctionnalités prises en charge
| Fonctionnalité | Pris en charge |
|---|---|
| Protocole Hysteria 2 : authentification HTTP/3, flux TCP | ✅ |
| UDP dans des datagrammes QUIC, y compris les gros paquets fragmentés | ✅ |
| Plusieurs connexions dans une seule connexion QUIC | ✅ |
| Obfuscation Salamander | ✅ |
| Obfuscation Gecko | ❌ |
| Bande passante descendante (Brutal côté serveur) | ✅ |
| Bande passante montante (Brutal depuis votre appareil) | ❌ |
| Saut de ports | ✅ |
| Fast open (un aller-retour de moins par connexion) | ✅ Toujours activé |
| Épinglage de certificat, vérification du certificat ignorée | ✅ |
| ECH, CA personnalisée, certificats client TLS | ❌ |
| Realms (connexion via un serveur de rendez-vous) | ❌ |
Faux TCP (mimic) |
❌ |
Fenêtres de contrôle de flux QUIC personnalisées, cwnd, udp-mtu |
❌ |
Liens hysteria2:// et hy2:// |
✅ |
Chaque fonctionnalité prise en charge est testée avec au moins un vrai serveur Hysteria 2 : le serveur officiel, sing-box, mihomo ou Xray.
Certaines fonctionnalités du client Hysteria officiel sont des réglages de son propre programme, et Potatso fait le même travail à sa façon :
- Routage et ACL : utilisez les règles de votre profil.
- Serveurs SOCKS5 et HTTP locaux, redirection et mode TUN : Potatso capture lui-même le trafic de votre appareil.
- Connexion différée : Potatso se connecte quand le trafic a besoin du serveur.
Les réglages côté serveur, comme le site web de camouflage, le test de vitesse ou les limites de bande passante du serveur, ne demandent rien sur votre appareil.
Liens hysteria2://
Un lien hysteria2:// contient un serveur entier sur une ligne. hy2:// est le même lien avec un nom plus court.
hysteria2://password@host:port/?parameters#name| Partie | Description |
|---|---|
password |
Le mot de passe, encodé en pourcentage. Pour un nom d’utilisateur et un mot de passe, écrivez nom:mot de passe. |
host |
Adresse du serveur. Placez une adresse IPv6 entre crochets, comme [2001:db8::1]. |
port |
Port du serveur. S’il manque, Potatso utilise 443. Pour le saut de ports, listez les ports ici, comme 443,20000-30000. |
name |
Facultatif. Le nom du serveur dans Potatso. |
Les paramètres suivent le format officiel :
| Paramètre | Description |
|---|---|
sni |
Le nom du serveur TLS. |
insecure |
1 désactive la vérification du certificat. |
pinSHA256 |
Le SHA-256 du certificat du serveur. |
obfs, obfs-password |
salamander et son mot de passe. |
mport |
Les ports du saut de ports, comme certaines apps les écrivent au lieu de les mettre dans le port. |
hop-interval |
L’intervalle de saut en secondes. |
up, down |
La bande passante montante et descendante, comme certaines apps les écrivent. |
Potatso n’importe pas un lien avec obfs=gecko ou ech. Il n’importe pas non plus les liens hysteria2+realm://.
Quand Potatso partage un serveur Hysteria 2, il propose un lien hysteria2://, avec les ports de saut dans le port ou sous mport.
Exemples
Chaque exemple montre le lien à importer. Le mot de passe est secret.
Un serveur de base :
hysteria2://secret@hy2.example.com:443/?sni=hy2.example.com#BasicObfuscation Salamander avec le mot de passe hidden :
hysteria2://secret@hy2.example.com:443/?obfs=salamander&obfs-password=hidden#SalamanderSaut de ports entre 20000 et 30000 :
hysteria2://secret@hy2.example.com:443,20000-30000/?sni=hy2.example.com#HoppingUn certificat autosigné, épinglé :
hysteria2://secret@203.0.113.7:443/?sni=hy2.example.com&pinSHA256=abababababababababababababababababababababababababababababababab#Pinned