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

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

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

---

## 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](https://docs.litespeedtech.com/shared/ws/compression/)). 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:

- `enableGzipCompress` com valor `1`.
- `enableDynGzipCompress` com valor `1`, 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 exemplo `gzipCompressLevel 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 |
| 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

- **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_VPS` no 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 `.bak` e reinicie. Depois compare os dois arquivos com `diff` para achar o erro com calma.

