blog
Servidores

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.

JR · · 8 min de leitura · 1 tabela · 6 blocos de código

Resposta curta: 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.

Neste artigo
  1. As quatro peças que precisam concordar entre si
  2. Três critérios para escolher o nome antes de qualquer comando
  3. A sequência que mantém a janela de risco curta
  4. Checklist de oito itens para padronizar numa frota
  5. O que a fila do Exim mostra nas 48 horas seguintes
  6. O que dizer ao cliente antes da janela, sem explicar DNS
  7. Quando o nome feio não justifica a troca

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.

Quatro peças, quatro donos, quatro prazosRegistro A/AAAAVocê publica no DNS autoritativoHostname do sistemaVocê aplica no servidorCertificados dos serviçosSMTP, IMAP, painel, FTPPTR do IPDepende do provedor do VPS
As quatro peças que precisam concordar. A última não é sua e é a que trava o cronograma.

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

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

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:

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:

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

/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:

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:

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:

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.

Ordem que mantém a janela curtaPublicar AConfirmar por dig de foraAbrir PTRChamado no provedor, agoraAplicar nomeset_hostname e hostname -fReemitir certificadosSMTP, IMAP, painel, FTPFechar triângulodig -x devolve o nome novo
A ordem é o produto: o pedido de reverso entra cedo, a validação encerra a janela.

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.

  1. Nome definido, FQDN válido de três níveis, em domínio próprio, sem colidir com conta hospedada.
  2. Registro A (e AAAA) publicado e confirmado por dig +short de fora.
  3. Chamado de PTR aberto no provedor, com o IP e o nome escritos no corpo.
  4. Registro A do hostname antigo preservado, mesmo IP.
  5. set_hostname executado, hostname -f confere.
  6. Certificados de SMTP, IMAP, painel e FTP reemitidos para o nome novo e validados por openssl s_client.
  7. PTR confirmado, triângulo fechado por dig -x.
  8. 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:

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:

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

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.

Referências

  1. Documentação oficial (cpanel) — The set_hostname Utility (WHM). Consultado em 2026-10-04.
Leia também