Como Adicionar um Domínio ao cPanel: Guia Técnico Completo

Adicionar um domínio ao cPanel significa registar um nome de domínio adicional no painel de controlo de alojamento para que o servidor saiba para onde encaminhar os pedidos recebidos e de onde servir os ficheiros. No cPanel, isto é gerido através da interface Domains ou Addon Domains, que cria um diretório raiz de documentos dedicado, configura a entrada de host virtual e, opcionalmente, configura um subdomínio para gestão interna — tudo num único fluxo de trabalho.

Este guia abrange cada etapa desse processo em profundidade técnica: desde os pré-requisitos de DNS e configuração de domínio dentro do cPanel, passando pela implementação de ficheiros via File Manager, até ao aprovisionamento de base de dados MySQL. Aplica-se diretamente a qualquer ambiente VPS com cPanel, incluindo instâncias AlexHost VPS com LiteSpeed e armazenamento NVMe.

Pré-requisitos Antes de Adicionar um Domínio no cPanel

Ignorar o passo de DNS é a razão mais comum pela qual um domínio recém-adicionado falha na resolução. Antes de tocar no cPanel, confirme o seguinte:

• A propagação de DNS está em curso ou concluída. O registo A do seu domínio deve apontar para o endereço IP público do servidor. A propagação normalmente demora entre 15 minutos e 48 horas, dependendo do registador e dos valores de TTL.
• A sua conta cPanel tem slots de addon domain disponíveis. Num VPS com acesso root e WHM, isto é controlado por conta em “Modify an Account.” Nos planos partilhados, depende do pacote de alojamento.
• É proprietário ou controla o domínio. Se o registou noutro local, precisa de acesso ao painel de gestão de DNS do registador. Se precisar de um novo domínio, o registo de domínio através da AlexHost mantém a gestão de DNS centralizada.
• O SSL está planeado desde o início. Adicionar o domínio primeiro e depois solicitar um certificado é a ordem correta. O AutoSSL no cPanel tentará a emissão automaticamente assim que o domínio resolver para o servidor.

Passo 1: Adicionar o Domínio no cPanel

Inicie sessão na sua conta cPanel (normalmente em yourdomain.com:2083 ou através do link “Go to cPanel” do WHM).

Navegar para a Interface de Gestão de Domínios

No tema moderno Jupiter do cPanel, o fluxo de trabalho de gestão de domínios foi consolidado:

1. No ecrã inicial do cPanel, localize a secção Domains.
2. Clique em Domains (a interface unificada introduzida no cPanel 76+, que substitui os ícones separados mais antigos de “Addon Domains,” “Subdomains” e “Aliases”).
3. Clique no botão Create A New Domain no canto superior direito.

Configurar a Nova Entrada de Domínio

Verá um formulário com os seguintes campos:

• Domain: Introduza o nome de domínio completamente qualificado, por exemplo example.com. Não inclua www — o cPanel trata o alias de subdomínio www automaticamente.
• Document Root: O cPanel preenche automaticamente este campo com base no nome do domínio, normalmente resolvendo para /home/username/public_html/example.com. Pode substituir este caminho, mas o padrão é adequado para a maioria das implementações.
• Caixa de seleção Share document root with main domain: Deixe esta opção desmarcada, a menos que pretenda intencionalmente que este domínio sirva os mesmos ficheiros que o seu domínio principal. Marcar esta opção é um erro comum que faz com que ambos os domínios apresentem conteúdo idêntico.

Clique em Submit (ou Add Domain dependendo da sua versão do cPanel). O cPanel irá:

• Criar o diretório raiz de documentos.
• Escrever um novo bloco de configuração de host virtual Apache ou LiteSpeed.
• Criar uma entrada de subdomínio (ex.: example.com.yourmainaccount.com) para encaminhamento interno.
• Adicionar o domínio à fila SSL/TLS se o AutoSSL estiver ativado.

Verificar se o Domínio Foi Adicionado Corretamente

Após a submissão, regresse à lista de Domains. A nova entrada deve aparecer com o caminho do diretório raiz de documentos e uma opção para gerir o DNS. Se estiver a utilizar os servidores de nomes integrados do cPanel, clique em Manage ao lado do domínio para inspecionar a zona DNS e confirmar que o registo A aponta para o IP correto.

Passo 2: Carregar Ficheiros do Website via File Manager

Com o domínio configurado, o servidor está pronto para servir conteúdo a partir do diretório raiz de documentos. O próximo passo é implementar os ficheiros do seu website.

Aceder ao File Manager

1. No ecrã inicial do cPanel, abra o File Manager na secção Files.
2. Na árvore de diretórios do lado esquerdo, navegue para public_html/ e depois para a pasta com o nome do seu domínio (ex.: example.com/).
3. Em alternativa, o File Manager abre em public_html por padrão — pode navegar a partir daí.

Carregar Ficheiros como Arquivo

O File Manager do cPanel impõe um método de carregamento que requer que os ficheiros sejam empacotados num formato de arquivo. Carregar ficheiros individuais um a um é lento e, em muitas configurações de servidor, restrito por razões de desempenho.

Formatos de arquivo suportados para extração:

• .zip
• .tar.gz / .tgz
• .tar.bz2
• .gz

O procedimento correto de carregamento:

1. Comprima os ficheiros do seu website localmente num arquivo .zip. Para uma instalação WordPress, isto significa compactar todo o conteúdo do diretório do site (não a pasta em si, a menos que pretenda um nível de subdiretório extra).
2. Dentro do File Manager, navegue para a pasta raiz de documentos do seu domínio.
3. Clique em Upload na barra de ferramentas superior.
4. Selecione o seu ficheiro de arquivo e aguarde que o carregamento seja concluído. O File Manager mostra um indicador de progresso.
5. Após o carregamento terminar, clique em Go Back to o diretório.
6. Clique com o botão direito no arquivo carregado e selecione Extract. Confirme que o caminho de extração é o diretório atual.
7. Elimine o arquivo após a extração para manter o diretório raiz de documentos organizado.

Detalhe crítico: Se o seu arquivo contiver uma pasta de nível superior (ex.: mysite/index.php em vez de index.php na raiz), o seu site será servido a partir de example.com/mysite/ em vez de example.com/. Verifique sempre a estrutura de diretórios após a extração. Mova os ficheiros um nível acima usando a função Move do File Manager, se necessário.

Alternativa: Implementar via SFTP

Para sites maiores ou implementações automatizadas, o SFTP é significativamente mais eficiente do que o File Manager. Utilize um cliente SFTP (FileZilla, WinSCP, ou sftp na linha de comandos) com os seguintes parâmetros:

• Host: O endereço IP ou hostname do seu servidor
• Port: 22 (SSH/SFTP)
• Username: O nome de utilizador da sua conta cPanel
• Authentication: Palavra-passe ou par de chaves SSH

Navegue diretamente para /home/username/public_html/example.com/ e transfira os ficheiros. Este método contorna o requisito de arquivo e suporta transferências retomáveis.

Passo 3: Criar uma Base de Dados MySQL para o Seu Website

A maioria das plataformas CMS — WordPress, Joomla, Drupal, Magento — requer uma base de dados relacional. O cPanel fornece duas ferramentas para isso: MySQL Databases (controlo manual e granular) e MySQL Database Wizard (guiado, passo a passo). Para configurações simples, o Wizard é mais rápido.

Utilizar o MySQL Database Wizard

1. No início do cPanel, navegue para Databases > MySQL Database Wizard.
2. Passo 1 — Criar uma Base de Dados: Introduza um nome para a base de dados. O cPanel adiciona automaticamente o nome de utilizador da conta como prefixo (ex.: username_dbname). Anote este nome completo — vai precisar dele durante a instalação do CMS.
3. Passo 2 — Criar um Utilizador de Base de Dados: Introduza um nome de utilizador e uma palavra-passe forte. Utilize o Password Generator do cPanel para criar uma palavra-passe criptograficamente forte. O nome de utilizador completo também terá um prefixo (ex.: username_dbuser).
4. Passo 3 — Adicionar Utilizador à Base de Dados: Selecione o utilizador que acabou de criar e atribua privilégios. Para um CMS padrão, conceda All Privileges. Clique em Next Step.
5. O Wizard confirma a base de dados, o utilizador e a atribuição de privilégios. Registe os três valores: nome da base de dados, nome de utilizador e palavra-passe.

Utilizar MySQL Databases (Avançado)

Para ambientes que requerem múltiplos utilizadores com diferentes níveis de privilégio, ou ao gerir várias bases de dados por domínio:

1. Vá a Databases > MySQL Databases.
2. Crie a base de dados em Create New Database.
3. Desloque-se para baixo até Add New User e crie o utilizador com uma palavra-passe forte.
4. Em Add User to Database, selecione o utilizador e a base de dados, depois defina privilégios granulares (SELECT, INSERT, UPDATE, DELETE, etc.) em vez de ALL PRIVILEGES genérico.

Nota de segurança: Nunca utilize o mesmo utilizador de base de dados em vários sites na mesma conta. Se um site for comprometido, credenciais de base de dados isoladas limitam o movimento lateral para outras bases de dados.

Valor do Host da Base de Dados

Ao configurar o instalador do CMS, o host da base de dados é quase sempre localhost num VPS cPanel padrão. Isto deve-se ao facto de o servidor MySQL ser executado na mesma máquina e escutar no socket local. Utilizar 127.0.0.1 também funciona, mas força TCP em vez do socket Unix, adicionando uma sobrecarga mínima.

Passo 4: Configurar SSL para o Novo Domínio

Um domínio sem HTTPS será sinalizado pelos navegadores e penalizado nos rankings de pesquisa. A funcionalidade AutoSSL do cPanel (alimentada por Let’s Encrypt ou Sectigo dependendo da configuração do servidor) trata da emissão de certificados automaticamente assim que o domínio resolve corretamente.

Verificar a Cobertura AutoSSL

1. Navegue para Security > SSL/TLS Status.
2. O seu novo domínio deve aparecer na lista. Se o AutoSSL já tiver sido executado, mostrará um cadeado verde e a data de expiração.
3. Se o domínio aparecer como pendente ou com falha, clique em Run AutoSSL para desencadear uma tentativa imediata.

Razões comuns de falha do AutoSSL:

• O registo A do domínio ainda não aponta para o servidor (DNS não propagado).
• Um registo DNS CAA no domínio restringe a emissão a uma CA diferente.
• O domínio está atrás de um proxy (ex.: Cloudflare orange-cloud) que interceta o desafio ACME HTTP-01.

Para domínios que requerem validação estendida ou cobertura wildcard além do que o AutoSSL fornece, pode instalar um certificado SSL de terceiros manualmente através do SSL/TLS Manager do cPanel.

Addon Domains vs. Subdomínios vs. Parked Domains: Diferenças Principais

Compreender qual tipo de domínio adicionar evita configurações incorretas e tempo de resolução de problemas desperdiçado.

A interface moderna Domains do cPanel consolida estes numa única ecrã, mas o comportamento subjacente permanece distinto. Quando adiciona um domínio e deixa “Share document root” desmarcado, está a criar o que historicamente era chamado de Addon Domain.

Problemas Comuns e Como Resolvê-los

O Domínio Mostra “Index of /” (Listagem de Diretório)

Isto significa que o diretório raiz de documentos está vazio ou não tem um ficheiro index.php / index.html. Ou os seus ficheiros não foram carregados, ou foram extraídos para um subdiretório. Verifique a estrutura de ficheiros no File Manager.

Erro 500 Internal Server Error Após Carregamento

Normalmente causado por permissões de ficheiros incorretas ou um ficheiro .htaccess malformado. Verifique se os diretórios estão definidos para 755 e os ficheiros para 644. No File Manager, clique com o botão direito em qualquer ficheiro ou pasta e selecione Change Permissions.

Erro de Ligação à Base de Dados Durante a Instalação do CMS

Verifique novamente se está a utilizar o nome completo da base de dados e o nome de utilizador com prefixo (ex.: username_dbname, não apenas dbname). Confirme que a palavra-passe não tem caracteres especiais que possam ser mal interpretados pelo analisador de configuração do CMS — ou envolva o valor entre aspas no ficheiro de configuração.

O Domínio Resolve para o Site Errado

Se dois domínios na mesma conta resolverem para o mesmo conteúdo, o diretório raiz de documentos foi partilhado acidentalmente durante a configuração. Vá a Domains, edite a entrada e corrija o caminho do diretório raiz de documentos para o diretório dedicado.

Escalar Além de uma Única Conta cPanel

Quando supera uma única conta cPanel — seja em termos de número de domínios, volume de tráfego ou requisitos de isolamento de recursos — as opções de arquitetura divergem:

• Múltiplas contas cPanel num VPS via WHM: Cada conta tem os seus próprios limites de recursos, diretórios raiz de documentos e utilizadores de base de dados. Ideal para agências que gerem sites de clientes.
• Servidor dedicado com WHM/cPanel: Isolamento total de hardware, sem efeitos de vizinho ruidoso, e a capacidade de personalizar a configuração LiteSpeed ou Apache ao nível do servidor. Os servidores dedicados AlexHost suportam acesso root WHM completo.
• Múltiplas instâncias VPS: Cada VPS executa um ambiente cPanel independente. Útil quando os sites têm diferentes requisitos de segurança ou conformidade.

Para a maioria das implementações de pequena a média dimensão, uma única conta de VPS Hosting com cPanel a alojar 5–20 domínios é a arquitetura mais rentável. O armazenamento NVMe garante que mesmo operações de alta I/O como consultas de base de dados e cache de opcode PHP permaneçam rápidas em todos os domínios alojados.

Lista de Verificação de Pontos-Chave Técnicos

Antes de considerar um domínio totalmente operacional no cPanel, verifique cada item:

• Registo A de DNS aponta para o IP correto do servidor e propagou (verifique com dig example.com A ou um verificador de DNS online).
• Diretório raiz de documentos é um diretório dedicado, não partilhado com o domínio principal.
• Os ficheiros estão extraídos no nível de diretório correto — index.php deve estar diretamente dentro do diretório raiz de documentos, não dentro de um subdiretório.
• As permissões de ficheiros estão definidas para 755 para diretórios e 644 para ficheiros.
• As credenciais da base de dados (nome completo com prefixo, nome de utilizador, palavra-passe, host localhost) estão registadas e testadas.
• O certificado SSL está ativo e cobre tanto example.com como www.example.com.
• A renovação do AutoSSL ou certificado manual está confirmada — os certificados Let’s Encrypt expiram a cada 90 dias.
• .htaccess contém uma regra de redirecionamento HTTPS válida se pretender impor SSL.
• O alojamento de email para o novo domínio está configurado se necessário — a secção Email Accounts do cPanel, ou uma solução de alojamento de email dedicada se precisar de funcionalidades avançadas de entregabilidade.

FAQ

Adicionar um domínio no cPanel configura automaticamente o DNS?

Apenas se o seu domínio utilizar os servidores de nomes do cPanel. Se o domínio estiver registado noutro local e utilizar servidores de nomes externos, deve adicionar manualmente o registo A no seu registador ou fornecedor de DNS apontando para o IP do seu servidor. O cPanel cria o ficheiro de zona internamente, mas os resolvedores externos não o utilizarão a menos que o domínio delegue para os servidores de nomes do cPanel.

Quantos domínios posso adicionar a uma única conta cPanel?

O limite é definido no WHM na configuração da conta. Num VPS com acesso root, pode definir isto como ilimitado. Nos planos de alojamento partilhado gerido, o limite depende do nível do pacote. Não existe um limite técnico rígido no próprio cPanel — o limite prático é a capacidade de recursos do servidor.

Qual é a diferença entre o MySQL Database Wizard e o MySQL Databases no cPanel?

O Wizard guia-o através da criação da base de dados, criação de utilizador e atribuição de privilégios num fluxo linear de três passos — ideal para configurações rápidas. A interface MySQL Databases dá-lhe controlo granular sobre múltiplos utilizadores, atribuições individuais de privilégios e ferramentas de reparação/otimização de bases de dados. Para ambientes de produção com requisitos de segurança, utilize a interface manual.

Por que razão o meu domínio mostra uma página padrão do cPanel após ser adicionado?

A página padrão do cPanel (cgi-sys/defaultwebpage.cgi) aparece quando o diretório raiz de documentos está vazio. Carregue e extraia os ficheiros do seu site, ou coloque um ficheiro index.html no diretório raiz de documentos para o substituir imediatamente.

Posso adicionar um domínio ao cPanel sem acesso root ao servidor?

Sim. As contas de utilizador cPanel padrão (não-root) podem adicionar domínios até ao limite definido pelo fornecedor de alojamento. O acesso root só é necessário para alterar limites ao nível da conta, instalar software em todo o servidor ou modificar configurações fora do diretório home do utilizador cPanel.