O gerenciamento eficiente de múltiplos projetos, sites pessoais ou aplicações web é uma das principais razões pelas quais profissionais de TI e desenvolvedores optam por uma vps linux em vez de hospedagens compartilhadas tradicionais. A flexibilidade oferecida por um servidor privado virtual (VPS) permite o controle total sobre a infraestrutura, mas exige que você domine as ferramentas de gerenciamento disponíveis. O cpanel em vps surge como a solução ideal para simplificar essa complexidade, oferecendo uma interface gráfica intuitiva para tarefas críticas de administração.
Dentro do ecossistema do Cpanel, dois recursos são fundamentais para quem precisa hospedar mais de um domínio: os addon domains (domínios adicionais) e os subdomínios. Embora ambos permitam a criação de novos pontos de entrada na sua infraestrutura, eles servem propósitos distintos e possuem implicações diferentes em termos de configuração DNS, estrutura de diretórios e segurança. Este cpanel tutorial detalha o processo completo de configuração dessas ferramentas, garantindo que você otimize sua configuração web e mantenha um ambiente organizado e seguro.
1. Preparação do Ambiente e Requisitos Iniciais
Antes de iniciar a criação de domínios ou subdomínios no Cpanel, é essencial garantir que o servidor esteja preparado para receber essas configurações. O gerenciamento de domínios eficaz começa muito antes de clicar nos botões da interface gráfica; ele depende da resolução correta de nomes e da permissão adequada do sistema operacional.
Primeiramente, verifique se os registros DNS dos seus domínios apontam corretamente para o endereço IP da sua VPS. Se você estiver usando um servidor DNS externo (como Cloudflare ou GoDaddy), certifique-se de que os registros A estão configurados. Se estiver gerenciando o DNS diretamente no Cpanel, a ferramenta criará esses registros automaticamente durante o processo, mas é válido compreender como isso funciona.
Além disso, tenha em mãos as credenciais de acesso root ou sudo do seu servidor Linux. Embora a maioria das tarefas possa ser feita via interface web, ter acesso SSH permite diagnosticar problemas de permissão ou falhas na criação de diretórios que podem surgir durante o processo.
2. Compreendendo a Diferença entre Addon Domains e Subdomínios
Muitos usuários iniciantes confundem esses dois conceitos. Para evitar erros de configuração web, é crucial entender a arquitetura subjacente:
- Subdomínio: É uma extensão do seu domínio principal (ex:
blog.seudominio.com.br). No Cpanel, ele compartilha o mesmo espaço de usuário raiz, mas possui um diretório dedicado. É ideal para projetos menores, áreas de teste ou seções específicas que não justificam a compra de um domínio separado. - Addon Domain: É um domínio totalmente distinto (ex:
outro-site.com) hospedado no mesmo servidor e na mesma conta Cpanel. Ele possui seu próprio espaço de usuário, certificado SSL independente e configurações de segurança isoladas. É a escolha correta para projetos comerciais ou pessoais que exigem uma identidade web própria.
Ao escolher entre addon domains e subdomínios, considere se você precisa de isolamento completo. Se o projeto A e o projeto B não devem compartilhar sessões ou arquivos, utilize um Addon Domain. Se são partes complementares do mesmo negócio, um Subdomínio pode ser mais simples.
3. Criando um Subdomínio no Cpanel
A criação de subdomínios é uma das tarefas mais rápidas no Cpanel. Este processo configura automaticamente os registros DNS necessários e cria a estrutura de pastas.
- Acesse o Módulo: Faça login no seu painel Cpanel. Na seção "Domains" (Domínios), clique em Subdomains.
- Defina o Nome: No campo "Create a New Subdomain", insira o prefixo desejado. Por exemplo, se você digitar
dev, o Cpanel criarádev.seudominio.com.br. - Selecione o Domínio: Escolha o domínio raiz ao qual o subdomínio será vinculado. Se houver apenas um domínio na conta, ele já estará selecionado.
- Diretório Raiz: O Cpanel preencherá automaticamente o caminho do diretório (geralmente
/home/usuario/public_html/dev). Você pode alterar isso se desejar uma estrutura personalizada, mas o padrão é seguro e recomendado para a maioria dos casos. - Criar: Clique no botão Create.
Após a criação, o Cpanel adicionará um registro DNS do tipo A apontando para o IP do servidor. O diretório criado estará vazio. Para testar, você pode criar um arquivo index.html dentro de /home/usuario/public_html/dev.
Se precisar verificar se o registro DNS foi propagado corretamente via linha de comando no seu terminal Linux, utilize:
dig dev.seudominio.com.br +short
O resultado deve ser o endereço IP da sua VPS.
4. Configurando Addon Domains (Domínios Adicionais)
A configuração de addon domains é ligeiramente mais complexa, pois envolve a vinculação de um domínio externo à sua conta atual. Siga os passos abaixo para realizar essa tarefa com sucesso.
- Navegue até a Ferramenta: No painel Cpanel, vá em "Domains" e clique em Addon Domains.
- Insira o Novo Domínio: No campo "New Domain Name", digite o nome completo do domínio que deseja adicionar (ex:
meuprojeto.com.br). O Cpanel detectará automaticamente se você tentar usar um subdomínio já existente e alertará sobre o conflito. - Diretório Raiz: Defina a pasta onde os arquivos do site serão armazenados. O padrão é
/home/usuario/meuprojeto.com.br/public_html. Essa estrutura mantém seus projetos separados dentro do seu diretório home, facilitando backups e gestão de permissões. - Subdomínio e Conta de E-mail: O Cpanel oferece a opção de criar automaticamente um subdomínio correspondente (ex:
www.meuprojeto.com.br) e uma conta de e-mail. Isso é altamente recomendável para garantir que o "www" funcione corretamente desde o início. - Criar: Clique em Create.
Ao finalizar, o Cpanel criará a estrutura de diretórios, configurará os registros DNS (se você usar o DNS do Cpanel) e provisionará as permissões necessárias. Se você estiver usando um servidor DNS externo, lembre-se de adicionar manualmente um registro A para o domínio e outro para "www" apontando para o IP da VPS.
5. Configuração Avançada via SSH: Verificando Estruturas de Diretórios
Embora a interface gráfica seja poderosa, um profissional de TI deve saber validar o que acontece nos bastidores. Após criar um Addon Domain, é prudente verificar se as permissões e a estrutura de pastas estão corretas no sistema de arquivos Linux.
Acesse seu servidor via SSH e navegue até o diretório home do usuário:
cd /home/usuario
Liste os conteúdos para ver as novas pastas criadas:
ls -la
Você deverá encontrar uma pasta com o nome do domínio (ex: meuprojeto.com.br). Dentro dela, haverá um diretório public_html. É dentro desta pasta que você deve enviar os arquivos da sua aplicação web.
Verifique as permissões. O proprietário dos arquivos deve ser o usuário do Cpanel e não root ou outro usuário:
chown -R usuario:usuario /home/usuario/meuprojeto.com.br/public_html
Embora o Cpanel geralmente gerencie isso automaticamente, erros de upload via FTP podem alterar proprietários. Corrigir isso preventivamente evita erros 403 Forbidden.
6. SSL/TLS e Segurança: Habilitando HTTPS
Nenhuma configuração web moderna está completa sem criptografia. O Cpanel facilita enormemente a instalação de certificados SSL gratuitos através do Let's Encrypt, mas é importante entender como isso afeta seus domínios.
Para Subdomínios:
Vá em "Security" > "Let's Encrypt SSL". Selecione o domínio principal e os subdomínios desejados na lista. Clique em "Issue". O Cpanel gerará um certificado que pode cobrir o domínio base e seus subdomínios (Wildcard), dependendo da configuração, ou certificados individuais.
Para Addon Domains:
O processo é similar. No módulo "Let's Encrypt SSL", você verá uma lista de todos os domínios associados à conta, incluindo os Addon Domains criados anteriormente. Selecione o novo domínio e clique em "Issue".
Se você preferir gerenciar certificados manualmente via linha de comando (para fins de aprendizado ou automação), pode usar o Certbot:
sudo certbot --apache -d meuprojeto.com.br -d www.meuprojeto.com.br
No entanto, no contexto de cpanel em vps, a integração nativa é geralmente mais segura contra erros de configuração de redirecionamento HTTP para HTTPS.
7. Gerenciamento de DNS e Resolução de Problemas Comuns
O gerenciamento de domínios frequentemente esbarra em questões de propagação DNS. Se você acabou de criar um Addon Domain ou Subdomínio e ele não está acessível, siga estes passos de diagnóstico.
1. Verifique a Propagação: Use ferramentas online como "DNS Checker" ou o comando nslookup em diferentes locais para ver se o novo registro foi propagado globalmente.
nslookup meuprojeto.com.br
2. Valide os Registros no Cpanel: Vá em "Domains" > "Zone Editor". Certifique-se de que existe um registro A para o domínio/subdomínio apontando para o IP correto. Se estiver usando DNS externo, essa pasta mostrará apenas o que está configurado no Cpanel; ignore se você usa Cloudflare ou similar.
3. Teste de Conectividade: Verifique se o serviço Apache/Nginx está rodando e escutando na porta 80 (HTTP) e 443 (HTTPS).
sudo systemctl status httpd
# Ou, em sistemas Debian/Ubuntu:
sudo systemctl status apache2
4. Logs de Erro: Se o site carrega mas mostra erro 500, verifique os logs de erro do domínio específico. No Cpanel, isso pode ser feito via "Metrics" > "Errors". Via SSH, os logs costumam estar em:
/home/usuario/domains/meuprojeto.com.br/public_html/error_log
A análise desse arquivo é a chave para resolver problemas de scripts PHP ou configurações .htaccess incorretas.
8. Boas Práticas de Organização e Manutenção
Para manter sua VPS performática e segura ao longo do tempo, adote as seguintes práticas ao utilizar addon domains e subdomínios:
- Isolemento de Usuários: Se possível, para projetos críticos, considere usar contas de usuário separadas no Linux. Embora o Cpanel permita múltiplos domínios em uma conta, a separação total oferece maior segurança contra invasões que explorem vulnerabilidades entre sites.
- Backups Regulares: Configure backups automáticos no Cpanel (se sua licença permitir) ou utilize scripts de backup via cron que copiem os diretórios
/home/usuariopara um local externo. Lembre-se: se você usa Addon Domains, seus arquivos estão dentro do home do usuário, facilitando a cópia. - Monitoramento de Disco: Cada novo domínio ocupa espaço. Monitore o uso de disco com
df -hedu -sh /home/usuario/*para identificar rapidamente se algum projeto está consumindo recursos desproporcionalmente.
Conclusão
A configuração de subdomínios e addon domains no Cpanel é uma habilidade essencial para quem gerencia infraestrutura na nuvem. Ao dominar essas ferramentas, você transforma sua vps linux em uma plataforma versátil capaz de hospedar múltiplos projetos com isolamento e segurança adequados.
Lembre-se que a linha entre usar um subdomínio ou um addon domain depende da sua necessidade de isolamento e identidade de marca. Sempre valide as configurações DNS, garanta a presença de certificados SSL e mantenha uma estrutura de diretórios organizada. Com esses fundamentos estabelecidos, você estará preparado para escalar suas operações de hospedagem virtual com confiança e profissionalismo.
Para mais dicas sobre otimização de servidor e segurança, continue acompanhando nossos conteúdos especializados em infraestrutura e desenvolvimento web.