> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Editor de DNS

> Muda a zona de DNS de um domínio neste servidor: os registros que dizem para onde vão o site, o e-mail e os subdomínios. Também desliga o DNS do domínio e devolve a zona ao padrão.

**Caminho no painel:** **Domínios** > **Editor de DNS**

O painel avisa na própria tela que o recurso é para quem já conhece DNS, e que
registro errado pode derrubar o site e o e-mail.

**O que se muda aqui só vale para quem usa este servidor como DNS do domínio.**
Com o domínio apontado para um DNS de fora, a zona daqui existe e não é consultada
por ninguém.

## 1. Escolher o domínio

![Seleção de domínio do Editor de DNS, com a busca e a lista de domínios, um deles com a etiqueta Modificado](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dns-selecao-admin.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=a915d80e186d09c269c32cdeca4ef293)

1. Em **Busca**, digite parte do nome. A lista filtra enquanto você digita, e o `*`
   funciona como curinga.
2. Clique no domínio.

**Só aparecem domínios principais**, de todas as contas. O subdomínio não tem zona
própria: os registros dele ficam na zona do domínio principal.

| Etiqueta | Quer dizer |
| - | - |
| **Modificado** | alguém já salvou esta zona no editor, e ela deixou de ser a padrão |
| **Desativado** | o DNS do domínio está desligado |

O Editor de DNS também abre pelo **globo** da lista de domínios.

## 2. A tela do domínio

![Editar configurações de DNS: o registro SOA, os registros do domínio, Adicionar registro e Redefinir configurações marcados](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dns-editar.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=c607a0e09fa4f3f3bd78712f7d03da37)

| # | O que é |
| - | - |
| **1** | o **SOA**, o registro que descreve a zona |
| **2** | **Adicionar registro** |
| **3** | **Redefinir configurações**, que só aparece em zona modificada |

### O SOA

| Campo | Vem com | O que é |
| - | - | - |
| TTL | `86400` | por quanto tempo, em segundos, os outros servidores guardam a resposta. O botão **Aplicar** embaixo dele copia esse TTL para todos os registros da lista |
| **Nome do servidor principal** | o servidor de nomes deste servidor | quem responde pela zona |
| **Endereço de email da pessoa responsável (RNAME)** | `root.` e o nome do servidor | o e-mail do responsável, escrito com ponto no lugar do `@` |
| **Atualizar** | `14400` | de quanto em quanto tempo, em segundos, um servidor secundário confere mudanças |
| **Tentar novamente** | `1800` | quanto o secundário espera para tentar de novo, se falhar |
| **Expira** | `604800` | até quando o secundário continua respondendo sem conseguir falar com o principal |
| **Mínimo** | `3600` | por quanto tempo uma resposta de "não existe" fica guardada |

### Os registros

Cada linha tem **Host**, **TTL**, **Tipo de registro**, **Valor** e o botão
**Remover**. Os tipos disponíveis são **A**, **AAAA**, **CAA**, **CNAME**,
**HTTPS**, **MX**, **NS**, **PTR**, **SRV** e **TXT**.

No **Host**, `@` é o próprio domínio e `*` vale para qualquer nome que não tenha
registro próprio. A zona padrão vem com dez registros:

| Host | Tipo | Para quê |
| - | - | - |
| `@` e `*` | A e AAAA | o site, em IPv4 e IPv6, apontando para este servidor |
| `@` | MX | o e-mail do domínio, entregue em `mail` |
| `@` | NS, duas vezes | os servidores de nomes |
| o marcador do DKIM | TXT | a assinatura do e-mail enviado, ver abaixo |
| `@` | TXT | o SPF, com `"v=spf1 a mx -all"` |
| `_dmarc` | TXT | o DMARC, com `"v=DMARC1; p=none"` |

## 3. Mudar a zona

1. Para um registro novo, clique em **Adicionar registro**. Uma linha vazia entra
   no fim da lista.
2. Preencha **Host**, **TTL**, **Tipo de registro** e **Valor**.
3. Para tirar um registro, clique em **Remover** na linha dele.
4. Clique em **Salvar**.

O painel responde *"As configurações foram atualizadas. As alterações terão
efeito em alguns instantes."* A zona nova vale **no minuto seguinte**, com o número
de série do SOA aumentado. O domínio ganha a etiqueta **Modificado**, e aparece o
botão **Redefinir configurações**.

**Nome completo no Valor termina com ponto**, como `meublog.com.br.`. É o jeito do
DNS dizer que o nome acabou ali.

**Sem o ponto final, o painel completa com o domínio.** Um PTR com o valor
`192.0.2.11` foi gravado como `192.0.2.11.meublog.com.br.`.

**Tirar o MX é aceito sem aviso.** A zona fica sem MX, e o domínio deixa de dizer
para onde vai o e-mail dele. **Tirar os dois NS é recusado**, ver abaixo.

### Os outros tipos, com valores que o painel aceitou

| Tipo | Host | Valor | Para quê |
| - | - | - | - |
| **CAA** | `@` | `0 issue "letsencrypt.org"` | diz quais autoridades podem emitir certificado para o domínio |
| **HTTPS** | `@` | `1 . alpn="h2,http/1.1"` | anuncia ao navegador como se conectar ao site |
| **SRV** | `_sip._tcp` | `10 60 5060 sip.meublog.com.br.` | aponta um serviço: prioridade, peso, porta e servidor |
| **PTR** | `10` | `meublog.com.br.` | dá nome a um endereço, o uso de zona reversa |

Os quatro entraram na zona no minuto seguinte, e o servidor respondeu a cada um.

### As recusas

| O que foi feito | Quem recusa | Mensagem |
| - | - | - |
| campo vazio | o navegador | *"Preencha este campo."* |
| TTL zero ou negativo | o navegador | *"O valor deve ser maior ou igual a 1."* |
| valor que não serve para o tipo, como `300.1.1.1` num A | o painel | *"Registro #11 \| O campo contém dados inválidos para o registro A."* O número é a posição do registro na lista |
| CNAME num nome que já tem outro registro | o servidor de DNS | *"A verificação de sintaxe falhou, verifique seus dados!"*, seguido do erro técnico |
| RNAME inválido | o painel | *"RNAME inválido."* |
| os dois NS removidos | o servidor de DNS | *"A verificação de sintaxe falhou, verifique seus dados! has no NS records"* |
| SRV sem os números, como `5060 sip` | o servidor de DNS | *"A verificação de sintaxe falhou, verifique seus dados!"*, seguido de *"not a valid number"* |
| CAA sem o número da frente, como `issue letsencrypt.org` | o painel | *"Registro #15 \| O campo contém dados inválidos para o registro CAA."* |

**Com a recusa, a tela volta com tudo o que foi digitado**, inclusive o registro
errado. Corrigir a linha e salvar de novo funciona.

## O DKIM, e os dois marcadores

O registro DKIM da zona não guarda a chave: ele usa dois marcadores,
`<DKIM_RECORD_HOST>` no **Host** e `<DKIM_RECORD_VALUE>` no **Valor**. O painel
troca os marcadores pela chave do domínio ao gravar a zona. **Por isso a zona
acompanha sozinha a troca do seletor DKIM**, feita na aba E-mail do domínio.

**Para copiar a chave**, clique em **(Mostrar)**, no texto de ajuda do alto, ou em
**Mostrar**, na linha do registro:

![Janela Registro DKIM DNS, com o registro completo, o host e o valor com e sem aspas, cada um com o botão Copiar](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dns-dkim.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=ce279f9f17a84d2ce78e30780de0c6ca)

| Campo | Serve para |
| - | - |
| **Registro DKIM completo** | colar numa zona escrita à mão |
| **Host DKIM** | o nome do registro, num painel de DNS de fora |
| **Valor DKIM com aspas** | painel de fora que pede o valor partido em blocos de até 255 caracteres |
| **Valor DKIM sem aspas** | painel de fora que aceita o valor inteiro |

Esta janela é o caminho que funciona para ver o DKIM: o **Mostrar** do cartão **ℹ**,
na lista de domínios, não abre.

## Desligar o DNS do domínio

1. Em **Desativar DNS para este domínio**, marque **Sim**.
2. Clique em **Salvar**.

Antes de salvar, a tela já avisa: *"O DNS está desabilitado para este domínio."* No
minuto seguinte **o servidor para de responder pelo domínio**, como se ele não
existisse. Na lista de domínios, o globo ganha um risco vermelho, e a seleção mostra
**Desativado**.

**É a mesma opção do Desativar DNS da aba Geral do domínio.** Marcar num lugar
marca no outro.

> [!NOTE]
>
> **Religar pelo editor deixa a zona como Modificado**
>
> Desmarcar e salvar no editor grava a zona, e ela passa a contar como modificada,
> mesmo com os mesmos registros do padrão.

## Voltar ao padrão

![Janela Redefinir configurações, com a pergunta de confirmação e os botões Sim e Cancelar](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dns-redefinir.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=4cf4285c93d83d26bb048814a77a6c28)

1. Clique em **Redefinir configurações**.
2. Na janela, clique em **Sim**.

A zona volta aos dez registros padrão, e a etiqueta **Modificado** some.

> [!WARNING]
>
> **Redefinir apaga todos os registros que foram acrescentados**
>
> Não há desfazer. Antes de redefinir, copie os registros que precisam voltar.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Salvei e nada mudou lá fora** | o domínio usa outro servidor de DNS | mudar no DNS que o domínio usa de verdade |
| Salvei e ainda vejo o valor antigo | a zona vale no minuto seguinte, e os outros servidores guardam a resposta pelo TTL | esperar o TTL do registro |
| **O site e o e-mail pararam de responder** | **Desativar DNS** foi marcado, aqui ou na aba Geral | desmarcar e salvar |
| O DNS responde um TTL diferente do que está aqui | a substituição de TTL de [Operações em Massa](/keyhelp-admin/operacoes-em-massa) está ligada, e esta tela continua mostrando o TTL original | desligar a substituição quando ela não for mais necessária |
| *"Registro #N \| O campo contém dados inválidos..."* | o valor não serve para aquele tipo | contar N linhas na lista, corrigir e salvar |
| *"A verificação de sintaxe falhou"* ao criar um CNAME | o nome já tem outro registro | usar outro nome, ou remover o registro que já existe |
| Não acho o subdomínio na seleção | subdomínio não tem zona própria | abrir o domínio principal e criar o registro com o nome do subdomínio no **Host** |
| Não acho o botão **Redefinir configurações** | a zona ainda é a padrão | é o comportamento do painel |
| **Redefini e perdi registros** | redefinir volta ao padrão | criar de novo à mão |

## Ver também

* [Domínios](/keyhelp-admin/dominios), onde fica o globo de cada domínio
* [Editar um domínio](/keyhelp-admin/editar-dominio), a aba E-mail com o seletor DKIM, e o Desativar DNS da aba Geral
* [Editor de DNS (área do cliente)](/keyhelp/editor-de-dns), com a permissão que decide se o cliente vê esta tela


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.