# Terminal do cPanel: 4 comandos para diagnosticar seu site

Onde clicar, o que fazer quando o item não aparece no painel e quatro comandos de leitura com a saída esperada descrita linha a linha.

> o Terminal fica em cPanel > Avançado > Terminal, abre no navegador já autenticado na sua conta e dispensa cliente SSH. Quatro comandos de leitura (curl -I, tail, du e ls -la) cobrem cabeçalho HTTP, error_log, espaço em disco e permissões.

João Rizzon · 2026-09-20 · Painéis

---

O tutorial diz "rode `curl -I` no seu site" e a pessoa trava ali. Instalar cliente SSH, gerar chave, descobrir porta, tudo isso antes de ver a primeira linha de resposta. Em muitas contas de hospedagem compartilhada com cPanel, dependendo do que o provedor habilitou, existe um atalho: um terminal dentro do próprio painel, que abre no navegador e já entra na sua conta.

Este guia é documental. Ele se apoia na [documentação oficial do cPanel sobre acesso à linha de comando](https://docs.cpanel.net/knowledge-base/general-server-administration/how-to-access-the-command-line/) e em exemplos identificados como exemplos. Não há medição de laboratório nesta página: nada aqui foi cronometrado nem comparado, é caminho de tela e comando de leitura.

## Onde fica o Terminal dentro do cPanel

O caminho é sempre o mesmo, independente do tema visual do painel:

- Entre no cPanel da sua conta.
- Role até a seção **Avançado** (em inglês, *Advanced*).
- Clique em **Terminal**.

Se o seu cPanel usa a barra de busca no topo, é mais rápido digitar `Terminal` ali e clicar no resultado.

Na primeira abertura o cPanel costuma exibir um aviso de que a ferramenta é destinada a usuários avançados e pedir uma confirmação antes de liberar a tela preta. Leia, marque a confirmação e siga. Depois disso o terminal abre direto.

O que aparece é um prompt já autenticado como o usuário da sua conta de hospedagem, no diretório home. Você não digita senha, não escolhe host, não configura porta. A documentação do cPanel trata a interface Terminal e o acesso por SSH como dois caminhos para a mesma linha de comando: o Terminal é a versão que roda no navegador.

Uma diferença prática que vale saber desde já: a sessão do Terminal vive dentro da aba. Se você fechar a aba, o comando que estava rodando morre junto. Para leitura e diagnóstico, que é o uso deste artigo, isso não incomoda.

## Quando o item Terminal não aparece na conta

O Terminal pode estar ausente por dois motivos diferentes, e vale distinguir antes de abrir chamado.

**Motivo 1: o provedor não habilitou a interface.** A seção Avançado existe, mas não há nenhum ícone chamado Terminal. Nada a fazer pelo painel.

**Motivo 2: a conta está sem shell.** O ícone existe, você clica e recebe uma mensagem de acesso negado ou uma tela que não chega a abrir o prompt.

Para confirmar qual é o seu caso, vá em **cPanel > Segurança > Acesso SSH** (*SSH Access*). É a tela onde se gerencia chave pública e privada. Se ela existe e permite gerenciar chaves, o shell tende a estar previsto no plano. Se ela não existe no painel, é sinal forte de que a conta não tem acesso a linha de comando nenhuma, nem por SSH nem por navegador.

Nesse caso, pergunte ao suporte do seu provedor apenas uma coisa: se a conta tem shell habilitado, e se ele é completo ou *jailed*. Shell *jailed* é um ambiente restrito ao seu próprio diretório: serve perfeitamente para os quatro comandos deste artigo.

E se a resposta for não, você ainda consegue fazer os mesmos diagnósticos pelo painel. A tabela da última seção mostra o equivalente de cada comando no Gerenciador de Arquivos e nas outras interfaces do cPanel.

## Por que esses quatro comandos não quebram nada e onde mora o risco de verdade

Os quatro comandos deste guia são de leitura. Eles mostram informação e não alteram nada: não apagam arquivo, não mudam permissão, não reiniciam serviço. O pior que acontece é uma mensagem de erro.

O risco mora no que você digita **depois**, quando começa a copiar comando de fórum. Três regras que evitam quase todo estrago:

- Antes de qualquer comando que escreva, mova ou apague, faça backup. Em **cPanel > Arquivos > Backup**, use "Baixar um backup do diretório inicial" ou gere o backup completo. Um comando com `rm` não tem lixeira, não tem desfazer e não pergunta duas vezes.
- Desconfie de qualquer coisa que comece com `sudo`. Em hospedagem compartilhada você não é root, e um comando que exige root ou vai falhar ou está sendo colado no lugar errado.
- Leia o caminho antes de apertar Enter. `~/public_html` é a pasta pública do domínio principal. O til (`~`) é um atalho para o seu diretório home.

Se o prompt travar com algum comando que não termina, pressione `Ctrl + C`. Isso interrompe o comando em execução e devolve o prompt.

## Quatro comandos para copiar e colar

Troque `exemplo.com.br` pelo seu domínio em todos eles. Os blocos de saída abaixo são exemplos ilustrativos, escritos para você reconhecer o formato, não capturas de um servidor real.

### Ver o cabeçalho HTTP com curl -I (e por que -I mente sobre compressão)

```
curl -I https://exemplo.com.br
```

O `-I` (letra i maiúscula) pede ao servidor apenas o cabeçalho da resposta, sem baixar o HTML. É o comando que os tutoriais de TTFB, de compressão e de cache pedem no primeiro passo.

Saída no formato esperado (exemplo):

```
HTTP/2 200
date: Mon, 15 Sep 2025 12:00:00 GMT
content-type: text/html; charset=UTF-8
server: nginx
cache-control: max-age=3600
```

O que ler:

- A primeira linha é o status. `200` é resposta normal. `301` e `302` são redirecionamento. `403` é acesso proibido. `500` é erro da aplicação, o tema do log da seção seguinte.
- `content-type` confirma que a URL devolve HTML e não outra coisa.
- Cabeçalhos de cache e de compressão aparecem aqui quando existem.

Para checar compressão, não use `-I`. O `-I` faz uma requisição HEAD, e muitos servidores não enviam `content-encoding` em resposta a HEAD mesmo com gzip ligado: a linha some e você conclui errado que a compressão está desligada. O jeito confiável é fazer uma requisição normal e descartar o corpo:

```
curl -s -o /dev/null -D - -H "Accept-Encoding: gzip" https://exemplo.com.br
```

Linha a linha: `-s` cala a barra de progresso, `-o /dev/null` joga fora o HTML baixado, `-D -` imprime os cabeçalhos da resposta na tela, e `-H "Accept-Encoding: gzip"` avisa ao servidor que o seu cliente aceita conteúdo comprimido. Se a compressão estiver ativa, aparece uma linha `content-encoding: gzip` no meio dos cabeçalhos. Se ela não aparecer nessa requisição, aí sim o servidor entregou sem comprimir.

Detalhe que confunde: rodando o comando de dentro do Terminal, você está consultando o site pela rede, então um proxy ou CDN na frente do domínio também responde. Se quiser ver o que o servidor de hospedagem responde sem intermediário, é outro assunto e outro comando.

### Ler os últimos erros de PHP do site com tail no error_log

```
tail -n 50 ~/public_html/error_log
```

O `tail` mostra o fim de um arquivo. O `-n 50` define quantas linhas. Log é arquivo que só cresce, e o erro que você está caçando é quase sempre o último, por isso ler o fim resolve.

Saída no formato esperado (exemplo):

```
[15-Sep-2025 12:00:01 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function meu_plugin_init() in /home/usuario/public_html/wp-content/plugins/exemplo/exemplo.php:42
```

Cada linha traz data, tipo do erro e, o mais importante, o **caminho do arquivo com o número da linha**. Em WordPress, esse caminho costuma apontar direto para o plugin ou tema responsável pelo erro 500.

Se o comando responder `No such file or directory`, o arquivo ainda não foi criado, porque nenhum erro foi registrado naquele diretório, ou os erros estão indo para outro lugar. Duas alternativas:

```
ls -la ~/public_html/error_log
```

confirma se o arquivo existe. E, para procurar logs em subpastas (WordPress gera um `error_log` por diretório em várias configurações):

```
find ~/public_html -name error_log
```

O `find` percorre a pasta e lista todos os arquivos com esse nome. Depois é só rodar o `tail` no caminho que ele devolver.

Para acompanhar o log enquanto reproduz o erro no navegador, use `tail -f` no lugar de `tail -n 50`. A tela fica aberta imprimindo linhas novas conforme elas chegam. Saia com `Ctrl + C`.

### Descobrir qual pasta está ocupando o disco com du

```
du -h --max-depth=1 ~/public_html | sort -h
```

Linha a linha: `du` soma o tamanho ocupado, `-h` mostra em KB, MB e GB em vez de blocos, `--max-depth=1` limita a saída ao primeiro nível de subpastas em vez de listar arquivo por arquivo, e `sort -h` ordena do menor para o maior entendendo essas unidades. O `|` passa a saída de um comando para o outro.

Saída no formato esperado (exemplo):

```
4.0K    /home/usuario/public_html/wp-admin
12M     /home/usuario/public_html/wp-includes
480M    /home/usuario/public_html/wp-content
495M    /home/usuario/public_html
```

A última linha é o total. A maior linha acima dela é a pasta para investigar. Em WordPress quase sempre é `wp-content`, e dentro dela `uploads` (imagens e o que o WooCommerce guarda) ou `cache` e `backups` de plugin. Para descer um nível, repita o comando trocando o caminho:

```
du -h --max-depth=1 ~/public_html/wp-content | sort -h
```

Esse é o comando que transforma "minha conta encheu" em "a pasta de backup de um plugin ficou com 12 GB".

### Conferir permissões, dono e arquivos ocultos com ls -la

```
ls -la ~/public_html | head -n 20
```

`ls` lista o conteúdo da pasta, `-l` usa o formato longo com permissões e dono, `-a` inclui arquivos ocultos como `.htaccess`, e `head -n 20` corta a saída nas primeiras 20 linhas para não encher a tela.

Saída no formato esperado (exemplo):

```
drwxr-xr-x  5 usuario usuario  4096 Sep 15 12:00 .
-rw-r--r--  1 usuario usuario   420 Sep 15 11:58 .htaccess
-rw-------  1 usuario usuario  3120 Sep 15 11:58 wp-config.php
drwxr-xr-x 20 usuario usuario  4096 Sep 15 11:58 wp-content
-rw-r--r--  1 usuario usuario   405 Sep 15 11:58 index.php
```

Como ler a primeira coluna: o caractere inicial diz se é diretório (`d`) ou arquivo (`-`). Os nove seguintes são três grupos de três, na ordem dono, grupo e outros, onde `r` é leitura, `w` é escrita e `x` é execução ou, em diretório, permissão de entrar.

| Aparece assim | Equivale a | Onde é o padrão esperado |
|---|---|---||
| `drwxr-xr-x` | 755 | pastas do site |
| `-rw-r--r--` | 644 | arquivos PHP, CSS, imagens |
| `-rw-------` | 600 | `wp-config.php`, conteúdo sensível |
| `-rwxrwxrwx` | 777 | nunca, corrija |

A coluna com o nome de usuário repetido duas vezes é dono e grupo. Se algum arquivo aparecer com dono diferente do seu usuário de hospedagem, anote e leve ao suporte: costuma ser resquício de upload feito por outro processo, e é causa comum de erro de permissão em atualização de plugin.

## Os erros que você vai ver e o que cada um significa

| Mensagem | Significa | O que fazer |
|---|---|---||
| `command not found` | o comando não existe nesse ambiente ou o nome foi digitado errado | confira a grafia; se estiver certa, o binário não está disponível no shell restrito |
| `No such file or directory` | o caminho não existe | confirme com `ls -la` a pasta acima; verifique se o site está em `public_html` ou numa subpasta |
| `Permission denied` | seu usuário não pode ler ou entrar ali | não insista com `sudo`; em compartilhada isso não vai funcionar |
| `Is a directory` | você usou um comando de arquivo em uma pasta | `tail` lê arquivo, `du` e `ls` leem pasta |
| prompt não volta | o comando continua rodando | `Ctrl + C` para interromper |

Um detalhe que economiza digitação: a tecla Tab completa nomes de pasta e de arquivo. Digite `cd ~/pub` e aperte Tab, o terminal completa `public_html`. A seta para cima traz o comando anterior, o que é ótimo para repetir um `du` mudando só o caminho.

## O mesmo diagnóstico sem Terminal, pelas telas do cPanel

Se a conta não tem shell, você ainda consegue fazer todos os quatro diagnósticos. Muda o caminho.

| Comando | O que ele responde | Equivalente sem Terminal |
|---|---|---||
| `curl -I` | status HTTP e cabeçalhos da resposta | navegador, tecla F12, aba Rede, recarregue a página e clique no primeiro item para ver Response Headers |
| `tail error_log` | últimos erros de PHP do site | cPanel > Métricas > Erros, ou Gerenciador de Arquivos, abra `public_html`, clique em `error_log` e use Visualizar |
| `du -h --max-depth=1` | quanto cada pasta ocupa | cPanel > Arquivos > Uso de Disco, que lista o consumo por diretório |
| `ls -la` | permissões, dono e arquivos ocultos | Gerenciador de Arquivos, botão Configurações e marque "Mostrar arquivos ocultos"; a coluna Permissões mostra o número, e o botão direito abre Alterar Permissões |

Duas observações sobre essa coluna da direita.

O Gerenciador de Arquivos não mostra arquivos que começam com ponto até você marcar a opção de exibir ocultos, em Configurações (*Settings*), no canto superior direito. Sem isso, o `.htaccess` simplesmente não aparece e você conclui que ele não existe.

E o visualizador de arquivo do painel abre o log inteiro, do começo. Em log grande isso pesa no navegador. Se o arquivo estiver com muitos megabytes, prefira baixá-lo pelo próprio Gerenciador de Arquivos e abrir em um editor local, ou renomeie o `error_log` (o servidor cria um novo na próxima ocorrência) e observe o arquivo novo, que nasce pequeno.

## Em que ordem rodar os comandos quando o site cai ou fica lento

Uma sequência que funciona bem quando o site está lento ou quebrado, na ordem:

- `curl -I` na URL do problema. O status já separa erro de aplicação (5xx), bloqueio (403), redirecionamento em cadeia (301 atrás de 301) e resposta normal e lenta (200).
- Se o status for 500, `tail -n 50` no `error_log`. O caminho do arquivo na mensagem aponta o plugin ou tema.
- Se o status for 200 e a queixa for lentidão, volte ao `curl` com medição de tempo, que é o assunto do tutorial específico de TTFB, e verifique o `content-encoding` com a requisição GET descrita acima.
- Se a queixa for "acabou o espaço" ou "não consigo enviar arquivo", `du` no `public_html` e depois no `wp-content`.
- Se a queixa for "não consigo atualizar plugin" ou "o WordPress pede FTP", `ls -la` para olhar dono e permissões.

Nada disso exige instalar programa no computador. Exige a aba do cPanel aberta, o item Terminal em Avançado e a paciência de ler a saída antes de digitar o próximo comando.

Se em algum ponto o comando seguinte deixar de ser de leitura e passar a alterar arquivo, banco ou permissão, pare e faça o backup em cPanel > Arquivos > Backup antes. É a diferença entre um diagnóstico e um incidente.

