Introdução: por que entender o que exatamente vai na requisição

Quando você digita o endereço de um site e aperta Enter, parece que uma única linha vai para a rede — a URL. Na verdade, naquele momento acontecem vários eventos diferentes em camadas diferentes. Primeiro, o nome do site se transforma em um endereço IP numérico. Depois, abre-se uma conexão TCP para esse endereço. Em seguida, dentro da conexão começa o handshake TLS e, na primeira mensagem dele, o nome do servidor é enviado em texto aberto — esse é o campo SNI. E só depois disso, já dentro do canal criptografado, vai a requisição HTTP com o cabeçalho Host.

Este guia é dedicado justamente ao nível de transporte. Não vamos analisar cabeçalhos de aplicação como Via e X-Forwarded-For — há um material separado dedicado a eles, e funcionam de maneira bem diferente: são adicionados por nós intermediários já dentro do HTTP. Aqui falamos do que o cliente envia por conta própria, antes mesmo de um único byte de HTTP sair da máquina dele: da diferença entre conectar por literal de IP e por nome de host, e também de onde o nome do servidor entra no TLS.

O que você vai obter no final

  • Vai entender como o literal de IP difere do hostname e por que isso afeta o resultado da conexão.
  • Vai ver com seus próprios olhos o campo SNI no ClientHello através de curl, openssl e Wireshark.
  • Vai aprender a conectar ao servidor certo pelo endereço, mantendo o nome correto — isso será útil na depuração e configuração.
  • Vai entender o que exatamente o servidor proxy vê no túnel CONNECT e o que permanece só entre você e o site de destino.
  • Vai receber um checklist para diagnosticar por conta própria erros do tipo "certificado não corresponde" e "servidor entrega o site errado".

Para quem é este guia

Para quem configura proxies e servidores, trabalha com automação e scraping, depura o funcionamento de aplicações ou simplesmente quer entender o que acontece "por baixo do capô" do navegador. O nível é intermediário: vamos explicar os conceitos básicos, mas partimos do princípio de que você não tem medo da linha de comando.

O que você precisa saber de antemão

  • Como abrir o terminal (PowerShell no Windows, Terminal no macOS ou qualquer emulador de terminal no Linux).
  • O que é uma URL e do que ela é composta — pelo menos em nível básico.
  • Que um site fica em um servidor, e que o servidor tem um endereço.

Quanto tempo vai levar

Instalação das ferramentas — 10-15 minutos. Passar por todos os sete passos — 45-60 minutos. No total, de uma hora a uma hora e meia, se você for repetindo cada comando com atenção. O Wireshark pode ser deixado de lado e retomado depois — nesse caso, você termina em 40 minutos.

Preparação inicial: ferramentas e ambiente

Vamos precisar de um pequeno conjunto de utilitários de console. A boa notícia: a maioria já está no seu sistema.

Requisitos de sistema

  • Windows 10 ou 11, macOS 12 ou mais recente, ou qualquer Linux moderno (Ubuntu 22.04+, Debian 12+, Fedora).
  • Acesso à internet sem restrições em conexões de saída para as portas 80 e 443.
  • Privilégios de administrador — necessários apenas para instalar o Wireshark e editar o arquivo hosts.

O que instalar ou verificar

  1. curl. No Windows 10 e 11 ele já vem embutido, no macOS também, e no Linux geralmente está instalado. Abra o terminal e digite curl --version. Você deve ver uma linha como curl 8.x.x e uma lista de protocolos suportados. Se aparecer "comando não encontrado", no Ubuntu execute sudo apt install curl.
  2. openssl. No macOS e Linux já vem por padrão: verifique com openssl version. No Windows ele não vem de fábrica — o mais simples é instalar o Git for Windows: após a instalação, na pasta C:\Program Files\Git\usr\bin estará o openssl.exe. Alternativa — usar o WSL (subsistema Linux para Windows).
  3. nslookup ou dig. O nslookup existe em todo lugar, incluindo Windows. O dig é mais prático e vem no pacote dnsutils (Ubuntu: sudo apt install dnsutils); no macOS já está instalado.
  4. Wireshark (opcional, para o Passo 6). Baixe o instalador no site oficial do projeto; na instalação no Windows, aceite instalar o driver de captura Npcap — sem ele o programa não enxerga o tráfego.
  5. Acesso a qualquer proxy (opcional, para o Passo 7). Serve qualquer proxy HTTP ou SOCKS5 para o qual você tenha login e senha, por exemplo um proxy móvel do seu painel de usuário.

Backups

O único arquivo de sistema que vamos mexer é o hosts. Antes de editar, faça uma cópia sem falta. No Windows, ele fica em C:\Windows\System32\drivers\etc\hosts; no macOS e Linux, em /etc/hosts. Basta fazer uma cópia com o nome hosts.bak ao lado.

Dica: crie uma pasta separada para este laboratório e salve ali a saída de cada comando em um arquivo de texto. Daqui a uma semana você vai esquecer os detalhes, e comparar a saída antiga com a nova costuma ser muito útil na hora de diagnosticar.

Conceitos básicos em palavras simples

Antes de sair digitando comandos, vamos combinar os termos. São poucos, mas sem eles o resto vira confusão.

Endereço IP e literal de IP

Endereço IP é o endereço numérico de um nó de rede. O IPv4 parece quatro números separados por pontos: 93.184.216.34. O IPv6 são grupos hexadecimais separados por dois-pontos: 2606:2800:220:1:248:1893:25c8:1946. Literal de IP é quando você escreve o endereço direto na URL em vez do nome: https://93.184.216.34/. Para IPv6, o endereço na URL é colocado entre colchetes: https://[2606:2800:220:1:248:1893:25c8:1946]/. A palavra "literal" aqui significa "escrito exatamente como está".

Hostname (nome do host)

Hostname é um nome legível para humanos, como example.com ou api.example.com. Por si só, o nome não endereça nada: a rede não o entende. Para estabelecer uma conexão, o nome precisa primeiro ser transformado em endereço IP. Disso cuida o DNS — um serviço distribuído de nomes. Um hostname pode apontar para vários endereços, e um endereço pode atender centenas de nomes. É justamente dessa assimetria que surgem todas as complicações que vamos analisar.

Conexão TCP

Quando o endereço IP é conhecido, seu sistema abre uma conexão TCP para esse endereço e porta (443 para HTTPS, 80 para HTTP). Nesse nível já não existe nome de host — só números. O servidor que aceita a conexão sabe apenas que alguém chegou ao seu endereço e porta. Qual dos cem sites você quer, ele ainda não sabe.

TLS e ClientHello

TLS é o protocolo de criptografia, o S de HTTPS. A primeira mensagem que o cliente envia ao servidor se chama ClientHello. Ela vai em texto aberto, porque as chaves de criptografia ainda não foram combinadas. No ClientHello estão listadas as versões de protocolo suportadas, os conjuntos de cifras e as extensões. Uma dessas extensões é o SNI.

SNI — Server Name Indication

SNI significa literalmente "indicação do nome do servidor". É uma extensão do TLS em que o cliente avisa: "quero falar com o site example.com". Por que isso é necessário? Porque um mesmo endereço IP pode hospedar dezenas de sites com certificados diferentes. Sem o SNI, o servidor não sabe qual certificado apresentar. Importante: por padrão, o SNI só pode carregar um nome de host, nunca um endereço IP. Por isso, ao conectar por literal de IP, o campo SNI simplesmente não existe. Esse é o fato-chave de todo o guia.

Cabeçalho Host e pseudo-cabeçalho :authority

Depois que o canal TLS é estabelecido, dentro dele vai a requisição HTTP. No HTTP/1.1, o nome do site é repetido no cabeçalho Host; no HTTP/2 e HTTP/3, no pseudo-cabeçalho :authority. Esse já é o nível de aplicação, e de fora esse campo não é visível — fica criptografado. Mas o servidor o compara com o SNI, e se eles divergirem, pode responder com erro.

Certificado e SAN

O servidor, em resposta ao ClientHello, entrega o certificado. Nele há uma lista de nomes para os quais ele foi emitido — o campo Subject Alternative Name (SAN). O cliente compara o nome da URL com essa lista. Se você conectou por literal de IP, o cliente procura no SAN justamente o endereço IP, e esses certificados são raríssimos. Daí vem o erro típico "o certificado não corresponde ao nome".

Em que isso difere de Via e X-Forwarded-For

Os cabeçalhos Via e X-Forwarded-For são de aplicação. Não são enviados pelo seu cliente: são inseridos por proxies e balanceadores já dentro do HTTP, para informar ao servidor final por quem a requisição passou. Tudo o que analisamos aqui — o endereço IP de destino, o hostname no CONNECT e o SNI no ClientHello — é enviado pelo próprio cliente, e isso acontece antes e fora do HTTP. Guarde essa fronteira na cabeça: nível de transporte — aqui; cabeçalhos de aplicação — lá.

Passo 1: Analisando a URL e identificando se temos um nome ou um endereço

Objetivo da etapa: aprender a distinguir em segundos um literal de IP de um hostname e prever se o cliente vai enviar SNI.

  1. Pegue qualquer URL, por exemplo https://api.example.com:8443/v1/status?debug=1.
  2. Localize o esquema — a parte antes de ://. Aqui é https. O esquema determina a porta padrão (443) e se vai haver TLS.
  3. Localize o authority — a parte entre :// e a próxima barra: api.example.com:8443. É o host mais uma porta opcional.
  4. Separe a porta. Se depois dos dois-pontos houver apenas dígitos e houver só um par de dois-pontos, é a porta (8443). Todo o resto é o host.
  5. Olhe para o host. Se ele for composto apenas por dígitos e três pontos, é um literal IPv4. Se estiver entre colchetes, é um literal IPv6. Em todos os outros casos, é um hostname.
  6. Tire a conclusão: para um hostname, o cliente vai fazer consulta DNS e enviar SNI. Para um literal de IP, o DNS não é necessário e o SNI não será enviado.

Analise três exemplos por conta própria como treino: https://10.0.0.5/admin (literal IPv4, sem SNI), https://[2001:db8::1]:8443/ (literal IPv6, porta 8443, sem SNI), http://cdn.example.net/img.png (hostname, mas o esquema é http — não há TLS, portanto também não há SNI; o nome irá apenas no cabeçalho Host, em texto aberto).

Atenção: uma armadilha comum é uma string como https://192.168.1.10.nip.io/. Ela parece um endereço, mas é um hostname: contém letras. Esse nome será resolvido via DNS e irá para o SNI. Sempre verifique se o host é composto apenas por dígitos e pontos.

Verificação: para qualquer URL, você consegue nomear o esquema, o host, a porta e o tipo do host (literal ou nome), e também dizer se o campo SNI será enviado. Se tiver dúvida, volte ao item 5.

Possíveis problemas

A URL tem usuário e senha antes do sinal @. Por exemplo https://user:pass@host.com/. O host começa depois do @. As credenciais não pertencem ao nível de transporte.

Vários dois-pontos sem colchetes. Isso é uma URL inválida para IPv6 — o navegador não vai aceitar. Os colchetes são obrigatórios.

Passo 2: Vendo como o nome se transforma em endereço

Objetivo da etapa: ver a resolução DNS ao vivo e entender que nome e endereço são duas entidades independentes.

  1. Abra o terminal.
  2. Digite nslookup example.com e aperte Enter.
  3. Leia a saída. Nas primeiras linhas estará o endereço do seu servidor DNS (Server e Address). Abaixo, a seção de resposta: Name: example.com e uma ou mais linhas Address: com endereços IPv4 e IPv6.
  4. Anote um dos endereços IPv4 no seu arquivo de notas. Vai ser necessário no Passo 4.
  5. Se você tem o dig, execute dig +short example.com A — você obtém só os endereços, sem excesso. E o comando dig +short example.com AAAA mostrará os endereços IPv6.
  6. Agora faça o contrário: nslookup 93.184.216.34 (substitua pelo endereço do passo 4). Você vai receber ou um nome PTR, que pode não coincidir de forma alguma com example.com, ou uma mensagem de que o registro não foi encontrado.

O que isso prova? A resolução direta (nome em endereço) e a reversa (endereço em nome) são bancos de dados diferentes, e não precisam coincidir. O servidor que aceita a conexão em 93.184.216.34 não pode, pelo simples fato da conexão, saber qual nome você digitou. A única forma de informá-lo é via SNI e Host.

Dica: em grandes serviços, os endereços mudam de requisição para requisição e dependem da região. Não se surpreenda se, um minuto depois, o nslookup retornar outro conjunto. É justamente por isso que, nos testes, vamos fixar o endereço explicitamente.

Substituição local: o arquivo hosts

O sistema consulta o arquivo hosts antes de recorrer ao DNS. É uma forma prática de testar como o site se comporta se o nome apontar para outro endereço.

  1. Confirme que a cópia hosts.bak foi feita (veja a seção de preparação).
  2. Abra o hosts como administrador: no Windows, inicie o Bloco de Notas pelo botão direito e a opção "Executar como administrador"; depois Arquivo — Abrir, ative a exibição de todos os arquivos e selecione o hosts. No macOS e Linux: sudo nano /etc/hosts.
  3. Adicione no final a linha 127.0.0.1 test.local e salve.
  4. Execute ping test.local. As respostas devem vir de 127.0.0.1.
  5. Remova a linha adicionada quando terminar o experimento, ou restaure o hosts.bak no lugar.

Verificação: você obteve o endereço IP de example.com via nslookup ou dig e o anotou. Você entende que o hosts pode substituir o resultado do DNS localmente.

Possíveis problemas

nslookup retorna "DNS request timed out". Verifique a conexão com a internet e tente indicar um resolvedor público: nslookup example.com 8.8.8.8.

As alterações no hosts não surtem efeito. No Windows, execute ipconfig /flushdns. Os navegadores têm o próprio cache de DNS — reinicie o navegador.

Passo 3: Conectando por nome e capturando o SNI

Objetivo da etapa: ver que, ao conectar por hostname, o cliente envia SNI e recebe o certificado correto.

Variante A: curl com saída detalhada

  1. No terminal, execute curl -v https://example.com/ -o /dev/null. No Windows PowerShell, em vez de /dev/null escreva NUL, e chame o comando como curl.exe, para que o alias embutido do PowerShell não entre em ação.
  2. Na saída, encontre a linha sobre resolução de nome: em versões recentes do curl é * Host example.com:443 was resolved. e abaixo * IPv4: 93.184.216.34.
  3. Encontre a linha * Connected to example.com (93.184.216.34) port 443. É o momento em que a conexão TCP se estabelece. Repare: o curl mostra tanto o nome quanto o endereço — ele conhece os dois.
  4. Encontre o bloco do TLS: * SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384 e depois * Server certificate: com os campos subject e subjectAltName.
  5. A linha-chave: * subjectAltName: host "example.com" matched cert's "example.com". Isso significa: o nome da URL coincidiu com o nome do certificado. A verificação passou.
  6. Abaixo você verá a própria requisição: > GET / HTTP/2 e > Host: example.com (ou > :authority: example.com, dependendo da versão). Isso já é o nível de aplicação dentro do canal criptografado.

O curl não imprime o SNI em uma linha separada, mas aqui vale uma regra simples: o curl envia no SNI o nome que está na URL. Como na URL está example.com, no SNI foi example.com. Vamos confirmar isso com o openssl.

Variante B: openssl s_client

  1. Execute openssl s_client -connect example.com:443 -servername example.com < /dev/null. No Windows, substitua o redirecionamento de entrada por Ctrl+C depois que a saída aparecer.
  2. A flag -connect define onde abrir o TCP. A flag -servername define o que colocar no SNI. Agora elas coincidem.
  3. Na saída, encontre o bloco Certificate chain — lá haverá s:CN = example.com ou um nome parecido, além do emissor i:.
  4. Encontre a linha Verify return code: 0 (ok). Zero significa que a cadeia de confiança foi verificada com sucesso. Se você vir o código 20 ou 21, o openssl não tem o repositório de certificados-raiz do sistema; adicione a flag -CAfile com o caminho para o arquivo de certificados-raiz ou simplesmente ignore neste passo, pois o mais importante é o próprio nome no certificado.

Agora faça um experimento de controle: remova o SNI, mas mantenha o mesmo nome para a conexão.

  1. Execute openssl s_client -connect example.com:443 -noservername < /dev/null.
  2. Compare o certificado. Em alguns servidores ele continuará o mesmo — sinal de que naquele endereço há um único site ou um site padrão razoável configurado. Em outros, você vai obter um certificado completamente diferente ou um erro de handshake como alert handshake failure — é um servidor que se recusa a funcionar sem SNI.
  3. Tente o mesmo com um grande site atrás de CDN, por exemplo openssl s_client -connect www.cloudflare.com:443 -noservername < /dev/null. Muito provavelmente você verá uma recusa ou um certificado-isca.

Dica: adicione a flag -tlsextdebug: openssl s_client -connect example.com:443 -servername example.com -tlsextdebug < /dev/null. Ela mostra a lista de extensões TLS trocadas pelas partes. A extensão com o nome server name é justamente o SNI, confirmado pelo servidor que o recebeu.

Verificação: o curl mostrou a coincidência do nome com o certificado, o openssl com -servername retornou o certificado para example.com, e com -noservername o comportamento mudou em pelo menos um dos sites testados.

Possíveis problemas

o curl escreve "schannel: SEC_E_UNTRUSTED_ROOT". É a build do curl do Windows usando o repositório de certificados do sistema e faltando o certificado-raiz. Atualize o Windows ou use o curl do Git for Windows.

O openssl travou e não mostra nada. Ele está esperando entrada. Aperte Ctrl+C ou adicione o redirecionamento < /dev/null.

Passo 4: Conectando por literal de IP e vendo a diferença

Objetivo da etapa: confirmar que, ao conectar por endereço, o SNI não é enviado, o certificado não coincide e o servidor pode entregar o site errado.

  1. Pegue o endereço IP do Passo 2. Como exemplo, que seja 93.184.216.34.
  2. Execute curl -v https://93.184.216.34/ -o /dev/null.
  3. Repare: não há linhas sobre resolução DNS. O curl vai direto para * Trying 93.184.216.34:443... e * Connected to 93.184.216.34 (93.184.216.34) port 443. Não há nome — nos dois parênteses está o endereço.
  4. O handshake TLS provavelmente se completará, mas em seguida o curl dará um erro: * SSL: no alternative certificate subject name matches target host name "93.184.216.34" e curl: (60) SSL certificate problem. Isso é esperado: no SAN do certificado não há endereço IP.
  5. Repita com a verificação desativada: curl -vk https://93.184.216.34/ -o /dev/null. A flag -k faz o curl aceitar qualquer certificado. Fazemos isso apenas para observação.
  6. Agora olhe para a requisição: > Host: 93.184.216.34. O cliente honestamente passou no Host o que estava na URL — o endereço. E o SNI ele não enviou de forma alguma.
  7. Olhe para a resposta. As possibilidades: código 200 com o conteúdo do site padrão para aquele endereço; código 404 ou 421; código 400 ou 403 com um texto como "Direct IP access not allowed"; ou até o rompimento do handshake TLS antes do HTTP.

O que aconteceu aqui. Seu cliente chegou ao servidor certo — afinal, o endereço é o mesmo. Mas o servidor não recebeu nem SNI, nem um Host significativo, e portanto não conseguiu entender qual dos sites hospedados nele você quer. Ele ou entregou o primeiro que encontrou (o default), ou recusou. A conexão por endereço entrega os pacotes, mas não entrega a intenção.

O mesmo experimento no navegador

  1. Abra o navegador e digite na barra de endereços https://93.184.216.34/.
  2. Muito provavelmente você verá um aviso de conexão não segura com um código como NET::ERR_CERT_COMMON_NAME_INVALID. O navegador chegou à mesma conclusão que o curl: o nome no certificado não corresponde ao endereço.
  3. Clique no ícone do cadeado ou no texto "Não seguro" e abra as informações do certificado. No campo "Nome alternativo do assunto" você verá nomes de domínio, mas não o endereço IP.
  4. Não clique em "Continuar" em sites reais — isso não é necessário para o experimento, e é melhor não se acostumar com isso.

Atenção: a flag -k no curl e o botão "Continuar" no navegador desativam a verificação do certificado. Use-os apenas em testes para servidores que você controla. Ao trabalhar com serviços reais, especialmente com transmissão de senhas ou tokens, nunca desative a verificação — você perderá a garantia de que está falando com quem pretendia.

Verificação: sem -k, o curl falha com o erro 60 e menciona o endereço IP; com -k, na requisição aparece Host: endereço; o servidor responde de forma diferente da conexão por nome, ou com erro.

Possíveis problemas

O servidor responde por IP exatamente como por nome. Então nesse endereço há um único site, configurado como default. Não é um erro. Repita em um endereço de uma grande CDN para ver a diferença.

O curl terminou com o erro 35 (SSL connect error). O servidor interrompeu o handshake por falta de SNI. Isso também faz parte da resposta: sem nome, ele nem começa a conversa.

Passo 5: Controlando a combinação de nome e endereço com --resolve e --connect-to

Objetivo da etapa: aprender a conectar a um endereço específico mantendo o SNI e o Host corretos. Essa é a principal técnica de trabalho para depurar servidores, balanceadores e CDNs.

Flag --resolve: a mesma URL, outro endereço

  1. Execute curl -v --resolve example.com:443:93.184.216.34 https://example.com/ -o /dev/null.
  2. O formato da flag é: nome:porta:endereço. O curl vai substituir o endereço pelo que você indicou, ignorando a resposta DNS, mas apenas para esse par nome-porta.
  3. Na saída você verá * Added example.com:443:93.184.216.34 to DNS cache e depois * Connected to example.com (93.184.216.34) port 443.
  4. A verificação do certificado vai passar, porque o nome na URL continua example.com, o SNI foi enviado como example.com e o Host foi enviado como example.com. Só mudou o endereço para o qual o TCP foi aberto.
  5. Agora substitua por um endereço que comprovadamente não é o correto, por exemplo o endereço de outro site conhecido, obtido via nslookup. Execute o mesmo --resolve com esse endereço. Você vai ver ou um erro de certificado (o servidor alheio apresentou o certificado dele, que não corresponde a example.com) ou uma resposta 421 ou 404: o servidor recebeu o SNI example.com, mas não tem esse site.

Esse é exatamente o cenário usado na migração de um site para um servidor novo: o DNS ainda aponta para o endereço antigo, e você já testa o novo, sem mexer no DNS ou no hosts.

Flag --connect-to: conectar a um host completamente diferente

  1. Execute curl -v --connect-to example.com:443:backend.example.net:443 https://example.com/ -o /dev/null (substitua pelo nome real do servidor de destino, se você tiver um; para treino, pode indicar o próprio example.com).
  2. Formato: nome_original:porta:onde_conectar:porta. Diferente do --resolve, aqui você pode indicar não só um endereço, mas outro nome, e ele será resolvido via DNS.
  3. O SNI e o Host continuam sendo obtidos da URL, ou seja, seguem sendo example.com.

Separando o nome do SNI e o nome do TCP no openssl

  1. Execute openssl s_client -connect 93.184.216.34:443 -servername example.com < /dev/null.
  2. Aqui separamos explicitamente as duas coisas: o TCP vai para o endereço, e no SNI vai o nome. O servidor receberá o SNI e entregará o certificado correto.
  3. Agora troque -servername para um nome inexistente: -servername nosuchsite.example. Compare o certificado. Isso vai mostrar qual site o servidor entrega por padrão quando o SNI é desconhecido.

Dica: ao depurar um balanceador ou vários servidores atrás de um mesmo nome, escreva um pequeno loop que percorra a lista de endereços e, para cada um, execute --resolve. Assim, em um minuto, você vê qual nó entrega um certificado desatualizado ou uma configuração errada.

Dica: se precisar substituir o endereço não só em uma chamada do curl, mas para uma aplicação ou navegador inteiro, use o arquivo hosts do Passo 2. Mas não esqueça de remover os registros depois — uma linha esquecida no hosts pode atrapalhar você por semanas.

Verificação: o comando com --resolve e o endereço correto passa sem erro de certificado e retorna a mesma resposta da conexão normal por nome. O comando com um endereço alheio dá erro de certificado ou código 421.

Possíveis problemas

O curl ignora o --resolve. Verifique se a porta na flag coincide com a porta na URL. Para https é 443, para http é 80. A flag example.com:80:... não vai funcionar para uma requisição https.

Quero substituir o endereço para todas as portas. Indique --resolve example.com:*:93.184.216.34 — o asterisco significa qualquer porta (suportado em versões recentes do curl).

Passo 6: Capturando o ClientHello no Wireshark e encontrando o SNI no pacote

Objetivo da etapa: ver o SNI não pelos logs das ferramentas, mas nos bytes reais que saíram pelo fio. Depois desse passo, você não terá mais dúvidas de que o nome é transmitido em texto aberto.

  1. Inicie o Wireshark. Se o sistema pedir permissões, aceite; a captura de tráfego exige isso.
  2. Na tela inicial, escolha a interface de rede pela qual você acessa a internet. Normalmente é Wi-Fi ou Ethernet; ao lado da interface ativa corre um pequeno gráfico de atividade. Dê um duplo clique nela.
  3. A captura começa — na janela principal vão surgindo as linhas dos pacotes. Imediatamente insira no campo de filtro no topo (aquele com a dica "Apply a display filter") a expressão tls.handshake.type == 1 e aperte Enter. Isso deixa apenas os ClientHello.
  4. No terminal, execute curl -s https://example.com/ -o /dev/null. Em um segundo, no Wireshark aparecerá uma ou mais linhas com a descrição Client Hello na coluna Info.
  5. Clique na linha. No painel do meio, expanda a árvore: Transport Layer Security — TLSv1.3 Record Layer: Handshake Protocol: Client Hello — Handshake Protocol: Client Hello.
  6. Role até a lista de extensões e expanda Extension: server_name. Dentro estará Server Name Indication extension, e nela o campo Server Name: example.com.
  7. Clique no campo Server Name. No painel inferior com o dump hexadecimal, os bytes correspondentes ficarão destacados e, à direita, na coluna de texto, você lerá example.com em letras normais. É isso: a transmissão aberta do nome.
  8. Agora repita a captura com conexão por IP: curl -sk https://93.184.216.34/ -o /dev/null. Encontre o novo ClientHello e confirme que a extensão server_name não está nele de forma alguma.
  9. Pare a captura com o botão vermelho na barra de ferramentas.

Truque prático: exibir o SNI em uma coluna separada

  1. Clique com o botão direito no campo Server Name no painel do meio.
  2. Escolha a opção Apply as Column.
  3. Na lista de pacotes aparecerá uma nova coluna, na qual, para cada ClientHello, o nome do servidor fica visível na hora. Assim, em um segundo você vê para quais sites qualquer aplicação na sua máquina está se conectando.

O que é importante entender deste passo. Tudo o que vem depois do ClientHello e do ServerHello está criptografado: tanto a requisição quanto a resposta e os cabeçalhos, incluindo Host, Via e X-Forwarded-For. Já o SNI fica do lado de fora. Qualquer nó no caminho — roteador, operadora, gateway corporativo — vê o endereço IP de destino e o nome do SNI, mas não vê a URL, os cabeçalhos nem o conteúdo. Isso não é uma vulnerabilidade, é uma característica do design: o servidor precisa do nome antes de poder descriptografar qualquer coisa.

Verificação: na captura há um ClientHello com o campo Server Name igual ao nome da URL; na conexão por literal de IP, o campo está ausente. Você vê os bytes do nome no dump hexadecimal.

Possíveis problemas

Os pacotes não aparecem. Interface errada selecionada. Pare a captura, volte à lista de interfaces e escolha a que tem atividade.

O filtro está destacado em vermelho. Erro de digitação no filtro. Verifique: dois sinais de igual e a palavra tls em minúsculas.

O tráfego do curl não aparece porque passa por um proxy. Então o ClientHello estará dentro do túnel CONNECT; ele continua visível no Wireshark, mas o endereço de destino será o do proxy. Vá para o Passo 7 — é justamente sobre isso.

Passo 7: Vendo o que vai na requisição através de um proxy

Objetivo da etapa: entender qual parte da informação — endereço, nome, SNI — o servidor proxy recebe, e qual fica só entre o cliente e o site de destino.

Para este passo você precisa das credenciais de qualquer proxy HTTP: endereço, porta, login, senha. Se você tem um proxy móvel do painel de usuário, serve perfeitamente. Se não tem proxy, leia o passo como teoria e volte a ele depois.

HTTPS através de proxy HTTP: o túnel CONNECT

  1. Execute curl -v -x http://LOGIN:SENHA@ENDERECO_PROXY:PORTA https://example.com/ -o /dev/null. Substitua pelos seus dados.
  2. A primeira coisa que você vai notar: as linhas sobre a resolução DNS de example.com não existem. Em vez disso, o curl resolve o nome do proxy e se conecta a ele: * Connected to ENDERECO_PROXY (x.x.x.x) port PORTA.
  3. Em seguida aparece a linha * CONNECT tunnel: HTTP/1.1 negotiated e a própria requisição ao proxy: > CONNECT example.com:443 HTTP/1.1, > Host: example.com:443, > Proxy-Authorization: Basic ....
  4. Repare: no CONNECT vai o nome example.com, não o endereço. Isso significa que a consulta DNS será feita pelo proxy, e não pela sua máquina. É por isso que você não viu linhas de resolução.
  5. O proxy responde < HTTP/1.1 200 Connection established, e o curl escreve * CONNECT phase completed.
  6. Só agora começa o TLS: * SSL connection using TLSv1.3... e a verificação do certificado subjectAltName: host "example.com" matched. Esse handshake já acontece através do proxy, com o servidor de destino. O SNI nele é example.com, e o Host dentro é example.com.

Resumo por camadas. O proxy recebeu: seu endereço IP, o nome example.com e a porta 443 da linha CONNECT, além das suas credenciais de proxy. O proxy também vê tecnicamente os bytes do ClientHello que passam por ele — e portanto o SNI, já que ele é aberto; mas é o mesmo nome que já estava no CONNECT, nada novo. O proxy não recebe: o caminho da URL, os cabeçalhos da requisição, os cookies, o corpo da resposta — tudo isso está criptografado entre você e example.com. Os cabeçalhos Via e X-Forwarded-For o proxy não pode adicionar nesse esquema, porque não tem acesso ao interior do túnel.

A mesma requisição, mas por literal de IP através do proxy

  1. Execute curl -vk -x http://LOGIN:SENHA@ENDERECO_PROXY:PORTA https://93.184.216.34/ -o /dev/null.
  2. No CONNECT vai CONNECT 93.184.216.34:443. O proxy não vai resolver nada — o endereço já está pronto.
  3. Dentro do túnel vai o ClientHello sem SNI e a requisição com Host: 93.184.216.34. O servidor de destino reagirá como no Passo 4: site padrão, erro ou recusa.

SOCKS5: quem resolve o nome

  1. Se você tem um proxy SOCKS5, execute curl -v -x socks5://LOGIN:SENHA@ENDERECO:PORTA https://example.com/ -o /dev/null. O esquema socks5 significa que o nome é resolvido localmente, na sua máquina, e o endereço é passado ao proxy. Na saída haverá linhas sobre DNS.
  2. Agora troque o esquema para socks5h: curl -v -x socks5h://LOGIN:SENHA@ENDERECO:PORTA https://example.com/ -o /dev/null. A letra h significa que o nome é passado ao proxy e resolvido do lado dele. Não haverá linhas sobre DNS local.
  3. Nos dois casos, o SNI dentro do túnel continua sendo example.com — o esquema do proxy não afeta isso.

O sentido prático para trabalhar com proxies móveis e outros: se você quer que o site de destino veja um endereço correspondente à região do proxy e, ao mesmo tempo, que as respostas DNS também venham da região do proxy, use HTTP CONNECT ou socks5h. O esquema socks5 sem h resolve o nome com o seu resolvedor local, e o site pode receber o endereço do nó CDN mais próximo de você, e não do proxy. Isso é perceptível pela latência e, às vezes, pelo comportamento de serviços dependentes de geolocalização.

Atenção: na linha de comando com -x, seu login e senha do proxy vão para o histórico do terminal. Depois dos experimentos, limpe o histórico ou use a variável de ambiente https_proxy e, de preferência, um arquivo .curlrc com o parâmetro proxy, ao qual só você tem acesso.

Dica: para confirmar que a requisição realmente saiu pelo proxy, chame através dele qualquer serviço que mostra seu IP, por exemplo curl -x ... https://api.ipify.org. Você deve ver o endereço do proxy, não o seu. É uma forma rápida de verificar se as configurações foram aplicadas.

Verificação: na saída do curl aparece CONNECT example.com:443 com o nome; o DNS não foi executado localmente; após Connection established, ocorreu o handshake TLS com o certificado de example.com. Para o literal de IP, no CONNECT foi o endereço e não houve SNI.

Possíveis problemas

curl: (56) Received HTTP code 407 from proxy after CONNECT. Login ou senha incorretos. Se a senha tiver caracteres especiais, codifique-os no formato de URL ou passe-os pela flag -U LOGIN:SENHA, separadamente do endereço.

curl: (56) CONNECT tunnel failed, response 403. O proxy proíbe a conexão a esse host ou porta. Verifique as condições do seu plano e a lista de portas permitidas.

Verificação dos resultados: checklist

Percorra a lista. Cada item é uma habilidade separada que deve estar fixada.

  • Para qualquer URL, você determina o host, a porta e o tipo do host (literal IPv4, literal IPv6, hostname).
  • Você obtém os endereços de um nome via nslookup ou dig e entende que a resolução reversa pode não coincidir.
  • Na saída de curl -v, você encontra as linhas de conexão, a versão do TLS, o certificado e a verificação do subjectAltName.
  • Você sabe que o openssl s_client com -servername envia SNI e com -noservername não, e vê a diferença no certificado.
  • Ao conectar por literal de IP, você recebe o erro 60 no curl e entende a causa.
  • Com --resolve, você conecta ao endereço indicado com o SNI e o Host corretos, sem erros de certificado.
  • No Wireshark, você encontra o ClientHello, o campo Server Name e vê sua ausência no caso do literal de IP.
  • Através do proxy, você vê a linha CONNECT com o nome e entende o que exatamente o proxy recebe e o que não recebe.

Como testar a si mesmo

  1. Escolha qualquer site que você usa.
  2. Descubra os endereços dele com o dig.
  3. Conecte por nome e por um dos endereços, e compare as respostas.
  4. Conecte com --resolve a cada endereço da lista e confirme que todos entregam o mesmo certificado.
  5. Anote qual endereço respondeu mais rápido — o tempo aparece com curl -w "%{time_total}".

Se os cinco itens foram feitos sem espiar no guia, o resultado foi alcançado.

Erros típicos e soluções

1. Erro "o certificado não corresponde ao nome" ao acessar por IP

Causa: no campo SAN do certificado estão listados nomes de domínio, e o cliente procura um endereço IP. Solução: conecte por nome. Se o DNS ainda não estiver configurado, use --resolve ou o hosts. Não desative a verificação com a flag -k em cenários de produção.

2. O servidor entrega outro site ou a página padrão

Causa: falta de SNI ou SNI que não coincide com nenhum nome configurado, e o servidor web escolhe o host virtual default. Solução: verifique se o cliente está enviando o nome. No nginx, veja qual bloco server está marcado com default_server e, se necessário, configure para ele uma página-isca com um erro explícito, para que esses casos sejam fáceis de perceber.

3. Código 421 Misdirected Request

Causa: o SNI e o Host (ou :authority) não coincidem. Muitas vezes é consequência do reúso de uma conexão HTTP/2 para outro nome ou da substituição manual do cabeçalho Host mantendo a mesma URL. Solução: use --resolve em vez de alterar manualmente o cabeçalho Host — assim o SNI e o Host ficarão consistentes automaticamente.

4. O curl não mostra a resolução do nome e parece que o DNS não funciona

Causa: a requisição passa por um proxy HTTP ou socks5h, e o nome é resolvido do lado do proxy. Solução: esse é o comportamento normal. Se você precisa de resolução local, use o esquema socks5 sem h ou remova as configurações de proxy das variáveis de ambiente http_proxy e https_proxy.

5. Alterações no hosts não afetam o navegador

Causa: o navegador faz cache de DNS e mantém conexões abertas; além disso, alguns navegadores usam DNS-over-HTTPS e ignoram o resolvedor do sistema. Solução: reinicie o navegador, limpe o cache de DNS com ipconfig /flushdns no Windows, verifique as configurações de "DNS seguro" no navegador e use temporariamente o resolvedor do sistema.

6. openssl s_client mostra Verify return code 20 ou 21

Causa: o openssl não encontrou os certificados-raiz. Solução: indique o caminho para o arquivo de certificados-raiz com -CAfile. No Linux geralmente é /etc/ssl/certs/ca-certificates.crt. No Windows, use o openssl do Git for Windows, que tem o próprio conjunto de raízes.

7. O PowerShell mostra uma resposta estranha ao comando curl

Causa: no PowerShell, a palavra curl é um alias do comando embutido Invoke-WebRequest, que tem outros parâmetros. Solução: chame curl.exe com a extensão ou trabalhe no prompt de comando comum (cmd).

8. O Wireshark mostra o ClientHello, mas sem a extensão server_name, mesmo com uma URL de nome

Causa: ou você capturou o ClientHello de outra aplicação, ou o cliente acessou por IP. Solução: adicione o endereço de destino ao filtro: tls.handshake.type == 1 && ip.dst == 93.184.216.34, para cortar pacotes alheios.

Recursos adicionais para usuários avançados

Registrar o SNI no lado do servidor

Se você administra um nginx, adicione ao formato de log a variável $ssl_server_name ao lado de $host. A primeira mostra o que chegou no SNI, a segunda, o que chegou no Host. Comparando as duas, você encontra rapidamente clientes que se conectam por literal de IP ou com campos inconsistentes. Para conexões sem SNI, a variável ficará vazia.

Resposta separada para conexões sem SNI

No nginx, é possível declarar um bloco server com listen 443 ssl default_server e a diretiva ssl_reject_handshake on. Assim, qualquer conexão sem SNI ou com um nome desconhecido será rejeitada na fase de handshake, e o servidor não entregará nenhum certificado a mais. Isso disciplina os clientes e evita a exibição acidental do site errado.

Certificados com endereço IP no SAN

Tecnicamente, é possível emitir um certificado com um endereço IP no SAN. As autoridades certificadoras públicas fazem isso raramente e com restrições, mas para serviços internos com uma autoridade certificadora própria essa é uma opção viável. Nesse caso, a conexão por literal de IP passará na verificação. No entanto, o SNI continuará sem ser enviado — o padrão não permite — então naquele endereço precisa haver exatamente um serviço.

Literais IPv6

Tudo o que descrevemos também funciona para IPv6, com uma observação de sintaxe: na URL o endereço fica entre colchetes, e no --resolve não: --resolve example.com:443:2606:2800:220:1:248:1893:25c8:1946. O curl entende que tudo depois do segundo dois-pontos é o endereço.

HTTP/2 e reúso de conexões

No HTTP/2, uma única conexão TLS pode atender vários nomes, se todos estiverem listados no mesmo certificado. O cliente tem o direito de enviar uma segunda requisição com outro :authority na mesma conexão. O servidor compara o :authority com o SAN do certificado e com o SNI; em caso de divergência, responde 421, e o cliente abre uma nova conexão. A flag --http1.1 no curl permite desativar esse comportamento durante a depuração.

ClientHello criptografado

Está sendo desenvolvida e implantada a extensão Encrypted Client Hello, que permite criptografar parte do ClientHello, incluindo o SNI, desde que haja suporte do lado do servidor e publicação das chaves no DNS. Em 2026, o suporte existe em vários navegadores e CDNs, mas está longe de ser universal, e nas ferramentas de linha de comando ele é ativado separadamente. Para os fins deste guia, basta saber: sem essa extensão, o SNI fica aberto, e é assim que funciona a grande maioria das conexões hoje.

Medindo o tempo por etapas

A flag -w no curl permite exibir o tempo de cada etapa: curl -o /dev/null -s -w "dns %{time_namelookup} tcp %{time_connect} tls %{time_appconnect} total %{time_total}" https://example.com/. Assim você vê claramente quanto levou a resolução do nome, quanto o TCP e quanto o TLS. Na conexão por literal de IP, o primeiro valor ficará próximo de zero.

FAQ: perguntas frequentes

É possível enviar um endereço IP no SNI?

Não. O padrão proíbe explicitamente literais de IP no campo server_name. Clientes que seguem o padrão simplesmente não incluem a extensão SNI no ClientHello ao conectar por endereço.

Se o SNI é aberto, o HTTPS não protege o nome do site?

O nome do servidor no SNI e o endereço IP de destino são visíveis para os nós intermediários. Todo o resto — caminho, parâmetros da requisição, cabeçalhos, conteúdo — está criptografado. É assim que o protocolo foi projetado: o servidor precisa saber o nome antes de escolher o certificado.

Qual a diferença entre Host e SNI, se ali está o mesmo nome?

O SNI faz parte do TLS, vai em texto aberto na primeira mensagem e serve para escolher o certificado. O Host faz parte do HTTP, vai dentro do canal criptografado e serve ao servidor web para escolher o site e fazer o roteamento. Normalmente coincidem, mas são dois campos diferentes em dois níveis diferentes.

Por que o curl com --resolve não reclama do certificado, mas com o IP na URL reclama?

Porque com --resolve, na URL continua o nome. O curl verifica o certificado em relação ao nome da URL, não em relação ao endereço ao qual ele se conectou fisicamente.

Quem faz a consulta DNS quando eu trabalho através de um proxy?

Depende do tipo. HTTP CONNECT e socks5h passam o nome ao proxy, e a consulta é feita do lado dele. socks5 sem h e quaisquer esquemas em que você mesmo insere o endereço mantêm a resolução do seu lado.

O proxy vê quais páginas eu abro no site?

Com HTTPS através de um túnel CONNECT — não. O proxy vê o nome e a porta do CONNECT, o endereço e também os bytes abertos do ClientHello, incluindo o SNI. O caminho, os cabeçalhos e o conteúdo estão criptografados entre você e o site.

Por que, ao conectar por IP, um site abre normalmente e outro não?

No primeiro endereço há um único site, e o servidor o entrega como site padrão. No segundo endereço há muitos sites ou uma configuração estrita, e sem SNI o servidor ou entrega uma página-isca, ou interrompe o handshake.

Como forçar o navegador a enviar um SNI diferente do que está na barra de endereços?

Com os recursos nativos — de jeito nenhum: o navegador sempre envia no SNI o nome da URL. Para testes, use o curl com --resolve ou --connect-to, ou o openssl com -connect e -servername separados.

O que fazer se, depois dos experimentos, um site parou de abrir?

Verifique o arquivo hosts e remova as suas linhas, limpe o cache de DNS do sistema e do navegador, remova as variáveis de ambiente de proxy, feche e abra o navegador novamente. Na grande maioria dos casos, a culpa é de um registro esquecido no hosts.

Preciso do Wireshark ou o curl já basta?

Para entender, o curl e o openssl bastam. O Wireshark é necessário para ver os bytes reais e verificar o comportamento de aplicações para as quais você não tem um log detalhado, como clientes móveis ou programas de desktop.

Conclusão

Você percorreu todo o caminho da requisição no nível de transporte. Analisou a URL e aprendeu a distinguir um literal de IP de um nome. Viu como o nome se transforma em endereço via DNS e por que o caminho reverso não é garantido. Através do curl e do openssl, confirmou que, na conexão por nome, o SNI vai no ClientHello e o servidor entrega o certificado correto; e que, na conexão por endereço, o SNI está ausente, o certificado não coincide e o servidor entrega o site padrão ou recusa. Dominou o --resolve e o --connect-to — ferramentas de trabalho para testar servidores sem mexer no DNS. No Wireshark, encontrou os bytes do nome em texto aberto. E, por fim, viu como tudo isso aparece através de um proxy: o que entra no CONNECT, quem resolve o nome e o que permanece criptografado.

Vamos resumir a conclusão principal em uma linha: o endereço entrega os pacotes ao servidor, e o nome explica ao servidor o que você quer. Eles viajam por caminhos diferentes — o endereço no cabeçalho do pacote IP, o nome no SNI e no Host — e ambos são necessários para que a conexão funcione como planejado.

O que fazer depois

  • Leia o material separado sobre os cabeçalhos Via e X-Forwarded-For — agora você entende claramente onde termina o nível de transporte e começa o de aplicação, e não vai mais confundi-los.
  • Se você administra um servidor web, ative o registro de $ssl_server_name e veja quantos clientes chegam sem SNI.
  • Se você escreve automações, verifique qual esquema de proxy sua biblioteca usa e onde é feita a resolução DNS — isso afeta diretamente qual endereço e região o serviço de destino verá.

Para onde evoluir

Os próximos temas que fazem sentido estudar depois deste guia: a análise completa do handshake TLS e sua versão 1.3, o funcionamento de HTTP/2 e HTTP/3 com multiplexação e pseudo-cabeçalhos, o funcionamento do DNS com registros A, AAAA, CNAME e HTTPS, e também a configuração de hosts virtuais no nginx com escolha de certificado por SNI. Cada um deles se apoia no que você acabou de fazer na prática — e agora vai ser bem mais fácil.

Sobre o autor

Roman Melnikov

Roman Melnikov

Technical Writer and System Administrator

Experiência profissional: Technical writer and DevOps engineer with 9 years of experience. Created over 50 detailed guides on system configuration and administration. His instructions helped thousands of professionals successfully solve technical tasks. Popular author on Habr and YouTube.
Formação: Bauman Moscow State Technical University. Information Systems and Technologies
Especialização:
Technical Documentation DevOps System Administration Linux Docker and Kubernetes CI/CD Infrastructure Automation Cloud Technologies System Monitoring Bash and Python Scripting

Compartilhe este artigo: