> ## 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.

# Editar um domínio

> Muda tudo o que um domínio faz depois de criado: a pasta do site, o certificado, o e-mail, a versão do PHP, diretivas do Apache, e desativa ou agenda a exclusão.

**Caminho no painel:** **Domínios** > **Domínios** > **lápis** na linha do domínio

O formulário é o mesmo de [Adicionar um domínio](/keyhelp-admin/adicionar-dominio), com seis
abas. Para mudar qualquer coisa:

1. Na lista de domínios, clique no **lápis** da linha.
2. Abra a aba do que você quer mudar.
3. Mude e clique em **Salvar**.

O painel responde *"O domínio X foi atualizado."* e volta para a lista. **A
mudança vale no minuto seguinte**, quando o **S** da lista sai de *Processando*.

**O Salvar grava as seis abas de uma vez**, e não só a que está aberta.

## Geral

![Aba Geral de um domínio existente: Proprietário com o lápis, Tipo do domínio, Domínio travado, destino, diretório e Desativar DNS](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-editar-geral.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=f0b4cf7a57ae2f6142da0493c2ef9ed7)

**O nome e o tipo não mudam.** O **Domínio** aparece num campo cinza, e o **Tipo do
domínio** aparece como texto, fora de campo. Para outro nome, é outro domínio.

**O lápis ao lado do nome do proprietário** abre a troca de dono: ver
[Trocar o proprietário de um domínio](/keyhelp-admin/trocar-proprietario-do-dominio).

O resto é o mesmo da criação: **Diretório local** ou **Encaminhamento**, a pasta e
**Desativar DNS**. Mudar a pasta para uma que não existe faz o painel criá-la com a
página padrão, que de fábrica é a página em inglês com a palavra *Welcome* (ver
[Página de Domínio Padrão](/keyhelp-admin/pagina-de-dominio-padrao)).
**Os arquivos da pasta antiga ficam onde estavam.**

> [!WARNING]
>
> **Depois de uma mensagem de erro, o Diretório volta como `/`**
>
> Se o painel recusar o formulário, por exemplo por um **Endereço de destino**
> inválido, a tela volta com a mensagem e com o campo **Diretório** trocado por `/`.
> Quem corrige o erro, volta para **Diretório local** e salva sem olhar **muda o
> site para a raiz da conta**, `/www/`. Antes de salvar de novo, confira o campo.

**Desativar DNS** é a mesma opção do Editor de DNS: marcar num lugar marca no
outro. Com ela marcada, o servidor para de responder pelo domínio.

## Segurança

![Aba Segurança com Certificado Let's Encrypt marcado, Forçar conexão segura, HSTS e Aplicar a todos os subdomínios](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-aba-seguranca.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=35dfa87918839289f761b391d127bf05)

| Opção | O que faz |
| - | - |
| **Sem certificado** | o site só abre por `http://` |
| **Certificado Let's Encrypt** | certificado gratuito, pedido e renovado pelo painel |
| **Selecionar certificado** | usa um certificado cadastrado em [Certificados SSL/TLS](/keyhelp-admin/certificados-ssl-tls), escolhido na lista **Certificados disponíveis** |

Com um certificado escolhido, aparecem as opções de conexão segura:

| Opção | Vem com | O que faz |
| - | - | - |
| **Forçar conexão segura** | ligada | quem chega por `http://` é mandado para `https://` |
| **HTTP Strict Transport Security (HSTS)** | desligada | o navegador do visitante passa a exigir `https://` por conta própria, pelo tempo marcado |
| tempo do HSTS | **180 Dias** | a unidade vai de **Segundos** a **Semanas**. O navegador não aceita número negativo |
| **Adicionar diretiva includeSubdomains** | desligada | estende o HSTS aos subdomínios |
| **Adicionar diretiva preload** | desligada | marca o domínio para as listas de HSTS que já vêm nos navegadores |
| **Aplicar configurações de segurança a todos os subdomínios** | desligada | copia esta aba para os subdomínios **uma vez**. Subdomínio criado depois não recebe |

O próprio painel avisa, no HSTS, que voltar para `http://` depois pode deixar
visitantes sem acesso ao site, porque o navegador deles lembra da regra.

**Conferido no que o site responde**, com um certificado próprio: com HSTS de 180
dias, **includeSubdomains** e **preload**, a resposta por `https://` traz o
cabeçalho `Strict-Transport-Security: max-age=15552000; includeSubDomains; preload`,
que são os 180 dias em segundos. Com **Forçar conexão segura**, um acesso por
`http://` recebe o código 301 para o mesmo endereço em `https://`, caminho incluído.

**Para o administrador, a lista de certificados traz também os de outras contas**,
cada um com o domínio que ele cobre ao lado do nome.

> [!WARNING]
>
> **Selecionar certificado sem escolher um grava Sem certificado**
>
> Marcando **Selecionar certificado** e salvando com a lista em *"-- Favor selecione
> \--"*, o painel responde que o domínio foi atualizado e grava o domínio **sem
> certificado**. Nenhuma mensagem avisa.

> [!WARNING]
>
> **Quando o Let's Encrypt falha, o único sinal é o S da lista**
>
> O certificado só é emitido se o domínio já apontar para este servidor. Quando não
> dá, o **S** vira um triângulo, *Ocorreu um erro*, e o motivo fica em **Status do
> Sistema** > **Registro de Eventos**, em inglês: *"Failed to aquire a Let's Encrypt
> certificate for..."*, seguido de *"Local resolving checks failed"*. **A coluna
> Segurança continua mostrando o cadeado**, e ninguém recebe e-mail.

## E-mail

![Aba E-mail com as duas opções de uso do domínio para e-mail e o Seletor DKIM](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-aba-email.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=d3314791e3895d18f2eb1a8dc2b432fa)

| Opção | Vem com | O que faz |
| - | - | - |
| **O domínio pode ser usado para e-mail** | ligada | permite criar contas de e-mail no domínio |
| **O domínio pode ser usado exclusivamente para envio de e-mails** | desligada | as caixas só enviam. Quem recebe o e-mail do domínio é outro servidor, apontado no DNS |
| **Seletor DKIM** | `default` | o nome da chave que assina o e-mail enviado. **Cada troca gera uma chave nova** |

Um seletor com caractere inválido é recusado com *"Entrada inválida no campo
Seletor DKIM."*

**A zona de DNS acompanha a troca de seletor**, porque o registro DKIM dela usa os
marcadores do [Editor de DNS](/keyhelp-admin/editor-de-dns). Um DNS externo não
acompanha, e o painel lembra disso na própria tela.

> [!NOTE]
>
> **Desligar o e-mail não limpa o DNS**
>
> Com **O domínio pode ser usado para e-mail** desmarcado, a zona continua com os
> registros MX, SPF, DMARC e DKIM do domínio.

Na lista de domínios, a opção de só envio aparece como *"Apenas recebimento"*, que é
erro de tradução: ver [Domínios](/keyhelp-admin/dominios).

## Interpretador

![Aba Interpretador com a versão do PHP, Aplicar a todos os subdomínios e o Caminho do Perl/CGI script personalizado](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-aba-interpretador.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=a1be88e131abab53c1c56cd095cfc17f)

| Opção | O que faz |
| - | - |
| **Interpretador PHP** | a versão do PHP do domínio. Versão antiga vem marcada **Desatualizado**. Em subdomínio existe também **Como domínio principal** |
| **Aplicar interpretador PHP a todos os subdomínios** | copia a versão para os subdomínios **uma vez** |
| **Caminho do Perl/CGI script** | a pasta onde todo arquivo é tratado como programa CGI |

O caminho do CGI tem duas escolhas. **Configuração padrão** usa a pasta `cgi-bin`
dentro do diretório do domínio. **Configuração personalizada** abre um campo, a
partir de `/www`.

**A pasta do CGI não é criada.** O painel avisa na tela, e foi conferido: com um
caminho que não existe, o servidor aponta para ele assim mesmo, e o script
responde erro até alguém criar a pasta.

**O caminho do CGI só aparece se o cliente dono tiver a permissão Perl/CGI.** Sem
PHP e sem Perl/CGI, a aba inteira some.

## Configurações do Apache

![Aba Configurações do Apache com os campos Diretivas para HTTP e Diretivas para HTTPS](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-aba-apache.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=a9ddb08696f78da4a0b890c1fa5db591)

Dois editores, um para o site em `http://` e outro para `https://`. **O que se
escreve aqui entra na configuração do Apache do domínio**, e o painel avisa:
*"A sintaxe incorreta impede a reinicialização do servidor web."*

Com alguma diretiva salva, a lista de domínios mostra uma **pena** verde na linha.

> [!WARNING]
>
> **Uma diretiva errada trava as mudanças de site da conta inteira**
>
> O painel não confere a sintaxe ao salvar: responde *"O domínio X foi atualizado."*
> No minuto seguinte, o servidor web recusa a configuração nova e continua com a
> antiga. **Os sites seguem no ar, mas nenhuma mudança da conta chega a eles**: um
> encaminhamento salvo nesse intervalo ficou gravado e não passou a valer.
>
> Os sinais, todos medidos:
>
> * **todos os domínios da conta** ficam com o triângulo *Ocorreu um erro* na coluna
>   **S**, mesmo os que ninguém mexeu. Os domínios das outras contas continuam verdes
> * a cada minuto, **Status do Sistema** > **Registro de Eventos** ganha uma linha
>   *Crítico* com *"Apache reported syntax errors."*, o número da linha e o arquivo
>   de diretivas do domínio que tem o erro
>
> Apagar ou corrigir a diretiva e salvar resolve no minuto seguinte: a coluna **S**
> volta ao verde, e o que tinha ficado parado passa a valer.

**Esta aba só existe para o administrador.** O cliente não vê.

## Configurações avançadas

![Aba Configurações avançadas com Desativar domínio e Excluir este domínio em data específica](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominios-aba-avancadas.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=2f1c819c82d690906fce3d6ff2375655)

### Desativar domínio

Marcado e salvo, o domínio para de servir o site:

* quem abre o endereço é mandado para uma página do painel que diz *"O domínio
  solicitado está desativado."*, ou para um endereço escolhido em
  [Comportamento de Domínios Indisponíveis](/keyhelp-admin/comportamento-de-dominios-indisponiveis).
  **Em `https`, isso vale para o domínio com certificado:** sem certificado, o
  endereço em `https` responde, de fábrica, com erro 404
* os subdomínios são desativados junto, como diz a tela
* **o DNS continua respondendo**: o domínio ainda aponta para o servidor
* a linha ganha um **cadeado** vermelho, e o **S** continua verde
* o painel tenta avisar o cliente por e-mail. Numa conta sem e-mail cadastrado, o
  envio falha e fica anotado no **Registro de Eventos**

### Excluir este domínio em data específica

Agenda a exclusão, e a lista mostra uma **lixeira** cinza com a data na dica.

> [!WARNING]
>
> **Uma data que já passou exclui o domínio no minuto seguinte**
>
> O campo aceita data do passado. Salvando assim, o domínio e os subdomínios
> somem na próxima passada da tarefa de fundo, **sem tela de confirmação**. A pasta
> do site continua na conta.

Esta aba também é exclusiva do administrador.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Corrigi um erro, salvei, e o site virou o da raiz da conta** | a tela de erro troca o **Diretório** por `/` | editar de novo e escrever a pasta certa |
| **Escolhi certificado e o site continua sem** | **Selecionar certificado** foi salvo sem nenhum escolhido | abrir a aba e escolher na lista |
| **O S virou triângulo depois de ligar o Let's Encrypt** | o domínio não aponta para este servidor | apontar o domínio e salvar de novo. O motivo está no [Registro de Eventos](/keyhelp-admin/registro-de-eventos) |
| **Mudei a pasta e o site virou uma página *Welcome*** | a pasta nova é criada com a página padrão do painel, sem os arquivos da antiga | copiar os arquivos, pelo gerenciador de arquivos ou por FTP |
| O script CGI dá erro | a pasta personalizada não existe | criar a pasta |
| **O domínio sumiu da lista** | havia uma data de exclusão, talvez do passado | não há desfazer: criar de novo. A pasta do site continua na conta |
| Desativei e o domínio ainda resolve | desativar não mexe no DNS | para parar de responder, marcar **Desativar DNS** |
| O subdomínio criado depois ficou sem certificado ou com outro PHP | **Aplicar a todos os subdomínios** vale uma vez | aplicar de novo |
| **Mudei um domínio e o site não muda, e a conta inteira está com o triângulo** | uma diretiva do Apache com sintaxe errada, em algum domínio da conta | achar a linha *Crítico* no **Registro de Eventos**, que diz o arquivo e a linha, corrigir a diretiva naquele domínio e salvar |

## Ver também

* [Adicionar um domínio](/keyhelp-admin/adicionar-dominio), a aba Geral e o encaminhamento
* [Domínios](/keyhelp-admin/dominios), a lista e o que o **S** quer dizer
* [Editor de DNS](/keyhelp-admin/editor-de-dns)
* [Certificados SSL/TLS](/keyhelp-admin/certificados-ssl-tls), onde ficam os certificados da lista **Certificados disponíveis**
* [Editar um domínio (área do cliente)](/keyhelp/editar-dominio), o que o cliente vê deste formulário


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