logo
Domínios•

Apontar seu domínio com CNAME ou registro A

Os registros de DNS que apontam um domínio para a CodeQR — CNAME para subdomínio, registro A para domínio raiz, mais o TXT de propriedade e o TTL.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Apontar um domínio para a CodeQR é um registro de DNS, mais um segundo registro temporário que prova que o domínio é seu. Esta página traz os valores exatos e o que esperar depois de salvar.

Disponibilidade

  • Plano: Starter ou superior, porque o domínio em si é.
  • Onde: os registros vão no seu provedor de DNS — o registrador, a Cloudflare ou onde a zona estiver hospedada. A CodeQR mostra os valores na página Domínios.

Antes de começar

  • Adicione o domínio na CodeQR primeiro: Domínios → Adicionar Domínio. Os registros exibidos depois são específicos daquele domínio.
  • Tenha acesso à zona de DNS. Criar um registro não é o mesmo que ser dono do domínio; em muitas empresas são pessoas diferentes.
  • Decida se vai apontar um subdomínio (go.acmestore.com) ou o domínio raiz (acmestore.com), porque o tipo de registro muda. O subdomínio é a escolha mais segura para quase todo mundo.

O registro para um subdomínio

  • Tipo — CNAME
  • Nome — a parte antes do primeiro ponto — go em go.acmestore.com
  • Valor — cname.codeqr.io
  • TTL — 86400, ou o maior valor disponível

A maioria dos provedores pede o nome sem o restante do domínio. Se o painel mostrar uma prévia como go.acmestore.com.acmestore.com, você digitou o endereço completo onde cabia só o rótulo.

O registro para o domínio raiz

  • Tipo — A
  • Nome — @
  • Valor — 76.76.21.21
  • TTL — 86400, ou o maior valor disponível

O domínio raiz — também chamado de apex — não aceita CNAME. Isso é uma regra do próprio DNS, não um limite da CodeQR: o apex já carrega registros como NS e MX, e um CNAME não pode conviver com eles. Por isso a CodeQR entrega um registro A para o apex.

Vale parar na consequência: apontar o domínio raiz para cá significa que tudo naquele endereço, inclusive o seu site, passa a responder pela CodeQR. Use um subdomínio, a menos que o domínio não tenha site nenhum.

O registro de propriedade

Enquanto o status for de verificação pendente, o card também mostra um registro TXT:

O registro TXT com tipo, nome e valor, e o botão que copia o valor

  • Tipo — TXT
  • Nome — _vercel
  • Valor — a sequência vc-domain-verify=… exibida no card

Crie exatamente como aparece, na raiz do domínio, e use o botão Copy — que continua em inglês na interface em português — em vez de digitar de novo. Ele prova que o domínio é seu e pode ser removido depois que o domínio for verificado.

Um aviso que a interface pretende dar nesse passo: se o domínio estiver em uso por outro site na mesma infraestrutura, criar esse registro TXT transfere a propriedade para longe daquele site e o derruba. Confira se o domínio que aparece dentro do valor TXT é o que você quer na CodeQR, e não o seu site de produção.

Passos

  1. Abra o seu provedor de DNS e vá até a zona do domínio.
  2. Crie o registro CNAME ou A acima, conforme seja subdomínio ou domínio raiz.
  3. Crie o registro TXT _vercel exibido no card do domínio.
  4. Salve, volte à CodeQR e selecione Atualizar no domínio.

Quanto tempo demora

De alguns minutos a algumas horas. O que você espera não é o registro viajando — é os outros servidores esquecerem a resposta que guardaram antes, o que dura o tempo do TTL anterior. Se você já sabe que vai mudar um registro, baixar o TTL na véspera é a única coisa que torna a troca rápida.

A CodeQR reconfere sozinha e também sempre que você seleciona Atualizar.

Certificados

Você não solicita nem configura certificado SSL. Assim que o domínio resolve corretamente, o certificado é emitido automaticamente e o https:// passa a funcionar. Se a emissão estiver travada, a causa quase sempre é um registro CAA no domínio — veja Corrigir um domínio personalizado que não funciona.

Verifique se funcionou

Confira o que o mundo enxerga, não o que o painel do provedor mostra:

dig +short go.example.com CNAME
cname.codeqr.io.

Para um domínio raiz:

dig +short example.com A
76.76.21.21

E o registro de propriedade:

dig +short _vercel.example.com TXT

Depois acesse o domínio por HTTPS. Um link nele deve responder com 302 e o seu destino em location.

Solução de problemas

Meu provedor não deixa criar CNAME na raiz

Nenhum provedor deixa — o DNS não permite. Alguns oferecem ALIAS, ANAME ou achatamento de CNAME como contorno, mas com a CodeQR nada disso é necessário: use o registro A acima. O Registro.br, que não tem ALIAS nem ANAME, funciona com o registro A.

O registro está salvo e a CodeQR continua com verificação pendente

Dê tempo e confira com o dig a partir de fora da sua rede. Se o dig devolver algo diferente dos valores acima — endereços da Cloudflare, por exemplo — o registro está sendo interceptado antes de chegar à internet.

Já existe um registro com esse nome

Um nome de host não pode ter um CNAME ao lado de outros registros. Apague os A, AAAA ou CNAME existentes para aquele nome exato e crie o novo. Registros de outros nomes no mesmo domínio não são afetados.

Não sei onde meu DNS está hospedado

Pergunte pelos servidores de nomes do domínio:

dig +short example.com NS

A resposta indica o provedor que vai aceitar o registro — que nem sempre é a empresa de quem você comprou o domínio.

Artigos relacionados