Quem gerencia servidores com cPanel/WHM no dia a dia sabe que a tela branca (White Screen of Death) é um dos problemas mais traiçoeiros de debugar. O painel não devolve uma mensagem explícita de erro, deixando o usuário sem saber em qual camada a renderização quebrou.
Recentemente enfrentei esse cenário clássico: o WHM abria sem problemas, a lista de contas estava visível, mas ao clicar no ícone do cPanel para entrar na conta de um cliente (https://servidor.dominio.com.br:2087/xfercpanel), o navegador devolvia uma página completamente em branco.
Abaixo, documento o roteiro prático que segui para isolar a falha, verificar os serviços internos e restabelecer o acesso.
1. O sintoma inicial e os primeiros testes#
O fluxo que falhava era a transição de sessão do WHM para o cPanel (xfercpanel).
Em um primeiro momento, executei os comandos padrão de manutenção e reparo de pacotes no terminal:
/usr/local/cpanel/scripts/upcp --force
/scripts/fixrpm
/scripts/fixpkgMesmo após a sincronização forçada dos pacotes da base, a página continuava em branco.
Fui inspecionar o log principal de erros do cPanel:
tail -f /usr/local/cpanel/logs/error_logA saída retornava apenas rotinas operacionais:
[check_mysql] mysqlcheck found no errors on mysql
[wpt_license] Found no license information for this server.
[wpt_license] Nothing to do
“/usr/local/cpanel/scripts/restartsrv_spamd” called by (queueprocd)
info [whostmgrd] Successfully verified signature for cpanel (key types: release).Nenhum erro fatal explícito constava no log raiz. Isso indicava que o daemon web (cpsrvd) estava ativo e aceitando requisições na porta 2087, mas a camada de renderização interna do cPanel falhava antes de entregar o HTML.
2. Aprofundando nos serviços internos: o cpanel_php_fpm#
A interface moderna do cPanel (especialmente no tema Jupiter) depende de serviços internos em background, em particular o cpanel_php_fpm (o runtime PHP que executa o código dos plugins e telas do próprio cPanel) e o daemon cpsrvd.
Reiniciei o serviço PHP do cPanel via linha de comando:
/scripts/restartsrv_cpanel_php_fpm --hardAqui surgiu o primeiro diagnóstico claro:
(XID ycspry) O serviço “cpanel_php_fpm” está desabilitado.
The “cpanel_php_fpm” service is disabled.Em seguida, validei o estado do daemon principal:
/scripts/restartsrv_cpsrvd --hardRetorno:
Waiting for “cpsrvd” to restart ………waiting for “cpsrvd” to initialize ………finished.
Service Status
cpanel (cpsrvd (SSL) - dormant mode - accepting connections) is running as root with PID 20253 (systemd+/proc check method).
cpsrvd restarted successfully.Quando um serviço está marcado como desabilitado no gerenciador do cPanel, o comando manual de reinicialização é bloqueado pelo sistema.
Como reativar o serviço no WHM:#
- Acesse o WHM como root.
- Navegue até Configuração do Serviço (Service Configuration) > Gerenciador de Serviços (Service Manager).
- Localize a entrada cpanel-php-fpm (ou
cpanel_php_fpm). - Marque as opções Habilitado (Enabled) e Monitorar (Monitor).
- Clique em Salvar (Save) no rodapé da página.
3. Analisando o console do navegador (devtools)#
Após reativar o cpanel_php_fpm, tentei carregar novamente a URL de transferência. O Console do Developer Tools (F12) registrou:
xfercpanel:1 Unchecked runtime.lastError: The message port closed before a response was received.Esse aviso indica que o navegador encerrou a conexão antes que a resposta HTTP completa chegasse. No fluxo do cPanel, isso costuma ser causado por conflito de extensões, cache de sessão corrompido ou falha no handshake de troca de tokens entre o WHM (porta 2087) e a porta nativa do cPanel (2083).
4. Checklist prático de resolução#
Para cobrir todas as frentes que geram a tela branca na transição entre WHM e cPanel, estruturei as seguintes validações:
A. Isolamento de sessão e acesso direto#
- Janela Anônima: Abra o WHM em janela privativa sem extensões do navegador ativas.
- Teste Direto na Porta 2083: Tente logar diretamente em
https://servidor.dominio.com.br:2083/usando o usuário e senha da conta. Se o login direto funcionar, a falha reside exclusivamente no gerador de tokens doxfercpanel. - Regras do cPHulk: Verifique em WHM > Proteção Contra Força Bruta cPHulk se o seu IP local não sofreu bloqueio temporário de requisições em massa.
B. Redefinição do tema da conta#
Arquivos corrompidos de customização de temas podem impedir a renderização da interface:
- No WHM, acesse Listar Contas (List Accounts) > Modificar Conta (Modify Account).
- Altere o Tema do cPanel (cPanel Theme) para o tema padrão estável (
jupiteroupaper_lantern). - Salve e teste o acesso novamente.
C. Ajuste do limite de memória do PHP interno#
Se a interface contiver muitos plugins instalados, o processo do cPanel pode estourar o limite de memória:
- Edite o arquivo
/var/cpanel/cpanel.config. - Adicione ou eleve o limite:
php_memory_limit=512M- Aplique as mudanças:
/usr/local/cpanel/scripts/upcpD. Monitoramento de logs dedicados#
Para capturar exceções silenciosas do PHP interno em tempo real:
# Log do PHP-FPM interno do cPanel
tail -f /usr/local/cpanel/logs/cpanel-php-fpm-error.log
# Log da interface web do cpsrvd
tail -f /usr/local/cpanel/logs/cpanel/error_logE. Reconstrução de usuários e vhosts#
Se houver inconsistência nos arquivos de permissão e controle:
/usr/local/cpanel/scripts/rebuildcpusers
/usr/local/cpanel/scripts/fix_all_perl_vhostsRoteiro prático para o dia a dia#
Ao se deparar com a tela branca no cPanel via WHM, o método mais rápido é testar o estado do cpanel_php_fpm no Service Manager, monitorar o cpanel-php-fpm-error.log em vez de olhar apenas o log raiz e descartar bloqueios de navegador. Ter esse fluxo em mente reduz o tempo de diagnóstico e restaura o acesso sem a necessidade de intervenções invasivas no servidor.
Este artigo foi útil?
Deixe uma reação rápida para apoiar o conteúdo:
Veja também
Este post está licenciado sob CC BY-NC.
Comentários
Participe da discussão abaixo.
0 comentários