blog
Revenda

Inventário de subdomínios na revenda cPanel em 3 passadas

Um inventário de subdomínios feito em uma passada no WHM de revenda, com document root, versão do que roda e decisão tomada para cada linha.

JR · · 7 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: a lista completa vem de *WHM » Account Information » List Subdomains*, cruzada com List Accounts (para achar a conta dona), o document root de cada vhost e o que está instalado na pasta. Uma linha por subdomínio, com conta dona, document root, o que roda e a decisão: apagar, proteger ou atualizar.

Neste artigo
  1. O que o WHM de revenda mostra e o que fica fora do seu alcance
  2. A planilha de cinco colunas que você quer ter no fim
  3. Primeira passada, levantar a lista de subdomínios que existem de verdade
  4. Segunda passada, amarrar cada subdomínio ao seu document root
  5. Terceira passada, descobrir o que está instalado em cada pasta e em que versão
  6. Os quatro erros que fazem o inventário sair errado
  7. Decidir cada linha e executar sem derrubar produção
  8. A frase que explica o risco para o cliente final
  9. Transformar o inventário em rotina trimestral

O subdomínio esquecido quase nunca aparece por conta própria. Ele aparece num relatório de vulnerabilidade, numa reclamação de conteúdo duplicado, ou quando o cliente pergunta por que teste.dominio.com.br está indexado no Google com um WordPress de 2024 sem atualização desde então.

Antes de decidir o que fazer com cada um, você precisa da lista. E a lista precisa vir do servidor, não da memória de quem criou os subdomínios.

O que o WHM de revenda mostra e o que fica fora do seu alcance

A documentação do cPanel descreve a interface List Subdomains em *WHM » Account Information » List Subdomains* (docs.cpanel.net). Ela lista os subdomínios das contas às quais você tem acesso, com o domínio ao qual pertencem.

O que isso significa na prática, para quem tem revenda e não root:

Se o seu acesso incluir shell (algumas revendas liberam, outras não), o caminho fica mais rápido. O artigo cobre as duas rotas.

A planilha de cinco colunas que você quer ter no fim

Defina a saída antes de começar a clicar. Uma linha por subdomínio, sempre com as mesmas colunas:

Subdomínio Conta dona Document root O que roda Decisão
teste.exemplo.com.br exemplocli /home/exemplocli/public_html/teste WordPress antigo apagar
homolog.exemplo.com.br exemplocli /home/exemplocli/homolog WordPress proteger por senha
cdn.exemplo.com.br exemplocli /home/exemplocli/public_html estático atualizar/manter
antigo.loja.com.br lojacli /home/lojacli/public_html/antigo HTML parado apagar

Os valores acima são exemplo fictício, só para fixar o formato. Três decisões possíveis e nada mais: apagar, proteger (senha de diretório ou bloqueio de indexação) ou atualizar/manter. Linha sem decisão é linha que você vai reabrir daqui a seis meses.

As três passadas do inventário de subdomíniosListarList Subdomains ou userdataAmarrarCada subdomínio ao document rootIdentificarCMS instalado e versão
As três passadas do inventário: lista, caminho, conteúdo. Cada uma alimenta uma coluna da planilha.

Primeira passada, levantar a lista de subdomínios que existem de verdade

Levantando a lista pelo WHM, sem shell

Abra *Account Information » List Subdomains*. A tela devolve os subdomínios e o domínio correspondente, conforme a documentação oficial. Copie para a planilha.

Resultado esperado: uma lista que costuma ser maior do que a que você tinha na cabeça. Subdomínio de homologação, de migração, de teste de tema, de ferramenta que o cliente contratou e cancelou.

Levantando a lista pelo userdata, se a revenda liberar shell

Cada conta cPanel guarda a configuração de vhost em arquivos de userdata. Listar os arquivos já dá o inventário dos domínios com vhost real:

ls /home/USUARIO/.cpanel/datastore 2>/dev/null
ls /var/cpanel/userdata/USUARIO/

O segundo caminho é o que interessa: há um arquivo por domínio e subdomínio servido pelo Apache/LiteSpeed daquela conta, além dos arquivos de cache e das variantes _SSL. Para extrair o document root de cada um:

grep -H "^documentroot" /var/cpanel/userdata/USUARIO/*

Se o comando não executar por falta de permissão, você está sem root e segue pelo WHM. Não insista: a rota de painel chega no mesmo lugar, só mais devagar.

Segunda passada, amarrar cada subdomínio ao seu document root

Sem shell, o document root aparece dentro do cPanel da conta, em *Domínios* (ou *Subdomínios*, dependendo da versão da interface). Entre pelo botão de acesso da conta no List Accounts do WHM, anote a pasta de cada subdomínio e volte.

Três situações que vale registrar na planilha com um comentário:

Terceira passada, descobrir o que está instalado em cada pasta e em que versão

Com o document root em mãos, a pergunta é o que há dentro. Com shell, dois comandos resolvem a maioria dos casos:

# instalações WordPress sob a conta
find /home/USUARIO -maxdepth 4 -name wp-includes -type d

# versão declarada de cada uma
find /home/USUARIO -maxdepth 5 -name version.php -path '*wp-includes*' \
  -exec grep -H "wp_version =" {} \;

O segundo comando casa com o alcance do primeiro: instalações em public_html/teste ou /home/usuario/homolog/sub entram na conta, coisa que um glob de um nível só deixaria de fora. A saída vem uma linha por instalação, no formato /home/USUARIO/public_html/teste/wp-includes/version.php:$wp_version = '6.4.2';. Caminho é o document root, valor entre aspas é a versão. Se uma linha não aparecer para um subdomínio que você sabe que roda WordPress, o document root está mais fundo do que -maxdepth 5: aumente o número ou aponte o find direto para a pasta.

Sem shell, use o Gerenciador de Arquivos do cPanel da conta e procure pelos marcadores óbvios: wp-config.php para WordPress, configuration.php para Joomla, app/etc/env.php para Magento, index.html solto para site estático. Para a versão do WordPress, abra wp-includes/version.php e leia a linha $wp_version.

Se o provedor expõe WP Toolkit ou ferramenta equivalente na revenda, ela faz essa varredura por conta e já informa a versão. Use, poupa tempo. Não tendo, o caminho manual acima funciona.

Os quatro erros que fazem o inventário sair errado

Registro na zona DNS sem vhost correspondente

No *Edit DNS Zone* aparece um registro A para antigo.dominio.com.br, mas nenhum vhost corresponde a ele. O que acontece: o Apache entrega o vhost padrão do IP ou o site principal, e você conclui que o subdomínio está no ar quando ele é só um registro órfão. Resultado prático: apagar o registro DNS resolve, mexer em pasta não.

Addon domain contado como subdomínio esquecido

No cPanel, um addon domain é criado tecnicamente com um subdomínio associado. Ele vai aparecer na sua contagem e não é um subdomínio esquecido: é o site de um cliente. Confira o domínio principal da conta no List Accounts antes de marcar qualquer linha como descartável.

Wildcard na zona quebra o teste de "se resolve, existe"

Um registro *.dominio.com.br faz qualquer nome resolver. Isso quebra o teste de "se resolve, existe": qualquercoisa.dominio.com.br vai responder. Com wildcard na zona, o inventário confiável é o de vhosts (userdata ou List Subdomains), nunca o de DNS.

Document root fora do public_html some da varredura

Já mencionado acima e repetido aqui porque é o que mais derruba script de varredura: quem limita a busca a public_html perde os subdomínios apontados para /home/usuario/homolog ou similares.

Decidir cada linha e executar sem derrubar produção

Situação encontrada Decisão Ação
CMS desatualizado, sem uso há meses apagar backup da pasta e do banco, remover subdomínio, remover registro DNS
Homologação em uso ativo proteger senha de diretório no cPanel e noindex
Site vivo, versão atrasada atualizar/manter atualizar CMS, plugins e PHP
Registro DNS órfão apagar remover o registro na zona
Subdomínio institucional esquecido atualizar/manter registrar dono e revisar na próxima auditoria

Antes de apagar qualquer coisa, gere backup da pasta e do banco associado. Um subdomínio de homologação costuma compartilhar o banco com produção em instalação mal feita: apagar o banco "do teste" derruba a loja. Confira o DB_NAME no wp-config.php de cada um antes.

Para proteger em vez de apagar, a proteção por senha de diretório do cPanel é o caminho mais rápido e não depende do CMS. Bloqueio de indexação sozinho (robots.txt ou noindex) tira do buscador, mas não tira do alcance de quem varre IP.

Decisão por linha da planilhaVhost existe?Não: apagar registro DNS órfãoÉ addon domain?Sim: é site de cliente, manterEm uso ativo?Sim: proteger por senha e noindexSite vivo atrasado?Atualizar CMS, plugins e PHPNenhum dos casosBackup, remover subdomínio e DNS
Ordem de perguntas para fechar a coluna Decisão sem derrubar produção.

A frase que explica o risco para o cliente final

Quando o cliente perguntar por que mexer num endereço que "não atrapalha ninguém", use algo assim:

Funciona porque nomeia os dois riscos que o cliente entende (segurança e aparecer no Google) e oferece reversão.

Transformar o inventário em rotina trimestral

O inventário só vale se for repetido. Três hábitos que cabem na agenda de agência:

  1. Nomear com prazo. homolog-2026-03.dominio.com.br em vez de teste.dominio.com.br. O nome denuncia a validade.
  2. Registrar o dono na planilha. Toda linha tem uma pessoa responsável, não só uma conta cPanel.
  3. Revisar a cada trimestre, usando a mesma planilha e a mesma tela do WHM. A segunda passada leva uma fração do tempo da primeira, porque só as linhas novas precisam de investigação.

Se o inventário mostrar várias contas com instalações paradas e pasta grande, vale cruzar com o consumo de disco e inodes antes de sair apagando: às vezes o que parece sujeira é backup que alguém deixou no public_html, e a decisão correta é mover, não remover.

Referências

  1. Documentação oficial (cpanel) — List Subdomains (WHM). Consultado em 2026-10-04.
Leia também