Domínios personalizados

Todo projeto HTTP criado na Zenifra recebe automaticamente um subdomínio gratuito da plataforma. Esse endereço permite acessar a aplicação sem comprar ou configurar um domínio próprio.

O formato padrão é:

nome-do-projeto.clients.zenifra.com

Esse subdomínio pode ser usado para testes, validação inicial, ambientes internos ou como fallback operacional. Para produção, você também pode conectar um domínio próprio, como:

meusite.com.br
www.meusite.com.br
app.meusite.com.br

Como funciona a conexão de domínio

Para conectar um domínio próprio a uma aplicação hospedada na Zenifra, siga este fluxo geral:

Crie o projeto na Zenifra.
Informe o domínio desejado no painel da Zenifra.
Configure os registros DNS no provedor onde o domínio está hospedado.
Aguarde a validação do DNS e a emissão do certificado SSL.

Importante: O destino DNS que deve ser usado ficará disponível no painel da Zenifra após a criação do projeto. Para projetos HTTP, esse destino normalmente é um endereço como nome-do-projeto.clients.zenifra.com.

Não use IPs encontrados em exemplos, prints antigos ou respostas de suporte fora do contexto do seu projeto. O valor correto é sempre o exibido no painel da Zenifra para aquele domínio e projeto. Para domínios personalizados na Zenifra, os registros que o cliente precisa configurar são CNAME para roteamento e TXT para validação SSL.

Depois que o DNS aponta corretamente, a Zenifra valida o domínio e configura automaticamente o roteamento interno para enviar o tráfego para a aplicação correta. A Zenifra também cuida da configuração HTTPS/SSL para o domínio personalizado após a validação do DNS.

Domínio raiz e subdomínio

Antes de criar os registros DNS, identifique se você quer apontar o domínio raiz ou um subdomínio.

Domínio raiz

O domínio raiz é o endereço principal registrado no provedor do domínio:

seudominio.com.br

Ele também pode aparecer como domínio apex ou naked domain em alguns provedores DNS.

Subdomínio

Subdomínios são nomes criados abaixo do domínio raiz:

www.seudominio.com.br
app.seudominio.com.br
sistema.seudominio.com.br

Use subdomínios quando quiser separar aplicações, ambientes ou áreas do produto, como site público, painel administrativo e API.

Tipos de registros DNS

Use os registros indicados no painel da Zenifra. A tabela abaixo resume os casos mais comuns.

Caso	Tipo	Nome, Host ou Name	Valor
Domínio raiz em provedor com flattening	CNAME com flattening	`@`	`endereço CNAME exibido no painel da Zenifra`
Subdomínio `www`	CNAME	`www`	`endereço CNAME exibido no painel da Zenifra`
Subdomínio `app`	CNAME	`app`	`endereço CNAME exibido no painel da Zenifra`

Em alguns provedores DNS, o campo pode se chamar Nome, Host ou Name. Normalmente, esses campos aceitam:

@ para o domínio raiz, como seudominio.com.br
www para www.seudominio.com.br
app para app.seudominio.com.br

Configurar domínio raiz

Um CNAME comum normalmente não pode ser usado diretamente no domínio raiz, como seudominio.com.br. Isso é uma regra comum de DNS e aparece em provedores como Registro.br, onde o root (@) não aceita CNAME.

Para usar o domínio raiz com a Zenifra, escolha uma das alternativas abaixo.

Opção recomendada: provedor com CNAME flattening

Use um provedor DNS que suporte CNAME flattening, como Cloudflare ou outro provedor com recurso equivalente. Nesse caso, configure um CNAME no domínio raiz apontando para o destino exibido no painel da Zenifra.

Tipo: CNAME
Nome: @
Valor: endereço CNAME exibido no painel da Zenifra

Na Cloudflare, por exemplo, você pode cadastrar um CNAME no root (@) e a própria Cloudflare faz o flattening para respostas compatíveis com DNS.

Quando o provedor não suporta CNAME no root

Se o provedor atual não permite CNAME no root e não oferece CNAME flattening, existem duas opções práticas:

mover a zona DNS para um provedor que suporte flattening, como Cloudflare
manter o domínio raiz fora da Zenifra e redirecionar seudominio.com.br para www.seudominio.com.br usando um serviço externo que suporte HTTPS no root

O Registro.br pode continuar como registrador do domínio, mesmo quando os nameservers autoritativos são movidos para outro provedor DNS.

Não aponte o root para IPs copiados do CNAME da Zenifra, de respostas DNS da Cloudflare ou de exemplos antigos. Esse tipo de configuração pode funcionar por acaso em um momento específico, mas é frágil e pode quebrar sem aviso.

Configurar subdomínios

Para subdomínios, como www, app ou sistema, crie um registro do tipo CNAME apontando para o endereço exibido no painel da Zenifra.

Exemplo para www.seudominio.com.br:

Tipo: CNAME
Nome: www
Valor: endereço CNAME exibido no painel da Zenifra

Exemplo para app.seudominio.com.br:

Tipo: CNAME
Nome: app
Valor: endereço CNAME exibido no painel da Zenifra

Não crie registros conflitantes para o mesmo nome. Por exemplo, www deve ter apenas o CNAME indicado pela Zenifra, além dos TXT de validação quando forem solicitados.

Exemplo de configuração DNS

Suponha que você queira configurar o domínio raiz e o www do seu domínio próprio na Zenifra. Depois de criar o projeto e informar os domínios no painel, crie registros como estes no provedor DNS.

Para o domínio raiz, quando o provedor suporta flattening:

Tipo: CNAME
Nome: @
Valor: endereço CNAME exibido no painel da Zenifra

Para o www:

Tipo: CNAME
Nome: www
Valor: endereço CNAME exibido no painel da Zenifra

Depois de salvar os registros, volte ao painel da Zenifra e aguarde a validação. A propagação pode levar alguns minutos ou até algumas horas, dependendo do provedor DNS.

Validação, roteamento e HTTPS

Quando os registros DNS propagam, a Zenifra verifica se o domínio aponta para o destino esperado. Após essa validação, a plataforma configura o roteamento interno para que as requisições do domínio personalizado cheguem à aplicação correta.

O HTTPS também é configurado pela Zenifra. A emissão do certificado SSL depende do DNS estar apontando corretamente e pode exigir registros TXT de validação.

Registros TXT de validação SSL

Durante a emissão do certificado, o painel da Zenifra pode exibir um ou mais registros TXT com nome parecido com este:

Tipo: TXT
Nome: _acme-challenge.www.seudominio.com.br
Valor: token de validação exibido no painel da Zenifra

Se o painel exibir dois registros TXT com o mesmo nome, publique os dois valores. Isso é normal em validações ACME/TLS. Não substitua um token pelo outro.

Tipo: TXT
Nome: _acme-challenge.www.seudominio.com.br
Valor: primeiro-token

Tipo: TXT
Nome: _acme-challenge.www.seudominio.com.br
Valor: segundo-token

Enquanto o certificado estiver em validação, o domínio pode já aparecer como cadastrado, mas o HTTPS ainda pode falhar. Aguarde o status SSL ficar ativo antes de considerar a configuração concluída. Se o certificado ainda não foi emitido, verifique se todos os registros TXT foram salvos corretamente e aguarde a propagação antes de abrir suporte.

Boas práticas

Use domínio raiz e www quando possível, especialmente em aplicações públicas.
Evite alterar registros DNS sem entender o impacto em email, site, APIs e outros serviços.
Confira se não há registros conflitantes para o mesmo nome; mantenha apenas o CNAME indicado pela Zenifra e os TXT de validação necessários.
Para domínio raiz, prefira provedor DNS com CNAME flattening.
Publique todos os registros TXT de validação exibidos no painel; múltiplos TXT com o mesmo nome podem ser necessários.
Aguarde a propagação do DNS antes de abrir suporte.
Mantenha o domínio ativo e renovado no registrador.
Mantenha o subdomínio gratuito da Zenifra como referência operacional durante a configuração inicial.

Próximos passos

FAQ

Posso usar um domínio próprio na Zenifra?

Sim. Além do subdomínio gratuito da Zenifra, você pode conectar um domínio próprio ao projeto, como meusite.com.br, www.meusite.com.br ou app.meusite.com.br, conforme os recursos disponíveis no plano.

Onde encontro o destino para configurar o DNS?

O destino DNS aparece no painel da Zenifra depois que o projeto foi criado e o domínio foi informado. Para projetos HTTP, esse destino normalmente é um endereço na zona clients.zenifra.com. Use sempre o valor exibido no painel do projeto correspondente.

Posso usar CNAME no domínio raiz?

Normalmente, não como CNAME comum. Para apontar o domínio raiz para a Zenifra, use um provedor DNS com CNAME flattening, onde o registro configurado continua sendo um CNAME, ou redirecione o domínio raiz para www com um serviço externo que suporte HTTPS.

Registro.br permite CNAME no domínio raiz?

Não no modelo comum de DNS. Se o domínio usa DNS autoritativo do Registro.br e você precisa apontar seudominio.com.br para a Zenifra, use um provedor DNS com CNAME flattening, ou configure um redirecionamento HTTPS do root para www.

Quanto tempo demora para o DNS propagar?

O DNS pode levar alguns minutos ou até algumas horas para propagar, dependendo do provedor DNS, do TTL configurado e da rede usada para acessar o domínio.

A Zenifra configura HTTPS automaticamente?

Sim. Após o DNS apontar corretamente e o domínio ser validado, a Zenifra configura HTTPS/SSL automaticamente para o domínio personalizado.

Por que o HTTPS ainda não funciona se o CNAME já está correto?

Porque a emissão do certificado também pode depender de registros TXT em _acme-challenge. Se houver dois tokens TXT para o mesmo nome, publique os dois. Depois que os registros propagarem, a autoridade certificadora ainda pode levar alguns minutos para emitir e ativar o certificado.

Preciso usar Cloudflare?

Não. Você não precisa obrigatoriamente usar Cloudflare. Pode manter o domínio no provedor DNS atual, desde que consiga criar os registros DNS necessários. Para domínio raiz, o provedor precisa oferecer CNAME flattening se você quiser apontar o root diretamente para a Zenifra.

Posso usar www e domínio raiz ao mesmo tempo?

Sim. Você pode configurar seudominio.com.br e www.seudominio.com.br para o mesmo projeto, desde que ambos sejam adicionados no painel da Zenifra e tenham os registros DNS corretos.

Nessa Página