# 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.

> 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.

João Rizzon · 2026-10-05 · Revenda

---

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](https://docs.cpanel.net/whm/account-information/list-subdomains/)). 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:

```bash
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:

```bash
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 um `find` restrito a `public_html` nã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:

```bash
# 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:

> **** Esse endereço de teste continua no ar e continua sendo uma cópia do site, com uma versão de software que não recebe correção de segurança desde que foi criado. Ele pode ser invadido e usado para enviar spam ou publicar página falsa no seu domínio, e o Google pode indexar essa cópia no lugar do site oficial. Vamos fazer backup e tirar do ar; se precisar dele de volta, restauramos.

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.br` em vez de `teste.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.

