blog
Infraestrutura web

Site não abre na rede da empresa depois de ativar HTTP/3

Primeiro a correção na rede, que preserva o HTTP/3 para todo mundo. Depois, como desligar o QUIC só no site que falha e provar com curl o protocolo negociado antes e depois.

JR · · 9 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: libere UDP 443 no firewall ou antivírus da empresa: costuma resolver sem desligar nada. Se não der, desative HTTP/3 só no domínio afetado (servidor, provedor ou CDN), mantenha HTTP/2 e prove a mudança com curl --http2 e --http3-only.

Neste artigo
  1. Libere UDP 443 antes de desligar qualquer coisa
  2. Por que o site falha só em algumas redes
  3. Prove o protocolo antes de mexer
  4. Desligar o HTTP/3 só no domínio afetado
  5. Como validar a mudança e quando reverter
  6. Checklist para repetir em qualquer cliente
  7. O que dizer ao cliente sem falar de QUIC

Libere UDP 443 antes de desligar qualquer coisa

O HTTP/3 roda sobre QUIC, e o QUIC usa UDP na porta 443. O HTTP/2 usa TCP na mesma porta. Quando o site abre em casa, no 4G e em qualquer outra rede, mas falha só dentro de uma empresa, o caso mais comum é um firewall corporativo ou um antivírus com inspeção de tráfego tratando UDP 443 de um jeito que o navegador não espera.

A correção certa costuma estar do lado da rede, não do servidor. Peça ao TI do cliente uma de duas coisas:

As duas resolvem. O que quebra é o meio-termo: o UDP passa no começo da conexão e depois some, ou é inspecionado por um produto que não entende QUIC. Se o TI fizer um dos ajustes acima, você não precisa tocar no servidor, e os outros visitantes continuam ganhando HTTP/3.

Desligar o QUIC no domínio é o plano B. Serve quando o TI do cliente não responde, quando o problema aparece em várias redes que você não controla, ou quando você precisa do site no ar hoje.

Qual ajuste pedir ao TI primeiroSite falha só em algumas redes?Se falha em todas, não é QUICPedir ao TI liberar UDPTráfego QUIC sem inspeçãoOu pedir bloqueio limpo do UDPRejeitar, não descartar em silêncioTI não responde ou há urgênciaDesligar HTTP/3 só no domínio
Ordem de decisão: peça ao TI primeiro e use o desligamento no domínio apenas como plano B.

Por que o site falha só em algumas redes

O navegador não começa pelo HTTP/3. Na primeira visita ele conecta por TCP, normalmente em HTTP/2, e o servidor responde com um cabeçalho Alt-Svc anunciando que aquele host também atende em HTTP/3. A partir daí o navegador tenta QUIC nas conexões seguintes e guarda essa informação por um tempo.

Na maior parte das redes, se o UDP está bloqueado de forma limpa, o navegador percebe e volta para TCP sem o usuário notar. O problema aparece quando o bloqueio é parcial ou quando um proxy, firewall ou antivírus interfere no meio da conexão. O sintoma que chega até você é vago: "o site não abre no escritório", "fica carregando", "abre só no celular".

Duas pistas que apontam para QUIC:

Se o problema existe em toda rede, não é QUIC. Procure DNS, certificado ou firewall do servidor.

Prove o protocolo antes de mexer

Não desligue nada sem registrar como o domínio responde hoje. Isso serve para você comparar depois e para mostrar ao cliente o que mudou.

Primeiro, confira se o seu curl tem suporte a HTTP/3. Nem toda distribuição empacota o curl com QUIC:

curl -V

Na linha Features, procure HTTP3. Se não aparecer, os testes com --http3 vão falhar por limitação do curl, não do site. Rode de uma máquina que tenha suporte, ou use um container com curl recente.

Com suporte confirmado, rode os três testes:

# 1. O servidor anuncia HTTP/3?
curl -sI --http2 https://exemplo.com.br | grep -i alt-svc

# 2. Qual versão foi negociada por TCP?
curl -s -o /dev/null -w '%{http_version}\n' --http2 https://exemplo.com.br

# 3. O QUIC funciona de fato, sem fallback?
curl -s -o /dev/null -w '%{http_version}\n' --http3-only https://exemplo.com.br

exemplo.com.br é fictício: troque pelo domínio do cliente. O --http3 simples tenta QUIC e pode cair para TCP sem avisar, por isso o terceiro teste usa --http3-only, que falha se o QUIC não fechar. O %{http_version} imprime a versão que o curl efetivamente usou.

Como ler o resultado:

Teste Saída Significado
1 linha com h3 o servidor convida o navegador a usar HTTP/3
1 nada o servidor não anuncia HTTP/3 para esse host
2 2 HTTP/2 por TCP funcionando
2 1.1 HTTP/2 desativado ou não negociado
3 3 QUIC funcionando a partir desta rede
3 0 QUIC não passa desta rede ou não está ativo no servidor

Com -s e -w '%{http_version}', uma falha de conexão não mostra mensagem nem deixa a linha vazia: o curl imprime 0. Para ver o motivo (timeout, recusa, falha de handshake), troque -s por -sS, que mantém a saída limpa e mostra o erro.

O teste mais útil é rodar o 3 de dentro da rede problemática e de fora dela. Se dá 3 fora e 0 dentro, você tem a prova de que o problema é o caminho UDP da empresa. Esse resultado é o que você manda para o TI do cliente.

Ordem dos testes antes de mexerCabeçalho Alt-SvcServidor anuncia HTTP/3?Protocolo por TCPHTTP/2 negociado?QUIC sem fallbackConexão UDP fecha?Repetir de fora da redeComparar os dois lados
Execute na ordem e salve as saídas de cada teste antes de alterar qualquer configuração.

Desligar o HTTP/3 só no domínio afetado

Se o ajuste de rede não vai acontecer, a meta é parar de anunciar HTTP/3 apenas para o domínio que falha, mantendo HTTP/2 nele e HTTP/3 nos demais sites do servidor.

Em servidor LiteSpeed, a referência é a documentação oficial Control HTTP/2 and HTTP/3, que descreve onde esses protocolos são controlados. O ponto que importa para você: o controle existe em mais de um nível, e você quer agir no nível do site, não no do servidor inteiro. Desligar globalmente resolve o cliente com problema e tira HTTP/3 de todo mundo.

Passo a passo prático:

Identifique seu nível de acesso ao servidor

Em hospedagem compartilhada você normalmente não tem acesso à configuração do servidor. Em VPS ou dedicado com LiteSpeed você tem. Leia a seção da documentação que corresponde ao seu caso antes de editar arquivo.

Aplique Enable QUIC só no virtual host do domínio

Na documentação do LiteSpeed (e na do OpenLiteSpeed, que segue a mesma lógica no WebAdmin), o QUIC é controlado em três camadas, e as três precisam estar ligadas para o HTTP/3 funcionar:

Não mexa no ALPN do listener nem desligue o HTTP/2 junto: o objetivo é que o site continue em HTTP/2 por TCP. Depois de salvar, faça o restart gracioso que o próprio WebAdmin oferece. Se a sua versão não mostrar *Enable QUIC* no virtual host, ou se o servidor roda em modo compatível com Apache (cPanel, por exemplo) sem acesso ao WebAdmin, consulte a seção correspondente da documentação ou siga o passo 3 e peça ao provedor.

Sem acesso ao servidor, peça ao provedor o desligamento por domínio

Na compartilhada, abra um chamado pedindo exatamente isto: "desativar HTTP/3/QUIC apenas para o domínio X, mantendo HTTP/2". Anexe a saída dos testes com curl. Pedido específico com prova resolve mais rápido que "o site não abre".

Com CDN na frente, o ajuste é no painel do CDN

Se o domínio passa por um CDN, quem anuncia HTTP/3 para o navegador é o CDN, não a sua origem. Desligar na origem não muda nada. O ajuste tem que ser feito no painel do CDN, para aquele domínio. Confira também se o DNS do domínio tem registro do tipo HTTPS anunciando h3, porque ele também pode levar o navegador a tentar QUIC.

Como validar a mudança e quando reverter

Rode os mesmos três testes da seção anterior. O resultado esperado depois da mudança:

Teste Antes Depois
1 (Alt-Svc) contém h3 sem h3
2 (--http2) 2 2
3 (--http3-only) 3 0 ou 3 (ver abaixo)

Se o teste 2 virar 1.1, você desligou mais do que devia. Volte e reative o HTTP/2.

O critério confiável é o teste 1: Alt-Svc sem h3. Somado ao navegador mostrando h2, isso prova a mudança. O teste 3 não serve como prova, porque o --http3-only vai direto por UDP e ignora o Alt-Svc. Ele só passa a falhar (saída 0) se o QUIC for desligado no listener ou no virtual host. Se você só removeu o anúncio, ou se o IP ou o CDN continuam aceitando QUIC por causa de outros sites, o teste 3 pode seguir retornando 3, e isso não indica que a mudança falhou: o navegador do usuário não tenta QUIC sem receber o anúncio.

No navegador do usuário afetado, a mudança pode demorar. O navegador guarda o anúncio de HTTP/3 por um período definido no próprio Alt-Svc. Para validar na hora, peça ao usuário para testar em aba anônima ou limpar os dados do site. No Chrome, as ferramentas de desenvolvedor mostram a coluna Protocol na aba Network: deve aparecer h2, não h3.

Trate o desligamento como temporário. Anote a data e o motivo. Quando o TI do cliente liberar UDP 443, ou quando você trocar de CDN ou servidor, reative o HTTP/3 e rode os testes de novo.

Checklist para repetir em qualquer cliente

Para padronizar entre sites, guarde este roteiro na documentação da agência:

  1. Confirmar que o problema é só em algumas redes. Se é geral, não é QUIC.
  2. Rodar curl -V e confirmar HTTP3 nas features.
  3. Rodar os três testes de fora e de dentro da rede afetada. Salvar as saídas.
  4. Mandar ao TI do cliente o pedido de liberar ou bloquear UDP 443 de forma limpa.
  5. Sem resposta ou com urgência: desligar HTTP/3 só no domínio (servidor, provedor ou CDN, conforme quem anuncia).
  6. Repetir os testes e conferir Alt-Svc sem h3 e --http2 retornando 2.
  7. Registrar data, motivo e condição para reativar.

Um script simples que roda os testes em uma lista de domínios ajuda a auditar a carteira toda de uma vez:

for d in cliente1.com.br cliente2.com.br; do
  echo "$d h2: $(curl -s -o /dev/null -w '%{http_version}' --http2 https://$d)"
  echo "$d h3: $(curl -s -o /dev/null -w '%{http_version}' --http3-only https://$d)"
done

Os domínios do exemplo são fictícios. Uma linha h3: 0 em um domínio que deveria ter HTTP/3 é sinal para investigar: o curl imprime 0 quando a conexão falha. Para ver a mensagem de erro, troque -s por -sS no script.

O que dizer ao cliente sem falar de QUIC

O cliente não precisa entender QUIC. Precisa saber que o site está bem e que a decisão é dele ou do TI dele. Uma frase que funciona:

Se o cliente perguntar se perdeu alguma coisa, a resposta honesta é: perde a vantagem do HTTP/3 em conexões lentas ou instáveis, e mais nada. HTTP/2 por TCP continua com HTTPS e é o que boa parte da web usa hoje. Por isso vale insistir com o TI: liberar UDP 443 resolve sem abrir mão de nada.

Referências

  1. Documentação oficial (litespeed) — Control HTTP/2 and HTTP/3. Consultado em 2026-11-15.
Leia também