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://, 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
| 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
| 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
| 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
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
| 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
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
| Recurso | Suportado |
|---|---|
| Protocolo Hysteria 2: 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 (Brutal no servidor) | ✅ |
| Largura de banda de upload (Brutal a partir do seu dispositivo) | ❌ |
| Salto de portas | ✅ |
| 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, o sing-box, o mihomo ou o Xray.
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://
Um link hysteria2:// guarda um servidor inteiro em uma linha. hy2:// é o mesmo link com um nome mais curto.
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, liste as portas aqui, como 443,20000-30000. |
name |
Opcional. O nome do servidor no Potatso. |
Os parâmetros seguem o formato oficial:
| 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
Cada exemplo mostra o link a importar. A senha é secret.
Um servidor básico:
hysteria2://secret@hy2.example.com:443/?sni=hy2.example.com#BasicOfuscação Salamander com a senha hidden:
hysteria2://secret@hy2.example.com:443/?obfs=salamander&obfs-password=hidden#SalamanderSalto de portas entre 20000 e 30000:
hysteria2://secret@hy2.example.com:443,20000-30000/?sni=hy2.example.com#HoppingUm certificado autoassinado, fixado:
hysteria2://secret@203.0.113.7:443/?sni=hy2.example.com&pinSHA256=abababababababababababababababababababababababababababababababab#Pinned