---
title: "HTTP e HTTPS"
description: "As opções, links e recursos de proxy HTTP e HTTPS 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.

# HTTP e HTTPS

Um proxy HTTP é um servidor que abre conexões por você quando recebe uma requisição HTTP `CONNECT`. Um proxy **HTTPS** é o mesmo servidor acessado por TLS, de modo que a conexão com o proxy também é criptografada. O Potatso conecta a ambos, com ou sem nome de usuário e senha.

Um proxy HTTP só transporta TCP. Veja [UDP](#udp) para saber o que acontece com o resto do seu tráfego.

Você pode adicionar um proxy HTTP ou HTTPS à mão, com um [link `http://` ou `https://`](#links), ou importando:

- uma assinatura Clash ou Mihomo (`type: http`),
- uma configuração do Surge (`http` e `https`),
- uma configuração do Xray ou do V2Ray (saída `http`).

Para adicionar um proxy HTTPS à mão, escolha **HTTP** e ative **TLS**.

## Ajustes {#settings}

| Ajuste | Descrição |
| --- | --- |
| Servidor, porta | O endereço e a porta do proxy. Um endereço IPv6 também funciona. |
| Nome de usuário, senha | Opcionais. Enviados com autenticação Basic. |
| TLS | Ativado para um proxy HTTPS. |
| Nome do servidor | Somente HTTPS, opcional. O nome enviado no handshake TLS e verificado com o certificado. Deixe vazio para usar o endereço do servidor. |
| Ignorar verificação de certificado | Somente HTTPS. Aceita qualquer certificado. Use somente para testes. |
| Fixação de certificado | Somente HTTPS, opcional. A impressão digital SHA-256 do certificado do proxy, como 64 dígitos hexadecimais. Com uma fixação, o Potatso aceita o certificado fixado, inclusive um autoassinado, e nenhum outro. |

A senha pode conter qualquer caractere, inclusive `:` e letras não ASCII. O nome de usuário não pode conter `:`.

### Cabeçalhos personalizados {#headers}

Uma configuração Clash, Mihomo ou Xray pode adicionar cabeçalhos à requisição `CONNECT`, como um `User-Agent` que o seu provedor pede. O Potatso os mantém quando importa o proxy e os envia em todas as conexões. Um cabeçalho `Host` substitui o que o Potatso envia. Você não pode adicionar nem editar cabeçalhos no app.

### Certificados {#certificates}

Um proxy HTTPS precisa de um certificado em que o seu dispositivo confie, a menos que você defina uma [fixação de certificado](#settings) ou ative **Ignorar verificação de certificado**.

O Potatso não suporta:

- um certificado CA personalizado para um proxy HTTPS: fixe o certificado do proxy em vez disso,
- um certificado de cliente TLS (`certificate` e `private-key` do Clash): o Potatso não importa um proxy que precise de um,
- uma lista de ALPN: o Potatso sempre fala HTTP/1.1 com o proxy.

## UDP {#udp}

Os proxies HTTP só transportam TCP, então o Potatso nunca envia UDP a um. O UDP é usado por QUIC, chamadas de voz e vídeo e muitos jogos.

- Com regras, o Potatso ignora uma regra que envia UDP a um proxy HTTP ou HTTPS, e a próxima regra que corresponder decide. O UDP que nenhuma outra regra alcança é enviado direto.
- No modo Global, o UDP não funciona, porque todo o tráfego precisa passar pelo proxy.

Para enviar UDP por um proxy também, use um servidor cujo protocolo transporte UDP, como SOCKS5 ou Shadowsocks.

## Suporte a recursos {#features}

| Recurso | Suportado |
| --- | --- |
| Túneis `CONNECT` ([RFC 9110 §9.3.6](https://www.rfc-editor.org/rfc/rfc9110#section-9.3.6)) para destinos IPv4, IPv6 e de domínio | ✅ |
| Autenticação Basic ([RFC 7617](https://www.rfc-editor.org/rfc/rfc7617)), senhas UTF-8 | ✅ |
| Autenticação Digest ([RFC 7616](https://www.rfc-editor.org/rfc/rfc7616)) | ❌ |
| Proxies HTTPS (HTTP sobre TLS) | ✅ Com nome do servidor, fixação de certificado e ignorar verificação de certificado |
| Cabeçalhos `CONNECT` personalizados | ✅ A partir de importações |
| Endereço de proxy IPv6 | ✅ |
| `CONNECT` HTTP/2 ([RFC 9113 §8.5](https://www.rfc-editor.org/rfc/rfc9113#section-8.5)) | ❌ |
| `CONNECT` HTTP/3 ([RFC 9114 §4.4](https://www.rfc-editor.org/rfc/rfc9114#section-4.4)) | ❌ |
| UDP pelo proxy (`CONNECT-UDP`, [RFC 9298](https://www.rfc-editor.org/rfc/rfc9298)) | ❌ |
| Encaminhamento HTTP simples sem `CONNECT` (requisições em forma absoluta) | ❌ O Potatso usa `CONNECT` em todas as conexões |
| Certificados de cliente TLS, CA personalizada, ALPN | ❌ |

Todo recurso suportado é testado com servidores proxy reais: [tinyproxy](https://tinyproxy.github.io/), [sing-box](https://sing-box.sagernet.org/), [Xray](https://xtls.github.io/) e [Mihomo](https://wiki.metacubex.one/).

Use a porta `CONNECT` do servidor, não uma porta web que só encaminha requisições web simples. Alguns proxies só permitem `CONNECT` para a porta 443. Se apenas alguns sites funcionam pelo seu proxy, pergunte ao seu provedor se ele limita as portas `CONNECT`.

## Links {#links}

Um link `http://` ou `https://` guarda um proxy inteiro em uma linha:

```text
http://user:password@host:port#name
https://user:password@host:port?sni=…&insecure=1#name
```

| Parte | Descrição |
| --- | --- |
| `user:password` | Opcional. Aplique percent-encoding a `:`, `@` e outros caracteres especiais da senha, por exemplo `p%3Ass` para `p:ss`. |
| `host` | Endereço do proxy. Coloque um endereço IPv6 entre colchetes, como `[2001:db8::1]`. |
| `port` | Porta do proxy. |
| `sni` | Somente HTTPS, opcional. O [nome do servidor](#settings). O Potatso também lê `peer` e `servername`. |
| `insecure` | Somente HTTPS, opcional. `1` ativa Ignorar verificação de certificado. O Potatso também lê `allowInsecure` e `skip-cert-verify`. |
| `name` | Opcional. O nome do proxy no Potatso. |

Um link não pode guardar uma fixação de certificado nem cabeçalhos personalizados. O Potatso também importa a forma mais antiga, em que tudo entre `://` e `#` é codificado em Base64:

```text
http://base64(user:password@host:port)#name
```

### Exemplos {#link-examples}

Um proxy sem senha:

```text
http://proxy.example.com:8080#Open
```

Um proxy com o nome de usuário `alice` e a senha `s3cret`:

```text
http://alice:s3cret@proxy.example.com:8080#Basic
```

A senha `p:ss wörd`, com percent-encoding:

```text
http://alice:p%3Ass%20w%C3%B6rd@proxy.example.com:8080#Encoded
```

Um proxy HTTPS:

```text
https://alice:s3cret@proxy.example.com:443#TLS
```

Um proxy HTTPS acessado pelo endereço IP, com o nome de certificado `proxy.example.com`:

```text
https://alice:s3cret@203.0.113.10:443?sni=proxy.example.com#SNI
```

Um proxy HTTPS com certificado autoassinado:

```text
https://proxy.example.com:443?insecure=1#Self-signed
```

Um proxy com endereço IPv6:

```text
http://[2001:db8::1]:8080#IPv6
```

A forma mais antiga do proxy básico:

```text
http://YWxpY2U6czNjcmV0QHByb3h5LmV4YW1wbGUuY29tOjgwODA#Legacy
```

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