Como registrar um subdomínio para um aplicativo ou API diferente do site principal
Oi! Aqui é a Sensei da GeHost 🥋 Hoje vamos aprender uma técnica bem útil: criar um subdomínio pra rodar algo separado do seu site principal — por exemplo, um aplicativo em app.seudominio.com.br ou uma API em api.seudominio.com.br, sem misturar tudo dentro do mesmo endereço. Vem comigo que é mais simples do que parece!
O que é um subdomínio, afinal?
Pensa no seu domínio como uma casa (seudominio.com.br). Um subdomínio é como um "anexo" dessa casa, com porta própria — ele usa o mesmo domínio, mas funciona como um endereço independente. Assim você consegue, por exemplo:
- Ter um aplicativo web separado do site (ex.: app.seudominio.com.br)
- Expor uma API só pra integrações (ex.: api.seudominio.com.br)
- Criar uma área de testes/homologação sem afetar o site que está no ar (ex.: staging.seudominio.com.br)
💡 Dica da Sensei: o subdomínio não é um domínio novo — você não paga nem registra ele separadamente. Ele "nasce" a partir do domínio que você já tem hospedado com a gente.
Passo a passo: criando o subdomínio no cPanel
Todo o gerenciamento é feito dentro do cPanel da sua hospedagem. Se você ainda não sabe como acessar, dá uma olhada no e-mail de boas-vindas que enviamos na contratação, ou fale com o nosso suporte que a gente te ajuda.
- Faça login no seu cPanel.
- Na tela inicial, procure o grupo de ferramentas relacionado a Domínios e clique na opção de Subdomínios.
- No campo de nome, digite a palavra que vai identificar essa área — por exemplo app ou api (sem o resto do domínio, ele completa sozinho).
- Confirme se o domínio principal selecionado é o correto (caso você tenha mais de um domínio na conta).
- No campo de pasta (document root), você pode manter a sugestão automática ou indicar a pasta onde vai ficar o aplicativo/API — assim ele fica separado dos arquivos do site principal.
- Clique em criar/adicionar. Pronto, seu subdomínio já existe! 🎉
A partir daqui, é só subir os arquivos do seu app ou da sua API dentro da pasta que você definiu, usando o Gerenciador de Arquivos ou um cliente FTP.
Seu app/API roda em outro lugar (fora da GeHost)? Aponte pelo Editor de Zona de DNS
Às vezes o aplicativo ou a API não fica hospedado com a gente — está em outro serviço (uma plataforma de nuvem, por exemplo). Nesse caso, em vez de criar o subdomínio pelo passo acima, você aponta o subdomínio direto pra esse serviço externo usando o Editor de Zona de DNS.
- No cPanel, acesse o Editor de Zona de DNS.
- Selecione o domínio correspondente e clique para gerenciar os registros dele.
- Adicione um novo registro do tipo:
- CNAME — se o serviço externo te deu um "endereço" (algo como meuapp.provedor.com) pra apontar;
- A — se o serviço te deu um número de IP pra apontar.
- No campo de nome, digite o subdomínio desejado (ex.: api) e, no valor, cole exatamente o endereço ou IP que o serviço externo te passou.
- Salve o registro.
⏳ Dica da Sensei: alterações de DNS podem levar um tempinho pra propagar (às vezes minutos, às vezes um pouco mais) até funcionar em todo lugar. Se não abrir na hora, respira e tenta de novo daqui a pouco.
Erros comuns (pra você não cair neles)
- Confundir subdomínio com pasta: um subdomínio precisa ser criado na ferramenta de Subdomínios (ou apontado via DNS) — só criar uma pasta dentro do site não faz o endereço funcionar.
- Apontar errado no DNS: confira com atenção se o valor colado no CNAME/A é exatamente o que o serviço externo pediu, sem espaços a mais.
- Misturar arquivos do site com os do app/API: use uma pasta separada pra cada subdomínio, assim fica tudo organizado e você evita dor de cabeça no futuro.
Se em algum momento ficar com dúvida ou travar em algum passo, é só chamar o nosso suporte — a gente tem prazer em te ajudar a deixar tudo funcionando certinho. Até a próxima aula! 🥋