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.

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
- O que muda quando o servidor é OpenLiteSpeed sem painel
- Antes de mexer: backup e caminho de volta
- Descobrindo onde a sua imagem guarda a compressão
- Como ligar a compressão no httpd_config.conf
- Quais tipos compensam comprimir
- Como medir com curl o tamanho da página com e sem gzip
- 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:
enableGzipCompresscom valor1.enableDynGzipCompresscom valor1, para o HTML gerado pelo WordPress também ser comprimido. Sem isso, só arquivos estáticos entram.gzipCompressLevel: mantenha o número que o arquivo já traz, se ele estiver entre 1 e 9. Para mudar, apague o número depois do nome e digite outro na mesma linha, por exemplogzipCompressLevel 6. A escala vai de 1 (mais rápido, arquivo maior) a 9 (arquivo menor, mais CPU). O HTML é comprimido a cada requisição, então num VPS pequeno evite os números mais altos.compressibleTypes: deixe a lista padrão ou garanta que ela contenha os tipos de texto (detalhes na próxima seção).
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.
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 |
| 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
- Cloudflare ou outro CDN na frente: o curl conversa com o CDN, não com o seu VPS. O resultado reflete a configuração do CDN. Para testar o servidor direto, use o IP do VPS com
--resolve seusite.com.br:443:IP_DO_VPSno comando. - Reinício não aconteceu: sem
lswsctrl restart, o arquivo editado não vale. Rode de novo. - Compressão dinâmica desligada: o CSS vem comprimido, mas o HTML não. Confira
enableDynGzipCompress. - Tipo fora da lista: um JSON de API ou um SVG sem compressão geralmente indica que o tipo MIME não está em
compressibleTypes. - Plugin de cache do WordPress: o LiteSpeed Cache serve páginas em cache pelo próprio servidor e não substitui esta configuração. Depois de mudar a compressão, limpe o cache do plugin antes de testar.
- Site fora do ar após editar: restaure o
.bake reinicie. Depois compare os dois arquivos comdiffpara achar o erro com calma.
Referências
- Documentação oficial (litespeed) — Compression (LiteSpeed shared web server docs). Consultado em 2026-11-13.