blog
Domínios e DNS

Domínio abre o site de outro cliente no cPanel: 4 checagens

O servidor escolhe a pasta pelo cabeçalho Host, e quando nenhum virtual host casa com o nome ele entrega o primeiro da lista. Um teste com curl prova em qual pasta o domínio caiu antes mesmo de o DNS propagar.

JR · · 12 min de leitura · 2 tabelas · 9 blocos de código

Resposta curta: quatro checagens em ordem resolvem o caso: para qual IP o nome resolve, se esse IP é o da conta, se o domínio existe como vhost próprio e qual pasta ele aponta, e se a requisição está caindo no vhost de fallback. Reinstalar o WordPress não corrige nenhuma dessas causas.

Neste artigo
  1. A cadeia que decide qual pasta responde pelo nome digitado
  2. As quatro checagens antes de mexer em qualquer coisa
  3. Provar em qual pasta o nome cai sem esperar propagação
  4. Os três culpados por trás do mesmo sintoma
  5. Padronizar para manter dezenas de contas sem esse susto
  6. O texto para enviar ao cliente, com e sem culpa do DNS
  7. Quando as quatro checagens passam e o site continua errado

A cadeia que decide qual pasta responde pelo nome digitado

Quando alguém digita um domínio, quatro coisas acontecem em sequência e cada uma pode estar errada sozinha:

  1. Nome para IP. O resolvedor pergunta ao DNS qual endereço responde por aquele nome. Se a zona ainda aponta para o servidor antigo, acabou aqui: nada do que você fizer no cPanel muda o que o visitante vê.
  2. IP para servidor. O navegador abre conexão naquele IP, nas portas 80 e 443. Um mesmo IP atende dezenas ou centenas de sites.
  3. Host header para vhost. Na requisição, o navegador manda o cabeçalho Host: com o nome digitado. O Apache compara esse valor com o ServerName e os ServerAlias de cada virtual host configurado para aquele IP e porta. Em HTTPS, o SNI do handshake cumpre papel equivalente antes mesmo do cabeçalho.
  4. Vhost para document root. Cada vhost aponta para uma pasta. É dela que sai o conteúdo servido.

A documentação do cPanel sobre domínios e virtual hosts descreve exatamente esse desenho: cada domínio cadastrado numa conta ganha sua própria entrada de virtual host, com seu document root, e é essa entrada que faz o servidor saber qual conteúdo entregar para qual nome. O que a página cobre é esse mapeamento de domínio para vhost e para pasta.

O detalhe que explica o sintoma mais comum não está nessa página: ele é comportamento do Apache, o servidor web que o cPanel configura. Se nenhum vhost casar com o nome recebido, o Apache não devolve erro. Ele entrega a primeira definição de virtual host daquele IP e porta, que é o que a documentação do próprio Apache chama de default server para o endereço. É o vhost de fallback. Num servidor compartilhado, esse primeiro vhost costuma ser uma página padrão do servidor ou o site de outra conta. Daí a cena clássica: o domínio novo do cliente abre um site que não é dele, e a agência conclui que o WordPress foi instalado na pasta errada.

Na maioria das vezes não foi. O WordPress está intacto na pasta certa. O nome é que nunca chegou até ele.

Da digitação do domínio até a pasta servidaNome para IPDNS responde qual endereço atendeIP para servidorConexão nas portas 80 e 443Host header para vhostApache compara ServerName e ServerAliasVhost para pastaDocument root entrega o conteúdo
Se nenhum vhost casar com o nome, o Apache entrega o primeiro daquele IP e porta: o fallback.

As quatro checagens antes de mexer em qualquer coisa

Rode as quatro na ordem. A primeira que falhar é a causa, e as seguintes só confundem.

# Pergunta Onde se responde Sinal de problema
1 Para qual IP o nome resolve agora dig +short dominio A IP diferente do servidor onde você trabalha
2 Esse IP é o da conta Painel do cPanel, seção de informações gerais Resolve para o servidor, mas outro IP dedicado
3 O domínio existe como entrada própria Lista de domínios do cPanel Domínio ausente, ou presente com document root de outro site
4 A requisição está caindo no fallback curl com Host forçado, comparando com um nome inexistente Resposta idêntica à de um nome que ninguém cadastrou

Para qual IP o nome resolve agora, e quem manda na zona

dig +short exemplo-cliente.com.br A
dig +short www.exemplo-cliente.com.br A
dig +short NS exemplo-cliente.com.br

O terceiro comando diz quem manda na zona. Se os NS ainda são do registrador antigo ou do servidor antigo, o painel que você está editando não é o que responde ao mundo. Para pular cache de resolvedor e ler direto da fonte:

dig +short exemplo-cliente.com.br A @ns1.exemplo-dns.com

Consulte também www separadamente. É comum o domínio raiz estar certo e o www apontar para um CNAME antigo, o que produz "o site abre sem www e abre errado com www".

Confirmar se o IP que o DNS devolve é o IP da conta

O IP que o domínio resolve precisa ser o IP da conta cPanel onde o site mora. No cPanel, o painel de informações gerais mostra o endereço IP compartilhado da conta. Compare os dois valores com os olhos, caractere a caractere: 203.0.113.10 e 203.0.113.100 são servidores diferentes e a diferença passa despercebida com pressa.

Se o IP bate, o problema está dentro do servidor e as checagens 3 e 4 resolvem. Se não bate, pare: é DNS, registro ou propagação, e mexer em document root só vai criar um segundo problema para você depurar na semana que vem.

Uma exceção legítima: se o domínio está atrás de CDN ou proxy reverso, o dig devolve o IP do proxy e essa checagem "falha" sem que haja erro nenhum. Confirme que o IP pertence ao provedor de CDN contratado e, a partir daí, faça as checagens 3 e 4 apontando o curl --resolve para o IP de origem do servidor, não para o IP que o DNS entrega.

Se o domínio virou vhost próprio e para qual pasta ele aponta

Abra a interface de domínios do cPanel da conta. Ela lista cada domínio da conta com o document root correspondente. Três resultados possíveis:

Com acesso root ao servidor, o mapa completo sai de um comando:

apachectl -S

A saída lista, por IP e porta, cada namevhost com o arquivo e a linha de configuração que o definiu, e mostra qual é o default server daquele IP. É o vhost de fallback, nomeado. Filtre pelo domínio em questão:

apachectl -S 2>&1 | grep -i exemplo-cliente

Se o grep não retorna nada, o domínio não tem vhost e a resposta está dada.

Como saber se a requisição caiu no vhost de fallback

Este é o teste que ninguém faz e que encerra a discussão. Peça ao servidor uma página usando um nome que com certeza não existe em lugar nenhum, e compare com a resposta do domínio do cliente.

IP=203.0.113.10
curl -s --resolve nao-cadastrado.invalid:80:$IP http://nao-cadastrado.invalid/ | md5sum
curl -s --resolve exemplo-cliente.com.br:80:$IP http://exemplo-cliente.com.br/ | md5sum

Hashes iguais significam conteúdo idêntico: o domínio do cliente está sendo atendido pelo mesmo vhost que atende um nome inexistente, ou seja, pelo fallback. Hashes diferentes significam que algum vhost específico assumiu o nome, e aí a pergunta vira qual pasta ele aponta.

Duas ressalvas honestas sobre o md5sum: páginas dinâmicas com nonce, token de sessão ou horário no HTML mudam a cada requisição e vão gerar hashes diferentes mesmo saindo da mesma pasta. E um redirecionamento devolve corpo curto e parecido. Quando der ambíguo, use o arquivo sonda da próxima seção, que não tem essa fragilidade.

Ordem das quatro checagens antes de mexer1. Para qual IP o nome resolvedig +short dominio A e NS2. Esse IP é o da contaCompare com o IP no cPanel3. O domínio virou vhost próprioLista de domínios ou apachectl -S4. Caiu no vhost de fallbackcurl com Host forçado e sonda
Rode na ordem. A primeira checagem que falhar é a causa; as seguintes só confundem.

Provar em qual pasta o nome cai sem esperar propagação

--resolve faz o curl conectar no IP que você mandou mas enviar o Host e o SNI corretos do domínio. É o equivalente a ter o DNS já propagado, só para você, sem tocar em /etc/hosts e sem esperar TTL.

Arquivo sonda: o teste que não deixa margem a interpretação

Crie um arquivo com nome improvável em cada document root candidato, com conteúdo que identifique a pasta (exemplos fictícios):

echo "docroot: public_html (dominio principal)" > ~/public_html/_sonda.txt
echo "docroot: public_html/exemplo-cliente"     > ~/public_html/exemplo-cliente/_sonda.txt

Agora pergunte ao servidor de onde ele tira o arquivo quando o nome é o do cliente:

curl -s --resolve exemplo-cliente.com.br:80:203.0.113.10 \
     http://exemplo-cliente.com.br/_sonda.txt

A linha que voltar é a pasta que responde por aquele nome. Não há interpretação possível, e o teste funciona antes de o DNS mudar, o que permite validar uma migração inteira com o site antigo ainda no ar. Apague as sondas quando terminar.

O que o 301 e o erro de certificado já entregam antes do corpo

curl -sI --resolve exemplo-cliente.com.br:80:203.0.113.10 \
     http://exemplo-cliente.com.br/

Um 301 com Location: apontando para outro domínio é a assinatura do WordPress do vizinho: o nome caiu numa pasta com WordPress instalado, o WP comparou com o siteurl dele e redirecionou o visitante para o endereço dele mesmo. É por isso que a barra de endereço do navegador "muda sozinha" e o cliente jura que o site foi trocado.

Em HTTPS, o mesmo teste na porta 443 (--resolve dominio:443:IP com https://) pode falhar na validação do certificado justamente porque o vhost que respondeu apresenta o certificado de outro nome. Esse erro é informação, não obstáculo: ele confirma que quem atendeu não é o vhost do cliente. Para ver o conteúdo mesmo assim, acrescente -k e trate o resultado como diagnóstico, nunca como configuração aceitável.

Os três culpados por trás do mesmo sintoma

Causa O que o visitante vê Checagem que confirma Correção
Domínio resolve certo mas não foi adicionado na conta Site do domínio principal do servidor, site de outro cliente ou página padrão Checagem 4 com hash igual ao de um nome inexistente, ou ausência no apachectl -S Adicionar o domínio na conta correta, apontando para a pasta certa
Domínio adicionado com document root errado Conteúdo de outro site da mesma conta, ou pasta vazia com listagem e erro 403 Checagem 3 na lista de domínios, confirmada pelo arquivo sonda Ajustar o document root do domínio, ou mover os arquivos para a pasta que o vhost já usa
DNS ainda aponta para outro servidor Site antigo, versão desatualizada, ou página do servidor anterior Checagem 1, com IP diferente do IP da conta Corrigir A/CNAME ou os NS no registrador, e aguardar o TTL

O terceiro caso engana mais porque o site antigo geralmente funciona. O cliente diz "o site está no ar, mas com o conteúdo velho", e a agência vai procurar cache. Se o dig devolve um IP que não é o da conta, não existe cache para limpar: são dois sites diferentes em dois servidores diferentes, e o mundo ainda está vendo o primeiro.

E vale dizer o que não é culpa: uma instalação de WordPress corrompida não produz nenhum desses três sintomas. Reinstalar o WordPress não cria vhost, não muda document root e não altera DNS. Apaga o trabalho do cliente sem tocar na causa.

Padronizar para manter dezenas de contas sem esse susto

O erro de document root nasce de improviso na hora de criar o domínio. Convenção resolve.

Uma pasta por domínio, e nunca public_html puro

Auditar o mapa de nome e pasta do servidor inteiro

Com acesso root, o mapa inteiro do servidor sai em um comando e cabe numa revisão trimestral:

apachectl -S 2>&1 | grep -i namevhost | sort

Compare a lista com a sua planilha de clientes e procure dois padrões: domínio de cliente cuja configuração aponta para uma pasta de outro cliente, e domínio na planilha que não aparece na saída.

Em servidores cPanel, a configuração de cada domínio também costuma ficar registrada nos arquivos de dados de usuário, em /var/cpanel/userdata/USUARIO/, com uma chave documentroot por domínio. Esse caminho é convenção de instalação, não está descrito na página de domínios e virtual hosts citada acima, e pode mudar entre versões: confira no seu servidor antes de escrever qualquer rotina que dependa dele. O que a documentação garante é a relação domínio, vhost e document root, e essa relação você lê pelo apachectl -S ou pela interface de domínios.

Sem root, o equivalente é a lista de domínios de cada conta no cPanel, que já traz o document root ao lado de cada nome. Leva alguns minutos por conta e você faz isso uma vez, não toda vez que o telefone toca.

Checklist de publicação de domínio novo

  1. Criar a pasta com a convenção antes de cadastrar o domínio.
  2. Cadastrar o domínio na conta certa e conferir o document root na tela de confirmação.
  3. Validar com arquivo sonda via curl --resolve, antes de mexer no DNS.
  4. Só então alterar A, CNAME ou NS no registrador.
  5. Rodar dig +short para o domínio e para o www e conferir se ambos chegam ao IP da conta.
  6. Emitir o certificado depois que o nome resolve, porque a validação depende de o nome já cair no vhost certo.
  7. Repetir o curl -sI e conferir que não há Location: para outro domínio.

Os passos 3 e 7 são os que economizam a madrugada. Os demais todo mundo já faz.

O texto para enviar ao cliente, com e sem culpa do DNS

A pior frase possível é "deu problema no servidor". A segunda pior é "vamos reinstalar". Uma explicação curta, sem jargão e sem culpado, encerra o assunto:

Se a causa for DNS, troque a segunda frase:

Dois detalhes que evitam a pergunta seguinte: diga quanto tempo ("algumas horas") e diga o que o cliente deve fazer ("nada, e evite limpar cache repetidamente, porque isso não acelera nada").

Quando as quatro checagens passam e o site continua errado

Se o nome resolve para o IP da conta, o vhost existe, o document root é o certo e o arquivo sonda volta da pasta correta, o servidor está fazendo o trabalho dele. A partir daí o suspeito muda de andar:

Nenhum desses quatro se resolve recriando o site. Todos se identificam em menos de cinco minutos depois que você sabe, com prova, em qual pasta o nome caiu.

Referências

  1. Documentação oficial (cpanel) — How Your Server Handles Domains and Virtual Hosts. Consultado em 2026-09-25.
Leia também