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.

Resposta curta: 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.
Neste artigo
- Onde fica o Terminal dentro do cPanel
- Quando o item Terminal não aparece na conta
- Por que esses quatro comandos não quebram nada e onde mora o risco de verdade
- Quatro comandos para copiar e colar
- Os erros que você vai ver e o que cada um significa
- O mesmo diagnóstico sem Terminal, pelas telas do cPanel
- Em que ordem rodar os comandos quando o site cai ou fica lento
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 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
rmnã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.301e302são redirecionamento.403é acesso proibido.500é erro da aplicação, o tema do log da seção seguinte. content-typeconfirma 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 -Ina 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 50noerror_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
curlcom medição de tempo, que é o assunto do tutorial específico de TTFB, e verifique ocontent-encodingcom a requisição GET descrita acima. - Se a queixa for "acabou o espaço" ou "não consigo enviar arquivo",
dunopublic_htmle depois nowp-content. - Se a queixa for "não consigo atualizar plugin" ou "o WordPress pede FTP",
ls -lapara 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.
Referências
- Documentação oficial (cpanel) — How to Access the Command Line. Consultado em 2026-09-15.