---
title: "Hysteria 2"
description: "Le opzioni, le impostazioni TLS, i link e le funzioni di Hysteria 2 supportati da 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 server Hysteria 2 è descritto da una **password** e dalle sue **impostazioni TLS**, e facoltativamente da **offuscamento** e **salto di porta**. Hysteria 2 funziona su QUIC, il protocollo basato su UDP alla base di HTTP/3, quindi mantiene la velocità sulle reti che perdono pacchetti. Potatso si connette a un server quando ne supporta le impostazioni. Usa le tabelle qui sotto per controllare le impostazioni del tuo server, come le indica il tuo provider o come compaiono nel suo link `hysteria2://`.

Puoi aggiungere un server Hysteria 2 a mano, con un [link `hysteria2://` o `hy2://`](#links), oppure importando:

- una sottoscrizione Clash o Mihomo,
- una configurazione Xray,
- una configurazione Surge.

Potatso non importa ancora server Hysteria 2 da una configurazione sing-box. Usa invece il link `hysteria2://` del server.

## Autenticazione {#authentication}

| Autenticazione del server | Supportata |
| --- | --- |
| Una password (`auth.type: password`) | ✅ |
| Un nome utente e una password (`auth.type: userpass`) | ✅ Inseriscili come un'unica password: `name:password` |
| Un autenticatore HTTP o a comando | ✅ Inserisci la password che si aspetta |

Una password sbagliata non si connette. Molti server mostrano un normale sito web (il loro masquerade) a chiunque non abbia la password.

## Offuscamento {#obfuscation}

| Offuscamento | Chiave Clash | Parametro del link | Supportato |
| --- | --- | --- | --- |
| Nessuno | | | ✅ |
| Salamander | `obfs: salamander`, `obfs-password` | `obfs=salamander`, `obfs-password` | ✅ |
| Gecko | `obfs: gecko` | `obfs=gecko` | ❌ |

Salamander rimescola ogni pacchetto in modo che la connessione non somigli a QUIC. La password deve corrispondere a quella del server. Impostala come **Password Salamander** nelle impostazioni del server. Lasciala vuota per un server senza offuscamento.

Potatso non importa un server che usa l'offuscamento Gecko, perché non potrebbe connettersi.

## Banda {#bandwidth}

| Impostazione | Chiave Clash | Supportata |
| --- | --- | --- |
| Banda in download | `down` | ✅ Il server invia a te a questa velocità |
| Banda in upload | `up` | ❌ Potatso carica con il controllo di congestione BBR e ignora questa impostazione |
| Controllo di congestione | `congestion` nel client ufficiale | ❌ Sempre BBR |

Quando imposti una **banda in download**, come `100 Mbps`, il server invia a quella velocità anche quando i pacchetti vanno persi, usando il controllo di congestione Brutal di Hysteria. Impostala vicina alla tua reale velocità di download: se è troppo alta la connessione rallenta invece di accelerare. Lasciala vuota e il server adatta da sé la sua velocità.

La banda accetta un numero con un'unità (`bps`, `Kbps`, `Mbps`, `Gbps`), oppure un numero semplice in Mbps.

## Salto di porta {#port-hopping}

Un server con salto di porta ascolta su un intervallo di porte UDP, e Potatso passa dall'una all'altra a intervalli. Questo aiuta sulle reti che rallentano o bloccano una porta UDP dopo un po'.

| Impostazione | Chiave Clash | Supportata |
| --- | --- | --- |
| Porte | `ports` | ✅ Un intervallo come `20000-30000`, un elenco come `443,8443`, o entrambi |
| Intervallo di salto | `hop-interval` | ✅ In secondi, 30 per impostazione predefinita e almeno 5. Un intervallo come `10-30` sceglie un intervallo casuale. |

Impostali come **Salto di porta** e **Intervallo di salto** nelle impostazioni del server. La porta del server viene allora usata solo per la prima connessione.

## TLS {#tls}

| Impostazione | Chiave Clash | Parametro del link | Supportata |
| --- | --- | --- | --- |
| Nome del server (SNI) | `sni` | `sni`, `peer` | ✅ Senza di esso, Potatso usa l'indirizzo del server. |
| Salta verifica certificato | `skip-cert-verify` | `insecure` | ✅ |
| Pin del certificato (SHA-256) | `fingerprint` | `pinSHA256` | ✅ |
| ALPN | `alpn` | `alpn` | ✅ Solo `h3`, che Potatso usa sempre |
| Certificato CA personalizzato | `ca` nel client ufficiale | | ❌ |
| Certificato client TLS | `certificate`, `private-key` | | ❌ |
| Encrypted Client Hello (ECH) | `ech-opts` | `ech` | ❌ |
| Verifica rispetto a un altro nome | `name-cert-verify` | | ❌ |

Disattivare la verifica del certificato permette a chiunque si trovi tra te e il server di leggere il tuo traffico. Molti server Hysteria 2 usano un certificato autofirmato: fissalo invece. Imposta lo SHA-256 del certificato del server come pin del certificato. Con un pin, Potatso si fida di quel certificato e di nessun altro, qualunque sia il suo nome.

Potatso non importa un server che richiede una delle impostazioni non supportate qui sopra, perché si connetterebbe senza di essa e il server non risponderebbe.

## UDP {#udp}

Hysteria 2 trasporta UDP in datagrammi QUIC, sulla stessa connessione di TCP. UDP è attivo per impostazione predefinita. Disattiva Relay UDP nelle impostazioni del server solo se il tuo server ha UDP disattivato (`disableUDP`).

Tramite un server Xray, i pacchetti UDP più grandi di circa 1.100 byte arrivano danneggiati. È un bug del server Hysteria 2 di Xray. Il server ufficiale, sing-box e mihomo inoltrano pacchetti di ogni dimensione.

## Funzioni supportate {#features}

| Funzione | Supportata |
| --- | --- |
| [Protocollo Hysteria 2](https://v2.hysteria.network/docs/developers/Protocol/): autenticazione HTTP/3, flussi TCP | ✅ |
| UDP in datagrammi QUIC, compresi i pacchetti grandi divisi in frammenti | ✅ |
| Molte connessioni in un'unica connessione QUIC | ✅ |
| Offuscamento Salamander | ✅ |
| Offuscamento Gecko | ❌ |
| [Banda in download](#bandwidth) (Brutal sul server) | ✅ |
| Banda in upload (Brutal dal tuo dispositivo) | ❌ |
| [Salto di porta](#port-hopping) | ✅ |
| Fast open (un round trip in meno per connessione) | ✅ Sempre attivo |
| Pin del certificato, salta verifica certificato | ✅ |
| ECH, CA personalizzata, certificati client TLS | ❌ |
| Realm (connessione tramite un server di rendez-vous) | ❌ |
| Fake TCP (`mimic`) | ❌ |
| Finestre di controllo di flusso QUIC personalizzate, `cwnd`, `udp-mtu` | ❌ |
| Link `hysteria2://` e `hy2://` | ✅ |

Ogni funzione supportata è testata con almeno un server Hysteria 2 reale: il [server ufficiale](https://v2.hysteria.network/), [sing-box](https://sing-box.sagernet.org/), [mihomo](https://wiki.metacubex.one/) o [Xray](https://xtls.github.io/).

Alcune funzioni del client Hysteria ufficiale sono impostazioni del suo programma, e Potatso svolge lo stesso compito a modo suo:

- Instradamento e ACL: usa le regole del tuo profilo.
- Server SOCKS5 e HTTP locali, inoltro e modalità TUN: Potatso cattura da sé il traffico del tuo dispositivo.
- Connessione differita: Potatso si connette quando il traffico ha bisogno del server.

Le impostazioni lato server, come il sito web masquerade, il test di velocità o i limiti di banda del server, non richiedono nulla sul tuo dispositivo.

## Link `hysteria2://` {#links}

Un link `hysteria2://` contiene un intero server in una riga. `hy2://` è lo stesso link con un nome più corto.

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

| Parte | Descrizione |
| --- | --- |
| `password` | La password, con percent-encoding. Per un nome utente e una password, scrivi `name:password`. |
| `host` | Indirizzo del server. Metti un indirizzo IPv6 tra parentesi quadre, come `[2001:db8::1]`. |
| `port` | Porta del server. Se manca, Potatso usa 443. Per il [salto di porta](#port-hopping), elenca qui le porte, come `443,20000-30000`. |
| `name` | Facoltativo. Il nome del server in Potatso. |

I parametri seguono il [formato ufficiale](https://v2.hysteria.network/docs/developers/URI-Scheme/):

| Parametro | Descrizione |
| --- | --- |
| `sni` | Il nome del server TLS. |
| `insecure` | `1` disattiva la verifica del certificato. |
| `pinSHA256` | Lo SHA-256 del certificato del server. |
| `obfs`, `obfs-password` | `salamander` e la sua password. |
| `mport` | Le porte del salto di porta, come le scrivono alcune app invece che nella porta. |
| `hop-interval` | L'intervallo di salto in secondi. |
| `up`, `down` | La banda in upload e in download, come le scrivono alcune app. |

Potatso non importa un link con `obfs=gecko` o `ech`. Non importa nemmeno i link `hysteria2+realm://`.

Quando Potatso condivide un server Hysteria 2, offre un link `hysteria2://`, con le porte di salto nella porta oppure come `mport`.

### Esempi {#link-examples}

Ogni esempio mostra il link da importare. La password è `secret`.

Un server semplice:

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

Offuscamento Salamander con la password `hidden`:

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

Salto di porta tra 20000 e 30000:

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

Un certificato autofirmato, fissato:

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

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