---
title: "Hysteria 2"
description: "Les options Hysteria 2, réglages TLS, liens et fonctionnalités pris en charge par Potatso."
---

> 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

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://`](#links), 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 {#authentication}

| 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}

| 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 {#bandwidth}

| 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 {#port-hopping}

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 {#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 {#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 {#features}

| Fonctionnalité | Pris en charge |
| --- | --- |
| [Protocole Hysteria 2](https://v2.hysteria.network/docs/developers/Protocol/) : 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](#bandwidth) (Brutal côté serveur) | ✅ |
| Bande passante montante (Brutal depuis votre appareil) | ❌ |
| [Saut de ports](#port-hopping) | ✅ |
| 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](https://v2.hysteria.network/), [sing-box](https://sing-box.sagernet.org/), [mihomo](https://wiki.metacubex.one/) ou [Xray](https://xtls.github.io/).

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://` {#links}

Un lien `hysteria2://` contient un serveur entier sur une ligne. `hy2://` est le même lien avec un nom plus court.

```text
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](#port-hopping), listez les ports ici, comme `443,20000-30000`. |
| `name` | Facultatif. Le nom du serveur dans Potatso. |

Les paramètres suivent le [format officiel](https://v2.hysteria.network/docs/developers/URI-Scheme/) :

| 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 {#link-examples}

Chaque exemple montre le lien à importer. Le mot de passe est `secret`.

Un serveur de base :

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

Obfuscation Salamander avec le mot de passe `hidden` :

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

Saut de ports entre 20000 et 30000 :

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

Un certificat autosigné, épinglé :

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

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