blog
Painéis

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.

JR · · 10 min de leitura · 3 tabelas · 12 blocos de código

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
  1. Onde fica o Terminal dentro do cPanel
  2. Quando o item Terminal não aparece na conta
  3. Por que esses quatro comandos não quebram nada e onde mora o risco de verdade
  4. Quatro comandos para copiar e colar
  5. Os erros que você vai ver e o que cada um significa
  6. O mesmo diagnóstico sem Terminal, pelas telas do cPanel
  7. 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:

  1. Entre no cPanel da sua conta.
  2. Role até a seção Avançado (em inglês, *Advanced*).
  3. 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:

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:

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:

  1. 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).
  2. Se o status for 500, tail -n 50 no error_log. O caminho do arquivo na mensagem aponta o plugin ou tema.
  3. 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.
  4. Se a queixa for "acabou o espaço" ou "não consigo enviar arquivo", du no public_html e depois no wp-content.
  5. 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.

Referências

  1. Documentação oficial (cpanel) — How to Access the Command Line. Consultado em 2026-09-15.
Leia também