Todos os produtos
Search
Central de documentação

CDN:Compressão Gzip

Última atualização: Sep 16, 2026

Ao ative a compressão Gzip, os pontos de presença (PoPs) compactam os recursos antes de entregá-los aos usuários. Isso reduz o tamanho dos arquivos, melhora a velocidade de transferência e diminui o consumo de largura de banda.

Informações básicas

Os PoPs da CDN suportam dois métodos de compressão: Gzip e Brotli. Este documento descreve como configure a compressão Gzip. Para mais informações sobre a compressão Brotli, consulte Compressão Brotli.

  • A compressão Gzip ou Brotli aplica-se apenas a arquivos do servidor de origem com tamanho entre 1 KB e 10 MB. Arquivos menores que 1 KB ou maiores que 10 MB não são compactados.

  • A compressão Gzip é compatível com os seguintes tipos MIME: text/xml, text/plain, text/css, application/javascript, application/x-javascript, application/rss+xml, text/javascript, image/tiff, image/svg+xml, application/json e application/xml.

    Nota: Ative a compressão Gzip em tipos de arquivo já compactados (como imagens PNG e JPG ou vídeos MP4) não produz efeito. Para mais informações, consulte as notas de uso abaixo.

  • Um cliente indica suporte a conteúdo codificado em Gzip ao incluir o cabeçalho de solicitação Accept-Encoding: gzip.

  • Um servidor indica que um recurso está compactado com Gzip ao incluir o cabeçalho de resposta Content-Encoding: gzip.

  • Se você ative as compressões Gzip e Brotli simultaneamente e o cabeçalho de solicitação do cliente Accept-Encoding contiver br e gzip, apenas a compressão Brotli terá efeito.

Notas de uso

Ao usar a compressão Gzip, observe os seguintes pontos (incluindo interações com a compressão Brotli, otimização de página e outros recursos):

  • A compressão Gzip é compatível com todos os navegadores. Já a compressão Brotli não é suportada por algumas versões mais antigas. Verifique a compatibilidade do navegador de acordo com os requisitos do seu negócio.

  • Quando a CDN ou DCDN compacta um arquivo estático, o valor MD5 do arquivo é alterado. Se a lógica da sua aplicação depender da verificação do valor MD5 para arquivos entregues por um ponto de presença (PoP), desative as compressões Gzip e Brotli. Uma incompatibilidade nos valores MD5 pode causar falha na validação no lado do cliente e resultar em erro no baixe.

  • Caso seu servidor de origem tenha a compressão ativada e envie uma resposta com o cabeçalho Content-Encoding, os recursos de compressão da CDN e DCDN não terão efeito.

  • Se você ative simultaneamente a otimização de HTML e um recurso de compressão (Gzip ou Brotli), a otimização de HTML não será aplicada. A CDNDCDN apenas compactará os arquivos.

  • Formatos comuns de imagem (PNG, JPG, JPEG) e vídeo (MP4, AVI, WMV) já possuem compressão nativa. Ative a compressão Gzip ou Brotli nesses tipos de arquivo não traz benefícios significativos. Recomendamos desativar a compressão para esses formatos. Para otimizar ainda mais as imagens, use o recurso de processamento de imagens. Para otimizar vídeos, use o recurso de transcodificação de vídeo.

Procedimento

  1. Faça login no console da CDN.

  2. No painel de navegação à esquerda, clique em Domain Names.

  3. Na página Domain Names, localize o nome de domínio desejado e clique em Manage na coluna Actions.

  4. No painel de navegação do domínio, clique em Optimization.

  5. Na seção Gzip Compression, ative a chave Gzip Compression.

    Após ative a compressão Gzip, compare o arquivo recebido antes e depois da ativação do recurso. Se o cabeçalho de resposta contiver Content-Encoding: gzip, o arquivo foi compactado com sucesso.

FAQ

Para solucionar problemas como a compressão Gzip inoperante ou sem efeito após uma busca na origem, consulte o Guia de solução de problemas de otimização de desempenho.

Referência de API

BatchSetCdnDomainConfig