# Trocar o hostname do VPS sem derrubar o e-mail

Registro A, hostname no painel, certificado dos serviços e PTR do IP: a sequência que mantém o SMTP entregando, com a consulta que prova que o triângulo fechou.

> a ordem é publicar o registro A do novo hostname, abrir o chamado de PTR no provedor, aplicar o nome com o utilitário set_hostname do WHM, reemitir os certificados dos serviços e só então confirmar o reverso. Quatro peças, nessa sequência, e o e-mail não cai.

João Rizzon · 2026-10-05 · Servidores

---

Trocar o hostname de um VPS parece tarefa de dois minutos: muda o nome, reinicia, pronto. O problema é que o nome do servidor aparece em quatro lugares diferentes, controlados por sistemas diferentes, com prazos de propagação diferentes. Se você mexer em um e esquecer os outros três, o e-mail de **todas** as contas hospedadas passa a sair com um EHLO que não resolve, um certificado emitido para o nome antigo, ou um reverso que aponta para outro lugar. E o receptor rejeita.

Este guia é a sequência executável, na ordem que mantém a janela de risco curta.

## As quatro peças que precisam concordar entre si

O nome do servidor não é uma string local. Ele é uma afirmação que o seu servidor faz para o resto da internet toda vez que abre uma conexão SMTP. Para essa afirmação ser aceita, quatro coisas precisam concordar:

| Peça | Onde vive | Quem controla | Propagação |
|---|---|---|---||
| Registro A/AAAA do novo hostname | Zona DNS do domínio que você vai usar | Você, no DNS autoritativo | TTL do registro |
| Hostname do sistema e do painel | Sistema operacional e configuração do WHM/cPanel | Você, no servidor | Imediata |
| Certificado dos serviços (SMTP, IMAP, painel) | Exim, Dovecot, WHM | Você, via emissão/renovação | Minutos |
| PTR (reverso) do IP | Zona in-addr.arpa do bloco de IP | Provedor do VPS | Horas, depende do provedor |

As duas primeiras você faz sozinho e rápido. A terceira depende da primeira já estar resolvendo. A quarta depende de terceiro e é a que trava o cronograma. Por isso o pedido de PTR não é a última coisa que você faz: é a primeira que você **abre**.

### Por que aplicar o hostname antes do DNS quebra o SMTP

No handshake SMTP o servidor se apresenta com `EHLO hostname`. Vários receptores grandes conferem se esse nome resolve para o IP de origem e se o PTR do IP volta para esse mesmo nome. É o triângulo: nome → IP → nome. Se você aplicar o hostname novo no sistema antes de criar o registro A, o servidor passa a se apresentar com um nome que não existe em DNS, e o triângulo quebra no primeiro lado. A fila do Exim começa a acumular deferimentos antes de você perceber.

## Três critérios para escolher o nome antes de qualquer comando

Três critérios, e eles eliminam a maior parte dos retrabalhos:

- **Use um subdomínio de um domínio que é seu, não do cliente.** `srv01.suaagencia.com.br` sobrevive à saída do cliente; `server.lojadocliente.com.br` vira problema no dia da migração.
- **Não use um nome que já é um site hospedado no servidor.** A documentação do cPanel para o [set_hostname](https://docs.cpanel.net/whm/scripts/the-set_hostname-utility/) exige um FQDN válido; o mínimo de três níveis é prática recomendada, não requisito documentado, e existe por um motivo prático: `suaagencia.com.br` como hostname colide com a conta cPanel do mesmo domínio.
- **Escolha um nome que você não vai querer trocar de novo.** Numeração sequencial neutra (`srv01`, `srv02`) envelhece melhor que nome de cliente, de datacenter ou de plano.

## A sequência que mantém a janela de risco curta

### Publique o registro A do novo hostname e confirme por dig

No DNS autoritativo do domínio escolhido, aponte o novo hostname para o IP principal do VPS. Publique o registro já com TTL 300: ele é novo, não existe cache anterior dele em lugar nenhum, e o TTL baixo só serve para você poder corrigir o IP rápido se errar. O TTL que vale a pena baixar com antecedência é o do registro A **antigo**, que já está cacheado por aí, e o de qualquer registro da zona que você possa precisar ajustar durante a janela. Confirme de fora do servidor:

```bash
dig +short srv01.suaagencia.com.br A
dig +short srv01.suaagencia.com.br AAAA
```

Só siga quando a resposta for exatamente o IP do VPS. Se vier vazio, é propagação ou erro de digitação na zona, e aplicar o hostname agora é começar a janela de risco sem necessidade.

### Abra o chamado de PTR antes de mexer no servidor

Faça isso **agora**, não no fim. O reverso é o item de maior latência humana do processo: depende de fila de atendimento de terceiro. Peça algo objetivo:

> **** Solicito a alteração do registro PTR do IP 203.0.113.10 (exemplo) para `srv01.suaagencia.com.br`. O registro A correspondente já está publicado e resolvendo para este mesmo IP.

Alguns provedores expõem o campo de reverso no painel do cliente e a mudança sai em minutos. Outros só por ticket. Enquanto o PTR ainda aponta para o nome antigo, o e-mail continua funcionando se o nome antigo ainda resolver, o que nos leva ao item seguinte.

### Mantenha o registro A antigo por pelo menos uma semana

Erro comum: trocar o nome e, no mesmo movimento, limpar a zona. Mantenha o registro A do hostname antigo apontando para o mesmo IP por pelo menos uma semana. Durante a janela em que o PTR ainda é o antigo, o triângulo continua fechando pelo nome velho. É a rede de segurança mais barata do processo.

### Aplique o nome com set_hostname, não só com hostnamectl

Em servidores com cPanel/WHM, a troca correta não é só `hostnamectl`. O painel mantém o hostname em sua própria configuração e precisa propagar a mudança para os serviços que dependem dele. A documentação oficial do cPanel descreve o utilitário `set_hostname` exatamente para isso, em [The set_hostname Utility (WHM)](https://docs.cpanel.net/whm/scripts/the-set_hostname-utility/).

```bash
/usr/local/cpanel/bin/set_hostname srv01.suaagencia.com.br
```

A alternativa pela interface é **WHM → Networking Setup → Change Hostname**. Qualquer um dos dois caminhos é preferível a editar arquivos de sistema na mão, porque o painel precisa saber do nome novo para reconfigurar o que depende dele.

Validação imediata, no próprio servidor:

```bash
hostname -f
```

O retorno tem que ser o FQDN novo, inteiro, não o nome curto.

### Reemita os certificados de SMTP, IMAP, painel e FTP

O certificado que o Exim e o Dovecot apresentam foi emitido para o nome antigo. A partir do momento em que o servidor se apresenta com o nome novo, qualquer cliente que faça verificação estrita de nome vai reclamar de certificado inválido, e é esse o momento em que o telefone toca com "o Outlook do cliente parou".

Em WHM, o caminho é **Manage Service SSL Certificates**, e também vale verificar o certificado do próprio painel (porta 2087) e do serviço de FTP. Depois de reemitir, confira de fora:

```bash
openssl s_client -connect srv01.suaagencia.com.br:465 -servername srv01.suaagencia.com.br </dev/null 2>/dev/null | openssl x509 -noout -subject -dates
```

O `subject` precisa conter o hostname novo e a validade precisa cobrir hoje.

### Feche o triângulo nome, IP e nome com dig -x

Quando o provedor confirmar o PTR, rode as três consultas em sequência, de uma máquina fora do servidor:

```bash
IP=$(dig +short srv01.suaagencia.com.br A)
echo "A -> $IP"
dig +short -x "$IP"
```

A última linha tem que devolver `srv01.suaagencia.com.br.` com o ponto final. Nome resolve para o IP, IP resolve de volta para o nome: triângulo fechado. Se o reverso voltar o nome antigo, o PTR ainda não propagou ou o provedor aplicou errado; reabra o chamado citando a saída do comando.

## Checklist de oito itens para padronizar numa frota

Se você administra uma frota, transforme o processo acima em um checklist fixo. A ordem é o produto.

- Nome definido, FQDN válido de três níveis, em domínio próprio, sem colidir com conta hospedada.
- Registro A (e AAAA) publicado e confirmado por `dig +short` de fora.
- Chamado de PTR aberto no provedor, com o IP e o nome escritos no corpo.
- Registro A do hostname antigo preservado, mesmo IP.
- `set_hostname` executado, `hostname -f` confere.
- Certificados de SMTP, IMAP, painel e FTP reemitidos para o nome novo e validados por `openssl s_client`.
- PTR confirmado, triângulo fechado por `dig -x`.
- Uma semana depois: remoção do registro A antigo.

Guarde o checklist no mesmo lugar onde você guarda as credenciais do servidor. Ele vira roteiro de quinze minutos em vez de investigação de duas horas no mês seguinte.

## O que a fila do Exim mostra nas 48 horas seguintes

A fila do Exim é o termômetro mais honesto. Se houver acúmulo anormal, leia o motivo do deferimento antes de supor:

```bash
exim -bpc
exim -bp | head -20
```

Mensagens paradas com recusa citando reverso ou nome de host apontam para PTR ainda não aplicado, não para o seu hostname estar errado. Nesse caso, a correção é no chamado do provedor, não no servidor. Clientes reclamando de aviso de certificado no cliente de e-mail apontam para o passo 5 incompleto, ou para o cliente ainda configurado com o hostname antigo no campo de servidor de entrada/saída, o que é configuração do lado dele.

## O que dizer ao cliente antes da janela, sem explicar DNS

Não explique DNS. Explique janela e consequência. Uma frase que funciona:

> **** Vamos ajustar o nome técnico do servidor que hospeda o seu site e e-mail, nesta quinta às 22h. O site não sai do ar. No seu programa de e-mail pode aparecer, uma única vez, um aviso pedindo para confirmar o certificado do servidor; é esperado e seguro aceitar. Se o aviso continuar aparecendo no dia seguinte, me avise que eu ajusto.

E uma segunda, para quando o cliente tem equipe que usa Outlook em desktop:

> **** Se o seu programa de e-mail estiver configurado com o endereço antigo do servidor, vamos atualizar para o novo. Levo dois minutos por máquina e posso fazer remotamente.

Aviso dado antes vira manutenção programada. Aviso dado depois vira incidente, com a mesma causa técnica e metade da confiança.

## Quando o nome feio não justifica a troca

Se o motivo da troca é estético (o nome antigo é feio, veio do provedor, tem o nome de um cliente que saiu), avalie o custo. A troca mexe em certificado, em reverso e na reputação construída naquele nome junto aos grandes receptores. Nome herdado que funciona, com PTR correto e certificado válido, é um ativo silencioso.

Troque quando o nome atual está em domínio que você vai perder, quando ele colide com uma conta que precisa ser hospedada ali, ou quando ele não é um FQDN válido. Nesses três casos o custo de não trocar cresce com o tempo. Nos outros, o nome feio não derruba e-mail nenhum.

