# 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.

> 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.

João Rizzon · 2026-11-16 · Infraestrutura web

---

## 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:

- liberar UDP 443 de saída sem inspeção, ou
- bloquear UDP 443 por completo (rejeitando, não descartando em silêncio), para que o navegador desista do QUIC e use TCP.

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.

## 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:

- o problema começou logo depois de ativar HTTP/3 no servidor ou no CDN;
- o mesmo navegador abre o site em aba anônima ou depois de limpar dados do site, e volta a falhar algum tempo depois (o navegador reaprende o `Alt-Svc`).

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.

## 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](https://docs.litespeedtech.com/shared/control-http2-http3/), 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:

- **Servidor:** opção *Enable QUIC*, na configuração geral do servidor. Desligar aqui tira HTTP/3 de todos os sites.
- **Listener:** opção *Open HTTP3/QUIC (UDP) Port*, no listener SSL da porta 443. Desligar aqui fecha o UDP 443 para todos os sites daquele listener.
- **Virtual host:** opção *Enable QUIC* dentro do virtual host do domínio. É esta que você quer: coloque em *No* só no host afetado e mantenha as outras duas como estão.

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:

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

> **** "O site usa uma versão mais nova do protocolo da web que viaja por um caminho que a rede da sua empresa está filtrando. O ideal é o TI liberar esse caminho (porta UDP 443). Enquanto isso, desativei essa versão só no seu site, e ele continua seguro e rápido pela versão anterior."

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.

