blog
Infraestrutura web

Como ativar gzip no OpenLiteSpeed de um VPS sem painel

Um passo a passo para VPS de imagem pronta: achar o arquivo de configuração na sua instalação, ligar a compressão com backup e caminho de volta, e provar com curl quantos KB a página deixou de trafegar.

JR · · 7 min de leitura · 2 tabelas · 8 blocos de código

Resposta curta: faça backup de /usr/local/lsws/conf/httpd_config.conf, ache com grep "compress" as chaves da sua imagem (em geral enableGzipCompress e enableDynGzipCompress, no bloco tuning), ponha valor 1 nas duas, reinicie com lswsctrl e compare no curl o size_download com e sem Accept-Encoding: gzip.

Neste artigo
  1. O que muda quando o servidor é OpenLiteSpeed sem painel
  2. Antes de mexer: backup e caminho de volta
  3. Descobrindo onde a sua imagem guarda a compressão
  4. Como ligar a compressão no httpd_config.conf
  5. Quais tipos compensam comprimir
  6. Como medir com curl o tamanho da página com e sem gzip
  7. Por que o curl pode não mostrar compressão mesmo com a opção ligada

O que muda quando o servidor é OpenLiteSpeed sem painel

Em hospedagem com cPanel, ligar a compressão é marcar uma opção numa tela. Num VPS criado a partir de uma imagem pronta com OpenLiteSpeed (as imagens de "WordPress com OpenLiteSpeed" que vários provedores oferecem), não há essa tela. A configuração do servidor fica em arquivo de texto, e você edita pelo terminal via SSH.

A documentação do LiteSpeed Web Server descreve a compressão em termos de opções do servidor: ligar a compressão, ligar a compressão de conteúdo dinâmico, escolher o nível de compressão e definir a lista de tipos que podem ser comprimidos (Compression, documentação LiteSpeed). Essa página não é do OpenLiteSpeed e não fala de arquivo de configuração. No OpenLiteSpeed, opções equivalentes viram linhas num arquivo de configuração. O trabalho aqui é achar essas linhas na sua imagem, ajustar e conferir o resultado.

Este guia é documental. A Napoleon não mediu ganho de compressão para este artigo. Os números que você vai ver são os do seu próprio site, medidos por você no último passo.

Antes de mexer: backup e caminho de volta

Um erro de digitação no arquivo principal pode impedir o servidor de subir, e aí o site fica fora do ar até você corrigir. Por isso, o primeiro passo é sempre uma cópia.

Conecte por SSH (no Windows, pelo PowerShell ou PuTTY; no Mac e Linux, pelo Terminal) e rode:

sudo cp /usr/local/lsws/conf/httpd_config.conf /usr/local/lsws/conf/httpd_config.conf.bak

O comando não mostra nada se der certo. Para confirmar que a cópia existe:

ls -l /usr/local/lsws/conf/

Você deve ver httpd_config.conf e httpd_config.conf.bak com o mesmo tamanho.

Se algo der errado depois, o caminho de volta é restaurar a cópia e reiniciar:

sudo cp /usr/local/lsws/conf/httpd_config.conf.bak /usr/local/lsws/conf/httpd_config.conf
sudo /usr/local/lsws/bin/lswsctrl restart

Se a pasta /usr/local/lsws não existir na sua imagem, o servidor foi instalado em outro caminho. Nesse caso, procure com sudo find / -name httpd_config.conf 2>/dev/null e use o caminho que aparecer em todos os comandos deste guia.

Descobrindo onde a sua imagem guarda a compressão

Cada provedor monta a imagem do seu jeito, e versões diferentes do OpenLiteSpeed podem trazer o arquivo com valores diferentes. Em vez de colar um bloco pronto, veja primeiro o que já está lá:

sudo grep -n -i "compress" /usr/local/lsws/conf/httpd_config.conf

Linha a linha: grep procura texto, -n mostra o número da linha, -i ignora maiúsculas e minúsculas, e compress é o trecho buscado. O resultado esperado é uma lista curta de linhas, em geral dentro de um bloco chamado tuning. A documentação citada no início é a do LiteSpeed Web Server, não a do OpenLiteSpeed, e ela não traz o arquivo httpd_config.conf, o bloco tuning nem nomes de chave. Os nomes da tabela abaixo são exemplos encontrados em instalações de OpenLiteSpeed, não parâmetros documentados por essa fonte. Confira cada um no resultado do seu grep:

Chave no arquivo (exemplo, confira no seu) Opção equivalente na documentação do LiteSpeed Web Server O que controla
enableGzipCompress Enable Compression Liga ou desliga a compressão no servidor
enableDynGzipCompress Enable Dynamic Compression Comprime respostas geradas na hora, como o HTML do PHP
gzipCompressLevel Compression Level (Dynamic Content) Nível para conteúdo dinâmico, de 1 (rápido) a 9 (menor arquivo)
compressibleTypes Compressible Types Lista de tipos MIME que podem ser comprimidos
gzipStaticCompressLevel Static Compression Level Nível para arquivos estáticos, comprimidos uma vez e reaproveitados

Se o nome na sua imagem for diferente, confie no que o seu arquivo mostra, não na tabela. A tabela serve para você reconhecer a função de cada linha.

Como ligar a compressão no httpd_config.conf

Como abrir o httpd_config.conf no nano e chegar ao bloco tuning

sudo nano /usr/local/lsws/conf/httpd_config.conf

No nano, aperte Ctrl+W, digite tuning e Enter para pular até o bloco.

Quais valores colocar em cada chave do bloco tuning

Dentro do bloco tuning, confira:

Se alguma dessas linhas não existir, há dois caminhos. O mais seguro é ligar a opção pelo WebAdmin (veja a alternativa abaixo), que grava a chave com o nome correto. O outro é adicionar a linha à mão dentro do bloco tuning, no mesmo formato das linhas vizinhas (nome, espaço, valor), com a grafia exata que o grep mostrou para as chaves parecidas, por exemplo enableDynGzipCompress 1. Faça isso só depois do backup. Uma chave escrita de forma errada pode ser ignorada ou gerar erro na leitura do arquivo. Se o site não voltar após o reinício, confira o log de erro em /usr/local/lsws/logs/error.log e, na dúvida, restaure o backup.

Como salvar e reiniciar o servidor com lswsctrl

No nano: Ctrl+O, Enter, Ctrl+X. Depois:

sudo /usr/local/lsws/bin/lswsctrl restart

O esperado é uma mensagem curta confirmando o reinício. Abra o site no navegador. Se ele não carregar, restaure o backup com os comandos da seção anterior.

Como ligar a compressão pelo WebAdmin, sem editar o arquivo

O OpenLiteSpeed tem um console web próprio, o WebAdmin, que costuma responder na porta 7080. Em muitas imagens essa porta fica fechada no firewall por segurança, e é melhor que continue assim. Se você já usa o console, as mesmas opções ficam em Server Configuration, aba Tuning. Ele grava no mesmo arquivo, então não edite pelos dois caminhos ao mesmo tempo.

Ordem das etapas neste guiaCopiar o httpd_config.confBackup antes de editarLigar as chaves no bloco tuningValor 1 nas chaves de compressãoReiniciar com lswsctrlSem restart, a edição não valeTestar a página com curlConfirmar content-encoding no cabeçalho
Ordem das etapas neste guia. Cada uma tem um passo de verificação antes de seguir.

Quais tipos compensam comprimir

Compressão funciona bem em texto, porque texto tem muita repetição. HTML, CSS, JavaScript, JSON, XML e SVG (que é texto) encolhem bastante. São esses tipos que a lista de tipos compressíveis deve conter.

JPG, PNG, WebP, PDF, MP4 e arquivos ZIP já saem comprimidos do próprio formato. Passar gzip por cima gasta CPU e devolve praticamente o mesmo tamanho, às vezes alguns bytes maior. Por isso a documentação trata a lista de tipos como uma escolha: ela existe justamente para deixar esses formatos de fora.

Tipo de arquivo Vale comprimir? Motivo
HTML, CSS, JS, JSON, XML Sim Texto com muita repetição
SVG Sim É XML, texto puro
JPG, PNG, WebP, GIF Não Formato já comprimido
PDF Em geral não O conteúdo interno costuma já vir comprimido
MP4, MP3, ZIP Não Formato já comprimido

Se o seu site está pesado por causa de imagens, compressão gzip não resolve. O caminho é redimensionar e converter as imagens, assunto separado deste guia.

Como medir com curl o tamanho da página com e sem gzip

O teste mais honesto é pedir a mesma página duas vezes: uma sem aceitar compressão e outra aceitando gzip. Troque https://seusite.com.br/ pelo endereço real.

curl -s -o /dev/null -w '%{size_download}\n' https://seusite.com.br/
curl -s -o /dev/null -w '%{size_download}\n' -H 'Accept-Encoding: gzip' https://seusite.com.br/

Linha a linha: -s silencia a barra de progresso, -o /dev/null descarta o conteúdo, -w '%{size_download}\n' imprime quantos bytes foram baixados, e -H 'Accept-Encoding: gzip' avisa o servidor que o cliente aceita gzip. Como o curl não descompacta sem a opção --compressed, o segundo número é o tamanho que realmente trafegou. Divida por 1024 para ter KB.

O resultado esperado com a compressão ligada: o segundo número bem menor que o primeiro. Para confirmar pelo cabeçalho:

curl -s -D - -o /dev/null -H 'Accept-Encoding: gzip' https://seusite.com.br/ | grep -i content-encoding

Se aparecer content-encoding: gzip, a resposta veio comprimida. Se não aparecer nada, a resposta saiu sem compressão.

Brotli é outro algoritmo e precisa de outro pedido. Para testá-lo, rode o mesmo comando trocando o cabeçalho por -H 'Accept-Encoding: br'. Se a resposta trouxer content-encoding: br, o servidor também entrega Brotli. Este guia trata só do gzip.

Repita o teste com um arquivo CSS e com uma imagem JPG do site. No CSS os números devem cair. Na imagem, devem ficar iguais, o que confirma que a lista de tipos está fazendo o trabalho dela.

Por que o curl pode não mostrar compressão mesmo com a opção ligada

Se a compressão não aparece no testeSite não carrega após reiniciar?Restaure o arquivo .bakReinicie com lswsctrl restartDepois de cada alteraçãoContent-encoding aparece no cabeçalho?Se não, confira enableDynGzipCompressTipo JSON ou SVG sem compressão?Confira compressibleTypesCloudflare na frente do site?Teste direto pelo IP do VPS
Caminho de diagnóstico quando a compressão não aparece no teste.

Referências

  1. Documentação oficial (litespeed) — Compression (LiteSpeed shared web server docs). Consultado em 2026-11-13.
Leia também