# 403 Forbidden após migrar para LiteSpeed: 3 causas

Como ler o log, triar a carteira inteira em duas varreduras e corrigir cada causa sem tentativa e erro no .htaccess.

> 403 depois de migrar para LiteSpeed tem 3 causas: dono/permissão herdados da cópia, diretiva Order/Allow/Require no .htaccess e document root fora da home da conta. A linha do log de erro diz qual é a sua antes de qualquer alteração.

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

---

## As três causas que o Apache tolerava e o LiteSpeed não

Quando um site passa a devolver 403 logo depois da troca do servidor web, a tentação é mexer no `.htaccess` até alguma coisa voltar. Em carteira com dezenas de sites isso é caro e não ensina nada: você conserta um e repete o erro nos outros nove.

A [documentação oficial do LiteSpeed sobre 403 em cPanel](https://docs.litespeedtech.com/lsws/cp/cpanel/403-error/) organiza o problema em um conjunto pequeno de causas, e na prática de migração elas se resumem a três famílias:

- **Dono e permissão do diretório ou do arquivo**, herdados do processo de cópia. O conteúdo está lá, mas o usuário sob o qual o LiteSpeed executa não consegue ler o caminho inteiro.
- **Diretivas de controle de acesso no `.htaccess`**, do estilo `Order`/`Allow from` (sintaxe antiga) ou `Require` (sintaxe nova), que foram interpretadas de um jeito no ambiente anterior e de outro agora, ou que dependiam de módulo que não está mais no caminho.
- **Document root apontando para fora do diretório da conta**, tipicamente um symlink ou um caminho absoluto num VirtualHost customizado que escapa da `homedir` do usuário.

A diferença entre as três não se adivinha olhando o site. Ela está escrita no log de erro, e o log precisa ser lido **antes** de qualquer alteração.

## Comece pelo log, não pelo arquivo

Em cPanel, o log de erro por domínio fica no caminho do próprio usuário, e o LiteSpeed também escreve no log do servidor. Olhe os dois, nessa ordem:

```bash
# log por domínio, existe só quando os logs por domínio estão habilitados
tail -n 50 ~/logs/example.com.error.log

# se o arquivo acima não existir, veja o que há na conta
ls -l ~/logs/

# log de erro do servidor web (precisa de acesso root)
tail -n 100 /usr/local/apache/logs/error_log
tail -n 100 /usr/local/lsws/logs/error.log
```

O caminho `~/logs/dominio.error.log` depende da configuração de logs por domínio do servidor. Quando ele não existe, não conclua que não há log: o registro está no `error_log` do Apache/LiteSpeed em `/usr/local/apache/logs/`, e em WHM o caminho em uso aparece em Service Configuration, Apache Configuration, Log Rotation. Com root, `ls -lt /usr/local/apache/logs/ | head` mostra qual arquivo foi escrito agora.

O que você procura é a linha que acompanha o 403, não o 403 em si. Três assinaturas típicas:

| O que aparece perto do 403 | Causa provável | Onde agir |
|---|---|---||
| Menção a permissão negada ao abrir um arquivo ou diretório do caminho | Dono/permissão herdados da migração | `chown`/`chmod` no caminho inteiro |
| Menção ao `.htaccess`, a uma diretiva de acesso ou a `access denied by` regra | Controle de acesso no `.htaccess` | Reescrever a diretiva |
| Menção a caminho fora da home do usuário, symlink ou document root | Document root fora do diretório da conta | Corrigir o VirtualHost ou o symlink |

Se o log não disser nada no momento da requisição, confirme que você está olhando o log certo: domínio com addon ou subdomínio costuma ter arquivo próprio.

## Quantos sites da carteira estão no mesmo caso

Antes de abrir site por site, vale separar quem caiu por permissão de quem caiu por `.htaccess`. Com acesso root, duas varreduras resolvem a triagem inicial.

### Varredura de dono errado na docroot

```bash
for d in /home/*/public_html; do
  u=$(echo "$d" | cut -d/ -f3)
  o=$(stat -c '%U' "$d" 2>/dev/null)
  [ "$o" != "$u" ] && echo "$d dono=$o esperado=$u"
done
```

Qualquer linha impressa é um candidato forte à causa 1. Dono `root` em `public_html` é o resultado clássico de restore feito como root.

### Varredura de sintaxe antiga de controle de acesso

```bash
grep -rl --include='.htaccess' -E 'Order |Allow from|Deny from' /home/*/public_html 2>/dev/null
```

Essa lista é a dos candidatos à causa 2. Não significa que todos estão quebrados; significa que, se quebrarem, é por ali.

Sem root, rode o equivalente dentro de cada conta via SSH ou pelo Gerenciador de Arquivos. Dá mais trabalho, mas a lógica é a mesma.

## Dono e permissão herdados da cópia dos arquivos

O padrão esperado em conta cPanel é que o conteúdo pertença ao usuário da conta. Permissão típica: `755` para diretórios, `644` para arquivos. `public_html` em muitas configurações fica `750` com grupo do servidor web, e isso é normal; o que não é normal é dono `root` ou permissão que remove o bit de execução de um diretório do caminho.

Correção, trocando `usuario` e `example.com` pelos valores reais (exemplo fictício):

```bash
# confirme antes dono, grupo e permissão atuais da própria docroot
stat -c '%U %G %a' /home/usuario/public_html

# ajuste só o conteúdo interno, sem tocar na public_html
find /home/usuario/public_html -mindepth 1 -exec chown usuario:usuario {} +
find /home/usuario/public_html -mindepth 1 -type d -exec chmod 755 {} \;
find /home/usuario/public_html -mindepth 1 -type f -exec chmod 644 {} \;
```

A `public_html` em si fica de fora de propósito. Se o `stat` mostrar grupo `nobody` com `750`, esse é o padrão de muitas instalações cPanel e deve ser preservado: corrija só o dono, com `chown usuario /home/usuario/public_html`, mantendo grupo e modo. Se o grupo já for o do usuário, `755` na docroot é o esperado. Compare com outra conta saudável do mesmo servidor antes de decidir.

Dois cuidados que evitam retrabalho:

- **Permissão de diretório é cumulativa no caminho.** Se `/home/usuario` estiver sem bit de execução, não adianta arrumar só `public_html`. Verifique com `namei -l /home/usuario/public_html/index.php`.
- **Não saia aplicando `777`.** Além de não ser necessário, há configuração que recusa servir arquivo com escrita para todos. O 403 some trocando por `755`/`644`, não subindo a permissão.

## Order, Allow e Require que derrubam o site inteiro

Aqui a origem costuma ser um bloco antigo de proteção copiado de tutorial ou deixado por plugin de segurança. Duas situações se repetem.

### Sintaxe antiga que nega tudo

```apache
# exemplo fictício, bloco que derruba o site inteiro
Order deny,allow
Deny from all
```

Se esse bloco estiver na raiz, todo mundo leva 403. Ele faz sentido dentro de `wp-content/uploads` para bloquear execução de PHP, por exemplo, e nenhum sentido na docroot.

O equivalente moderno, para quando a intenção é mesmo bloquear:

```apache
<RequireAll>
  Require all denied
</RequireAll>
```

E para liberar:

```apache
Require all granted
```

### Allowlist por IP que quebra só para o cliente

Bloco de allowlist por IP (do tipo `Allow from 203.0.113.10`, exemplo fictício) quebra quando o IP de saída muda ou quando o site passa a receber tráfego por outro caminho de rede. Sintoma típico: você acessa e vê o site, o cliente não vê.

O teste que separa `.htaccess` de permissão leva quinze segundos: renomeie o arquivo e recarregue.

```bash
mv public_html/.htaccess public_html/.htaccess.bak
# testar o site
mv public_html/.htaccess.bak public_html/.htaccess
```

O LiteSpeed relê o `.htaccess` conforme o intervalo de recarga configurado, então a mudança pode não refletir no primeiro acesso. Teste com requisição sem cache (`curl -I -H 'Cache-Control: no-cache' https://example.com/`) ou em aba anônima, e se o comportamento não mudar em um minuto, peça o reload da configuração do LiteSpeed antes de descartar a causa 2.

Se o 403 sumiu, a causa é a 2 e você já sabe em qual arquivo procurar. Se continuou, pare de mexer no `.htaccess`. Em WordPress, lembre de regenerar as regras de permalink depois (Configurações, Links permanentes, Salvar) se você tiver apagado em vez de restaurar.

## Document root apontando para fora da home da conta

A terceira é a menos frequente e a que mais consome tempo de quem não sabe que ela existe: o VirtualHost aponta para um caminho que não está dentro da home do usuário, ou `public_html` é um symlink para outro ponto do disco. O conteúdo aparece corretamente num `ls`, mas o servidor recusa servir.

Verifique assim:

```bash
ls -ld /home/usuario/public_html
readlink -f /home/usuario/public_html
```

Se o caminho resolvido sair de `/home/usuario`, essa é a sua causa. A correção limpa é mover o conteúdo para dentro da home da conta e ajustar o document root no cPanel/WHM, em vez de tentar liberar o caminho externo. Estrutura dentro da conta é o que o painel espera gerenciar, e qualquer exceção volta a quebrar no próximo restore.

## Validar com curl -I antes de fechar o chamado

Corrigiu, valide com cabeçalho e não com olho:

```bash
curl -I https://example.com/
curl -I https://example.com/wp-admin/
```

Quer `HTTP/2 200` ou um `301`/`302` legítimo para HTTPS ou para login. Teste também uma URL interna com permalink bonito, porque 403 na raiz e 403 em subpágina podem ter origens diferentes (a segunda costuma ser regra de reescrita).

Checklist de fechamento, reutilizável para cada site da carteira:

- [ ] Log de erro lido antes da primeira alteração, causa identificada por escrito
- [ ] Dono e permissão conferidos no caminho inteiro, não só na docroot
- [ ] `.htaccess` testado por renomeação e devolvido ao lugar
- [ ] Document root resolvido dentro da home da conta
- [ ] `curl -I` na home e em uma subpágina com permalink
- [ ] Permalinks salvos novamente, se o `.htaccess` foi tocado
- [ ] Backup do `.htaccess` original guardado fora da docroot

## A frase para o cliente

O cliente não quer saber de `chown`. Ele quer saber se perdeu alguma coisa e se vai acontecer de novo. Funciona dizer assim:

> **** O site não foi invadido e nenhum arquivo foi perdido. Na troca do servidor, a pasta do site ficou com uma marcação de dono/permissão do servidor antigo, e o servidor novo é mais rigoroso nessa checagem: em vez de servir a página, ele devolveu um aviso de acesso negado. Ajustei a marcação, validei a resposta do servidor e o site voltou. Não há ação necessária da sua parte.

Troque a segunda frase conforme a causa: para `.htaccess`, "havia uma regra antiga de bloqueio no arquivo de configuração do site, escrita numa sintaxe que o servidor novo interpreta de forma diferente"; para document root, "o endereço do site apontava para uma pasta fora da área da conta, e o servidor novo não serve conteúdo de fora dela".

E o conselho que vale contra o próprio interesse: se as três checagens passarem e o 403 continuar, não migre o site de novo nem mude de plano. Abra o log do LiteSpeed no servidor e leia a linha exata do bloqueio. A [documentação do LiteSpeed](https://docs.litespeedtech.com/lsws/cp/cpanel/403-error/) lista as causas conhecidas de 403 e, na prática de migração, a linha do log costuma apontar para uma delas, e a alteração certa leva menos tempo do que a tentativa e erro.

