Nesta página

Última atualização: 19 de novembro de 2026

Registros DNS

Os registros de um domínio hospedado no DNS da Guara ficam na página dele, em DNS no painel. Clique em Adicionar registro para criar um, ou use o menu de um registro para editar ou excluir. Quem é visualizador no projeto vê os registros sem poder alterá-los.

As mudanças chegam aos servidores DNS da Guara em segundos. Resolvedores que já guardaram a resposta antiga continuam com ela até o TTL acabar.

Tipos aceitos

TipoValorExemplo
AEndereço IPv4192.0.2.1
AAAAEndereço IPv62001:db8::1
CNAMEOutro nome de hostapp.example.net
MXPrioridade e servidor de email10 mx.example.net
TXTTexto (SPF, DKIM, DMARC, verificações)v=spf1 include:_spf.example.net ~all
CAAFlags, tag e valor0 issue "letsencrypt.org"
SRVPrioridade, peso, porta e destino10 5 5060 sip.example.net
NSUm servidor DNS, para delegar um subdomínions1.outro-provedor.net

Outros tipos (PTR, DS, TLSA etc.) não são aceitos.

Registros do tipo Serviço aparecem quando um domínio personalizado de um dos seus serviços fica dentro do domínio. Eles apontam o nome para o serviço, ficam travados aqui e são removidos junto com o domínio personalizado. A Guara também gerencia sozinha o SOA e os NS da raiz do domínio.

Nomes

  • @ é o próprio domínio (example.com.br).
  • Os outros nomes são relativos ao domínio: www é www.example.com.br. Digitar o nome completo também funciona.
  • Os nomes podem ter letras, números, hífens e sublinhados (_dmarc, selector._domainkey).
  • * como primeiro rótulo é um curinga: * responde por qualquer nome sem registros próprios, e *.app por qualquer nome abaixo de app.
  • Nomes com acentos (café) são convertidos para a forma ASCII.

Regras

  • Um CNAME fica sozinho. Um nome com CNAME não pode ter nenhum outro registro, e o próprio domínio (@) não pode ter CNAME. Para apontar a raiz para um serviço da Guara, adicione-a como domínio personalizado.
  • Registros NS delegam um subdomínio (por exemplo, dev para outro provedor). Nada mais pode existir no nome delegado ou abaixo dele.
  • Um TTL por nome e tipo. Registros com o mesmo nome e tipo compartilham o TTL; mudar o de um muda o de todos.
  • Valores TXT podem ter até 4.096 bytes. Valores longos, como chaves DKIM, são divididos em partes de 255 bytes automaticamente; cole o valor inteiro.
  • Registros idênticos são recusados.

TTL

O TTL é por quanto tempo os resolvedores guardam uma resposta, de 1 minuto a 1 dia. Um registro novo usa o TTL dos outros registros com o mesmo nome e tipo, ou 1 hora se for o primeiro. Registros de serviço usam 5 minutos, para que os endereços de um serviço possam mudar rápido.

Diminua o TTL um dia antes de uma mudança planejada para ela valer mais rápido, e aumente de novo depois.

Importando um arquivo de zona

A maioria dos provedores de DNS exporta os registros de um domínio como arquivo de zona (formato BIND). Na página do domínio, clique em Importar, cole o arquivo ou escolha-o (até 256 KB) e clique em Ver o que entra:

  • Entram: os registros que serão criados.
  • Ignorados: registros que já existem no domínio, e o SOA e os NS da raiz do arquivo (a Guara gerencia os dela).
  • Recusados: linhas que a Guara não consegue importar, cada uma com o número da linha e o motivo: tipos não aceitos, nomes fora do domínio, registros que quebram uma das regras acima ou mais registros do que o seu plano permite.

Nada muda até você clicar em Importar. O $ORIGIN e o $TTL do arquivo são respeitados; TTLs fora de 1 minuto a 1 dia são ajustados para caber. $INCLUDE e $GENERATE não são aceitos.

Exportando

Clique em Exportar, acima dos registros, para baixá-los como arquivo de zona, pronto para importar em outro lugar ou guardar como cópia.

Pelo terminal

A CLI gerencia os mesmos registros:

guara dns records list example.com.br
guara dns records add example.com.br --type MX --name @ --value "10 mx.example.net"
guara dns records import example.com.br --file provedor-antigo.zone --dry-run