A ferramenta Domains do cPanel associa hostnames a diretórios da conta. A raiz de documento é a pasta da qual os arquivos serão publicados. Apontar dois domínios para a pasta errada, mover o diretório sem atualizar a aplicação ou remover uma associação sem inventário pode tirar mais de um site do ar.
Conceitos essenciais
| Item | Função |
|---|---|
| domínio principal | hostname base associado à conta; algumas propriedades dependem do provedor |
| domínio adicional | outro domínio servido pela mesma conta, geralmente com pasta própria |
| subdomínio | nome abaixo de um domínio, como loja.exemplo.com |
| alias | domínio que exibe ou redireciona para o mesmo conteúdo, conforme configuração |
| document root | diretório público associado ao hostname |
Planeje a estrutura
Para sites independentes, prefira uma pasta distinta por site e nomes fáceis de identificar. Compartilhar public_html pode ser intencional para aliases, mas também aumenta o risco de sobrescrever arquivos e misturar regras. Conteúdo sensível, backup e configuração não devem ficar publicamente acessíveis.
Adicionar um domínio
- Confirme que o domínio está registrado e quais nameservers são autoritativos.
- No cPanel, abra Domains e escolha criar novo domínio.
- Digite o hostname sem caminho ou protocolo.
- Decida conscientemente se compartilhará a raiz do domínio principal. Para site separado, desmarque o compartilhamento e informe uma pasta dedicada.
- Salve e confira a associação antes de enviar arquivos.
- Configure DNS, aguarde propagação e execute o AutoSSL.
Alterar a raiz de documento
Nem toda versão ou política permite alterar diretamente a raiz de todos os tipos de domínio. Quando disponível, confirme a pasta absoluta relativa à conta e se ela contém o ponto de entrada correto, como index.php. A mudança não move arquivos automaticamente, não altera URLs no banco e não corrige caminhos da aplicação.
- Faça backup dos arquivos e do banco.
- Mapeie aliases, subdomínios, redirects, cron jobs e configurações que usam o caminho antigo.
- Prepare a nova pasta com permissões corretas.
- Altere a associação em período de baixo acesso.
- Teste página inicial, URLs internas, login, upload, formulário, cron e HTTPS.
- Conserve a pasta antiga até confirmar a mudança; depois trate sua remoção como ação separada.
DNS e conteúdo são camadas diferentes
Adicionar um domínio ao cPanel não muda automaticamente DNS hospedado em outro provedor. Da mesma forma, apontar o A/AAAA para o servidor não cria a associação interna. Os dois lados devem estar corretos. Se houver CDN, o IP público visto no DNS pode ser o do proxy.
HTTPS e AutoSSL
O certificado só pode ser emitido após o domínio validar por método aceito e apontar corretamente. Remova registros antigos, confira CAA e não force HTTPS antes de o certificado estar válido. Depois, escolha um único mecanismo de redirecionamento.
Remover um domínio com segurança
Remover a associação não equivale necessariamente a apagar arquivos, banco, caixas ou DNS; o comportamento depende da ferramenta. Antes:
- confirme o domínio exato e a raiz associada;
- verifique se outra entrada compartilha a mesma pasta;
- exporte banco e arquivos;
- liste e-mails, redirects, subdomínios, SSL, cron e integrações;
- planeje redirecionamento SEO se o conteúdo migrou;
- não exclua a pasta durante a mesma ação sem validação independente.
Problemas comuns
- mostra o site principal: raiz compartilhada ou virtual host ainda não reconhecido;
- 403: índice, regra ou permissão;
- 404 em páginas internas: rewrite ou URL-base;
- redireciona para domínio antigo: aplicação, cache, CDN ou regra ainda usa hostname anterior;
- certificado inválido: AutoSSL pendente ou validação DNS/HTTP falhou;
- site abre em uma rede e não em outra: propagação, cache ou IPv6 divergente.
Continue com como adicionar domínio no cPanel, Zone Editor, AutoSSL, loop de redirecionamento e Gerenciador de Arquivos.
Referência oficial: cPanel — Domains.
Recursos relacionados
Continue com tutoriais, ferramentas e serviços relacionados ao diagnóstico.
Assistente IA WGS