---
title: "Hysteria 2"
description: "As opções, ajustes de TLS, links e recursos do Hysteria 2 que o Potatso suporta."
---

> 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

Um servidor Hysteria 2 é descrito por uma **senha** e pelos seus **ajustes de TLS** e, opcionalmente, por **ofuscação** e **salto de portas**. O Hysteria 2 roda sobre QUIC, o protocolo baseado em UDP por trás do HTTP/3, e por isso mantém a velocidade em redes que perdem pacotes. O Potatso conecta a um servidor quando suporta os ajustes dele. Use as tabelas abaixo para conferir os ajustes do seu servidor, como mostrados pelo seu provedor ou no link `hysteria2://` dele.

Você pode adicionar um servidor Hysteria 2 à mão, com um [link `hysteria2://` ou `hy2://`](#links), ou importando:

- uma assinatura Clash ou Mihomo,
- uma configuração do Xray,
- uma configuração do Surge.

O Potatso ainda não importa servidores Hysteria 2 de uma configuração do sing-box. Use o link `hysteria2://` do servidor.

## Autenticação {#authentication}

| Autenticação do servidor | Suportada |
| --- | --- |
| Uma senha (`auth.type: password`) | ✅ |
| Um nome de usuário e senha (`auth.type: userpass`) | ✅ Digite-os como uma só senha: `name:password` |
| Um autenticador HTTP ou de comando | ✅ Digite a senha que ele espera |

Uma senha errada não conecta. Muitos servidores mostram um site comum (o disfarce deles) para quem não tem a senha.

## Ofuscação {#obfuscation}

| Ofuscação | Chave do Clash | Parâmetro do link | Suportada |
| --- | --- | --- | --- |
| Nenhuma | | | ✅ |
| Salamander | `obfs: salamander`, `obfs-password` | `obfs=salamander`, `obfs-password` | ✅ |
| Gecko | `obfs: gecko` | `obfs=gecko` | ❌ |

O Salamander embaralha cada pacote para que a conexão não pareça QUIC. A senha precisa ser igual à do servidor. Defina-a como **Senha do Salamander** nos ajustes do servidor. Deixe vazio para um servidor sem ofuscação.

O Potatso não importa um servidor que use a ofuscação Gecko, pois não conseguiria conectar a ele.

## Largura de banda {#bandwidth}

| Ajuste | Chave do Clash | Suportado |
| --- | --- | --- |
| Largura de banda de download | `down` | ✅ O servidor envia a você nessa taxa |
| Largura de banda de upload | `up` | ❌ O Potatso envia com o controle de congestionamento BBR e ignora este ajuste |
| Controle de congestionamento | `congestion` no cliente oficial | ❌ Sempre BBR |

Quando você define uma **largura de banda de download**, como `100 Mbps`, o servidor envia nessa taxa mesmo quando há perda de pacotes, usando o controle de congestionamento Brutal do Hysteria. Defina-a perto da sua velocidade de download real: alta demais, e a conexão fica mais lenta, não mais rápida. Deixe vazio e o servidor adapta a taxa por conta própria.

A largura de banda aceita um número com uma unidade (`bps`, `Kbps`, `Mbps`, `Gbps`) ou um número simples em Mbps.

## Salto de portas {#port-hopping}

Um servidor com salto de portas escuta em um intervalo de portas UDP, e o Potatso se move entre elas de tempos em tempos. Isso ajuda em redes que desaceleram ou bloqueiam uma porta UDP depois de um tempo.

| Ajuste | Chave do Clash | Suportado |
| --- | --- | --- |
| Portas | `ports` | ✅ Um intervalo como `20000-30000`, uma lista como `443,8443`, ou ambos |
| Intervalo de salto | `hop-interval` | ✅ Em segundos, 30 por padrão e no mínimo 5. Um intervalo como `10-30` escolhe um intervalo aleatório. |

Defina-os como **Salto de portas** e **Intervalo de salto** nos ajustes do servidor. A porta do servidor é então usada apenas para a primeira conexão.

## TLS {#tls}

| Ajuste | Chave do Clash | Parâmetro do link | Suportado |
| --- | --- | --- | --- |
| Nome do servidor (SNI) | `sni` | `sni`, `peer` | ✅ Sem um, o Potatso usa o endereço do servidor. |
| Ignorar a verificação de certificado | `skip-cert-verify` | `insecure` | ✅ |
| Fixação de certificado (SHA-256) | `fingerprint` | `pinSHA256` | ✅ |
| ALPN | `alpn` | `alpn` | ✅ Somente `h3`, que o Potatso sempre usa |
| Certificado CA personalizado | `ca` no cliente oficial | | ❌ |
| Certificado de cliente TLS | `certificate`, `private-key` | | ❌ |
| Encrypted Client Hello (ECH) | `ech-opts` | `ech` | ❌ |
| Verificar com outro nome | `name-cert-verify` | | ❌ |

Desativar a verificação de certificado permite que qualquer pessoa entre você e o servidor leia o seu tráfego. Muitos servidores Hysteria 2 usam um certificado autoassinado: fixe-o em vez disso. Defina o SHA-256 do certificado do servidor como a fixação de certificado. Com uma fixação, o Potatso confia nesse certificado e em nenhum outro, seja qual for o nome dele.

O Potatso não importa um servidor que precise de um dos ajustes não suportados acima, pois conectaria sem ele e o servidor não responderia.

## UDP {#udp}

O Hysteria 2 transporta UDP em datagramas QUIC, pela mesma conexão do TCP. O UDP vem ativado por padrão. Desative o Relay UDP nos ajustes do servidor somente se o seu servidor tem o UDP desativado (`disableUDP`).

Por um servidor Xray, os pacotes UDP maiores que cerca de 1.100 bytes chegam danificados. É um bug do servidor Hysteria 2 do Xray. O servidor oficial, o sing-box e o mihomo repassam todos os tamanhos.

## Suporte a recursos {#features}

| Recurso | Suportado |
| --- | --- |
| [Protocolo Hysteria 2](https://v2.hysteria.network/docs/developers/Protocol/): autenticação HTTP/3, fluxos TCP | ✅ |
| UDP em datagramas QUIC, incluindo pacotes grandes divididos em fragmentos | ✅ |
| Muitas conexões em uma única conexão QUIC | ✅ |
| Ofuscação Salamander | ✅ |
| Ofuscação Gecko | ❌ |
| [Largura de banda de download](#bandwidth) (Brutal no servidor) | ✅ |
| Largura de banda de upload (Brutal a partir do seu dispositivo) | ❌ |
| [Salto de portas](#port-hopping) | ✅ |
| Fast open (uma ida e volta a menos por conexão) | ✅ Sempre ativado |
| Fixação de certificado, ignorar verificação de certificado | ✅ |
| ECH, CA personalizada, certificados de cliente TLS | ❌ |
| Realms (conectar por um servidor de encontro) | ❌ |
| Fake TCP (`mimic`) | ❌ |
| Janelas de controle de fluxo QUIC personalizadas, `cwnd`, `udp-mtu` | ❌ |
| Links `hysteria2://` e `hy2://` | ✅ |

Todo recurso suportado é testado com pelo menos um servidor Hysteria 2 real: o [servidor oficial](https://v2.hysteria.network/), o [sing-box](https://sing-box.sagernet.org/), o [mihomo](https://wiki.metacubex.one/) ou o [Xray](https://xtls.github.io/).

Alguns recursos do cliente oficial do Hysteria são ajustes do próprio programa dele, e o Potatso faz o mesmo trabalho à sua maneira:

- Roteamento e ACLs: use as regras do seu perfil.
- Servidores locais SOCKS5 e HTTP, encaminhamento e modo TUN: o Potatso captura o tráfego do seu dispositivo por conta própria.
- Conexão preguiçosa (lazy): o Potatso conecta quando o tráfego precisa do servidor.

Os ajustes do lado do servidor, como o site de disfarce, o teste de velocidade ou os limites de largura de banda do próprio servidor, não exigem nada no seu dispositivo.

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

Um link `hysteria2://` guarda um servidor inteiro em uma linha. `hy2://` é o mesmo link com um nome mais curto.

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

| Parte | Descrição |
| --- | --- |
| `password` | A senha, com percent-encoding. Para nome de usuário e senha, escreva `name:password`. |
| `host` | Endereço do servidor. Coloque um endereço IPv6 entre colchetes, como `[2001:db8::1]`. |
| `port` | Porta do servidor. Quando falta, o Potatso usa 443. Para [salto de portas](#port-hopping), liste as portas aqui, como `443,20000-30000`. |
| `name` | Opcional. O nome do servidor no Potatso. |

Os parâmetros seguem o [formato oficial](https://v2.hysteria.network/docs/developers/URI-Scheme/):

| Parâmetro | Descrição |
| --- | --- |
| `sni` | O nome do servidor TLS. |
| `insecure` | `1` desativa a verificação de certificado. |
| `pinSHA256` | O SHA-256 do certificado do servidor. |
| `obfs`, `obfs-password` | `salamander` e a senha dele. |
| `mport` | As portas do salto de portas, como alguns apps as escrevem em vez de na porta. |
| `hop-interval` | O intervalo de salto em segundos. |
| `up`, `down` | A largura de banda de upload e de download, como alguns apps as escrevem. |

O Potatso não importa um link com `obfs=gecko` ou `ech`. Também não importa links `hysteria2+realm://`.

Ao compartilhar um servidor Hysteria 2, o Potatso oferece um link `hysteria2://`, com as portas de salto na porta ou como `mport`.

### Exemplos {#link-examples}

Cada exemplo mostra o link a importar. A senha é `secret`.

Um servidor básico:

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

Ofuscação Salamander com a senha `hidden`:

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

Salto de portas entre 20000 e 30000:

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

Um certificado autoassinado, fixado:

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

Source: https://potatso.com/docs/pt-br/protocols/hysteria2/index.mdx