blog
Fundamentos

DNS explicado: como seu domínio vira um site

Você comprou um domínio, mas como ele se conecta ao seu app? Entenda DNS de forma simples — sem precisar ser engenheiro de redes.

hidden: true

TL;DR

DNS é a agenda de contatos da internet. Quando alguém digita meuapp.com.br, o DNS traduz isso para o endereço IP do servidor onde seu app mora. Sem DNS, as pessoas teriam que digitar números como 76.76.21.21 para acessar sites.

hidden: true

O problema que o DNS resolve

Computadores se encontram na internet usando números chamados endereços IP. Algo como 192.168.1.1 ou 76.76.21.21. Funcionam como CEPs — cada servidor tem o seu.

Mas ninguém quer memorizar números. Imagine falar pro seu amigo: "acessa o 76.76.21.21 pra ver meu app". Não rola.

O DNS (Domain Name System) resolve isso. Ele é o sistema que traduz nomes legíveis como meuapp.com.br para endereços IP que os computadores entendem.

Como funciona na prática

Quando você digita meuapp.com.br no navegador, acontece o seguinte:

  1. Seu navegador pergunta: "qual o IP de meuapp.com.br?"
  2. O resolver DNS (geralmente do seu provedor de internet) procura a resposta
  3. Ele consulta os servidores de nome (nameservers) do domínio
  4. Os nameservers respondem: "meuapp.com.br está em 76.76.21.21"
  5. Seu navegador conecta nesse IP e carrega o site

Tudo isso acontece em milissegundos. Você nem percebe.

Os registros DNS que importam

Dentro do DNS, existem vários tipos de "anotações" chamados registros. Para um vibecoder, os mais importantes são:

Registro A

O mais básico. Aponta um domínio para um endereço IP.

Tipo: A
Nome: @  (ou meuapp.com.br)
Valor: 76.76.21.21

Use para: conectar seu domínio raiz ao servidor.

Registro CNAME

Aponta um domínio para outro domínio. É como um redirecionamento.

Tipo: CNAME
Nome: www
Valor: meuapp.vercel.app

Use para: subdomínios como www ou api.

Importante: Você não pode usar CNAME no domínio raiz (ex: meuapp.com.br). Para o raiz, use sempre registro A.

Registro TXT

Guarda texto. Usado para verificação — provar que o domínio é seu.

Tipo: TXT
Nome: @
Valor: "veloz-verify=abc123"

Use para: verificar domínio em plataformas de deploy, configurar email (SPF, DKIM).

O que é propagação DNS?

Quando você muda um registro DNS, a mudança não acontece instantaneamente no mundo inteiro. Servidores DNS ao redor do planeta guardam uma cópia em cache dos registros.

O tempo que leva para todos atualizarem é chamado de propagação. Pode levar de minutos a horas.

Cada registro tem um TTL (Time to Live) — quanto tempo o cache é válido. TTL de 300 segundos significa que a cada 5 minutos os servidores buscam a versão mais recente.

Dica prática: Se você vai mudar DNS, baixe o TTL para 300 (5 min) algumas horas antes. Assim a propagação é mais rápida.

Onde configurar DNS?

O DNS é configurado no lugar onde você registrou seu domínio (o registrador). Exemplos:

  • GoDaddy — Painel → DNS Management
  • Registro.br — Para domínios .com.br
  • Namecheap — Domain List → Manage → Advanced DNS
  • Cloudflare — Se você transferiu os nameservers

Cada um tem uma interface diferente, mas o conceito é o mesmo: você adiciona registros (A, CNAME, TXT) e aponta para onde seu app está.

O fluxo completo: domínio → app no ar

Vamos juntar tudo. Você criou um app e quer que ele fique acessível em meuapp.com.br.

  1. Compre o domínio no Registro.br ou GoDaddy
  2. Faça deploy do app (com Veloz, por exemplo: veloz deploy)
  3. Pegue o IP ou domínio de destino que a plataforma te dá
  4. Configure o DNS no seu registrador:
    • Registro A: @ → IP do servidor
    • Registro CNAME: www → domínio da plataforma
  5. Aguarde propagação (geralmente minutos)
  6. Pronto — meuapp.com.br abre seu app

Plataformas como o Veloz simplificam isso ainda mais. Você adiciona o domínio pelo CLI ou dashboard, a plataforma te diz exatamente quais registros criar, e cuida do SSL automaticamente.

$ veloz domains add meuapp.com.br
→ Adicione este registro A: @ → 76.76.21.21
→ Aguardando verificação...
→ ✓ Domínio verificado. SSL ativo.

Erros comuns

"Meu domínio não funciona"

  • Verifique se o registro A está apontando pro IP certo
  • Espere a propagação (use dnschecker.org para conferir)
  • Certifique-se que não tem registros conflitantes

"Funciona sem www mas não com www" (ou vice-versa)

  • Você precisa de DOIS registros: A para o raiz e CNAME para www
  • Ou configure um redirect de um para o outro

"SSL não funciona"

  • O certificado SSL só é emitido depois que o DNS propagar corretamente
  • A maioria das plataformas gera SSL automaticamente após verificação

hidden: true

FAQ

Quanto tempo demora para o DNS propagar?

Na prática, entre 5 minutos e 48 horas, dependendo do provedor e do TTL configurado. A maioria das mudanças propaga em menos de 1 hora.

Qual a diferença entre registro A e CNAME?

O registro A aponta um domínio diretamente para um IP (ex: 76.76.21.21). O CNAME aponta um domínio para outro domínio (ex: www → meuapp.vercel.app). Use A para o domínio raiz e CNAME para subdomínios.

Preciso configurar DNS manualmente?

Depende. Se você usa uma plataforma de deploy como o Veloz, geralmente basta adicionar um registro A ou CNAME no seu provedor de domínio. A plataforma cuida do resto, incluindo SSL.