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://, 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
| 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
| 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
| 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
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
| 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
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
| Funzione | Supportata |
|---|---|
| Protocollo Hysteria 2: 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 (Brutal sul server) | ✅ |
| Banda in upload (Brutal dal tuo dispositivo) | ❌ |
| Salto di porta | ✅ |
| 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, sing-box, mihomo o Xray.
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://
Un link hysteria2:// contiene un intero server in una riga. hy2:// è lo stesso link con un nome più corto.
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, elenca qui le porte, come 443,20000-30000. |
name |
Facoltativo. Il nome del server in Potatso. |
I parametri seguono il formato ufficiale:
| 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
Ogni esempio mostra il link da importare. La password è secret.
Un server semplice:
hysteria2://secret@hy2.example.com:443/?sni=hy2.example.com#BasicOffuscamento Salamander con la password hidden:
hysteria2://secret@hy2.example.com:443/?obfs=salamander&obfs-password=hidden#SalamanderSalto di porta tra 20000 e 30000:
hysteria2://secret@hy2.example.com:443,20000-30000/?sni=hy2.example.com#HoppingUn certificato autofirmato, fissato:
hysteria2://secret@203.0.113.7:443/?sni=hy2.example.com&pinSHA256=abababababababababababababababababababababababababababababababab#Pinned