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.

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
- O que o WHM de revenda mostra e o que fica fora do seu alcance
- A planilha de cinco colunas que você quer ter no fim
- Primeira passada, levantar a lista de subdomínios que existem de verdade
- Segunda passada, amarrar cada subdomínio ao seu document root
- Terceira passada, descobrir o que está instalado em cada pasta e em que versão
- Os quatro erros que fazem o inventário sair errado
- Decidir cada linha e executar sem derrubar produção
- A frase que explica o risco para o cliente final
- 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:
- Você vê as contas do seu pacote de revenda, não as do servidor inteiro.
- Você não tem acesso a telas de root como Terminal do WHM, SSH ou edição direta de configuração de serviços, salvo se o provedor liberar.
- O que sobra, e é suficiente para montar o inventário, é: List Accounts, List Subdomains, o Edit DNS Zone de cada domínio e o login em cada cPanel pelo botão de acesso da conta.
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.
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:
- Document root fora do
public_html. É comum e não é erro por si só, mas significa que umfindrestrito apublic_htmlnão vai enxergar aquele site. Anote o caminho completo. - Dois subdomínios com o mesmo document root. Conteúdo duplicado servido em dois endereços. Decida qual é o canônico.
- Subdomínio apontando para pasta que não existe mais. O vhost responde, o conteúdo sumiu. Candidato direto a apagar.
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.
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:
- Nomear com prazo.
homolog-2026-03.dominio.com.brem vez deteste.dominio.com.br. O nome denuncia a validade. - Registrar o dono na planilha. Toda linha tem uma pessoa responsável, não só uma conta cPanel.
- 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
- Documentação oficial (cpanel) — List Subdomains (WHM). Consultado em 2026-10-04.