# E-mail do root não chega: conserto em /etc/aliases

O correio do root fica parado dentro da máquina até alguém apontar o alias para fora. O procedimento abaixo configura, aplica e prova a entrega mesmo com o MTA local degradado.

> aponte o alias `root` em `/etc/aliases` para um endereço externo real, rode `newaliases` e, em servidor com painel, ajuste também o contato do servidor. Nunca use `/etc/valiases`, que trata domínio virtual e ignora o usuário local root.

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

---

O servidor avisou. Cron falhou, o RAID degradou, o backup estourou espaço, a atualização de pacote pediu confirmação. Tudo isso vira mensagem para o usuário `root` da máquina. Se ninguém definiu para onde esse correio vai, ele fica parado em `/var/mail/root` ou `/var/spool/mail/root`, dentro do próprio servidor, esperando alguém logar por SSH e ler. Ninguém loga. Ninguém lê.

O conserto é curto: apontar o alias de `root` para uma caixa que a agência lê de verdade, aplicar com `newaliases`, ajustar o endereço de contato no painel quando existir painel, e provar que a mensagem sai mesmo quando o MTA da própria máquina está ruim. Essa última parte é a que quase nunca aparece em tutorial, e é exatamente a que separa "configurei" de "funciona".

## Por que /etc/valiases não captura nada do root

Esse é o erro clássico. A pessoa abre o gerenciador de arquivos, encontra `/etc/valiases/dominiodocliente.com.br` e escreve lá o encaminhamento do root. Não funciona, e não funciona por desenho.

- `/etc/aliases` é o arquivo de aliases **do sistema**. Ele resolve contas locais do Unix: `root`, `cron`, `postmaster`, `nobody`. É aqui que mora a resposta para "para onde vai o correio do root".
- `/etc/valiases/<dominio>` é o encaminhamento de **domínio virtual**, usado por painéis como o cPanel para os endereços hospedados naquele domínio. Ele trata `contato@dominio.com.br`, não o usuário local `root`.

Mensagem gerada por cron, por `logrotate` ou pelo gerenciador de pacotes é entregue ao usuário local. Ela nunca passa pelo roteamento de domínio virtual. Por isso o alias virtual não captura nada e a pessoa conclui que "o servidor não manda e-mail", quando na verdade ele manda e entrega certinho, só que para dentro de si mesmo.

## As duas linhas que resolvem em /etc/aliases

Abra `/etc/aliases` e garanta duas coisas: que `root` aponte para um endereço externo real e que `postmaster` aponte para `root`. O formato é `nome: destino`.

```bash
# ver o que está valendo hoje
grep -E '^(root|postmaster)' /etc/aliases

# editar
nano /etc/aliases
```

Conteúdo mínimo (o endereço abaixo é exemplo, troque pelo da sua agência):

```
postmaster: root
root: alertas@suaagencia.com.br
```

Salve e aplique. O arquivo texto não vale nada sozinho: o MTA lê a versão compilada, e quem compila é o `newaliases`.

```bash
newaliases
```

Se o comando não existir no seu sistema, o equivalente costuma ser `sendmail -bi`. Em servidores com Exim, dependendo do build, a leitura é direta do arquivo texto, mas rodar `newaliases` não quebra nada e padroniza o procedimento entre máquinas diferentes, que é o que interessa para quem mantém dez VPS.

### Por que o alias precisa de um destino fora da máquina

Um só endereço cria ponto único de falha, principalmente se esse endereço estiver hospedado no próprio servidor que você está tentando monitorar. Separe por vírgula:

```
root: alertas@suaagencia.com.br, plantao@outrodominio.com
```

A regra prática: **pelo menos um dos destinos precisa estar fora da máquina monitorada**, idealmente fora do mesmo provedor. Se o servidor cair inteiro, o aviso de que ele caiu não pode depender dele.

## O que o painel grava além do arquivo de aliases

Em servidor com WHM/cPanel existe um segundo lugar que manda em parte das notificações: as preferências de correio do sistema. A documentação oficial do cPanel descreve a interface **Edit System Mail Preferences** (WHM, área de Server Contacts) como o ponto onde você define o encaminhamento do correio das contas de sistema, inclusive a do `root`, e onde é possível marcar o destino para não entregar localmente.

Fonte: [Edit System Mail Preferences, documentação oficial do cPanel](https://docs.cpanel.net/whm/server-contacts/edit-system-mail-preferences/).

O que isso significa na prática para quem administra o VPS do cliente:

| Camada | Onde mexe | O que ela cobre |
|---|---|---||
| Alias de sistema | `/etc/aliases` + `newaliases` | Correio gerado por cron, logrotate, gerenciador de pacotes, scripts do sistema, qualquer coisa endereçada ao usuário local `root` |
| Preferências de correio do sistema | WHM, Edit System Mail Preferences | Mesma coisa que a linha acima, por outra porta: a interface grava o encaminhamento das contas de sistema, root incluído, e a opção de não manter cópia local. Não é uma camada separada do alias, é uma forma de editá-lo pelo painel |
| Contato do servidor | WHM, Server Contacts | Endereço que recebe os alertas gerados pelo próprio painel |
| Alias virtual | `/etc/valiases/<dominio>` | Endereços do domínio hospedado. Não tem relação com o root |

As duas primeiras linhas da tabela disputam o mesmo destino do `root`, então a última edição vence: salvar no WHM depois de editar o arquivo à mão desfaz o que você escreveu, e editar o arquivo depois pode ser sobrescrito no próximo salvamento da interface. A ordem segura em servidor com painel é: configurar primeiro em Edit System Mail Preferences, depois conferir o resultado com `grep -E '^(root|postmaster)' /etc/aliases` e só então completar à mão o que faltar (o segundo destino, por exemplo), rodando `newaliases` em seguida. Em servidor sem painel, só o arquivo. O contato do servidor, terceira linha, é independente e precisa ser preenchido de qualquer jeito: configurar só ele produz o resultado mais chato de diagnosticar, metade dos avisos chega, metade não, e você perde uma tarde tentando entender o padrão.

## Teste que só passa com tudo funcionando não prova nada

Mandar um teste e ver chegar é bom. Mas o cenário real em que você precisa do aviso é justamente aquele em que a máquina está mal: disco cheio, fila travada, serviço de e-mail parado, IP em lista de bloqueio. Teste que só passa com tudo funcionando não prova nada sobre o momento em que importa.

### Disparar a mensagem como o sistema faria

```bash
echo "teste alias root $(date)" | mail -s "teste root" root
```

Repare que o destino é `root`, não o endereço final. Você está testando a resolução do alias, não a caixa de destino.

### Ler a fila para separar alias de entrega

A mensagem deve sair da fila. Se ficar presa, o problema não é o alias.

```bash
# Exim
exim -bp

# Postfix
mailq
```

Fila vazia logo após o envio é bom sinal. Fila com a mensagem parada e um motivo ao lado (host recusando, timeout, defer) já te dá o diagnóstico pronto.

### Achar no log o endereço externo expandido

```bash
# Exim
tail -n 50 /var/log/exim_mainlog | grep -i 'teste root'

# Postfix em RHEL, AlmaLinux, Rocky
tail -n 50 /var/log/maillog | grep -i 'status='

# Postfix em Debian e Ubuntu
tail -n 50 /var/log/mail.log | grep -i 'status='

# caminho único, se a distro usa journald
journalctl -u postfix -n 50 | grep -i 'status='
```

O que você procura é a linha de saída com o endereço final expandido. Se o log mostra entrega para `/var/mail/root` em vez do endereço externo, o alias não foi aplicado: volte e rode `newaliases`.

### Derrubar o caminho principal sem parar o MTA

Aqui está a parte que quase ninguém faz. Repita o teste em condição adversa, usando um caminho que não dependa da entrega direta da máquina:

- **Destino fora do domínio da máquina.** Se o segundo endereço do alias está em outro provedor, você descobre na hora se o IP do VPS está sendo recusado por reputação. Entrega interna sempre funciona e por isso esconde esse tipo de falha.
- **Relay autenticado externo.** Configurar o MTA para entregar via smarthost autenticado tira da equação a reputação do IP do servidor e o bloqueio de porta 25 na saída. O aviso passa a sair por um caminho que já é confiável para o destinatário.

Teste objetivo de aceitação: deixe o caminho principal indisponível e verifique se o alerta ainda chega pelo segundo caminho. Não pare o Exim ou o Postfix do VPS para isso. Parar o MTA derruba o e-mail de todos os domínios hospedados na máquina, inclusive os que nada têm a ver com o teste, e mensagens de entrada podem ser recusadas enquanto o serviço estiver fora. Alternativas que não interrompem ninguém:

- Bloquear a saída na porta 25 por alguns minutos com uma regra temporária de firewall (`iptables -I OUTPUT -p tcp --dport 25 -j REJECT`, removida com `-D` no fim). A entrega direta falha, o relay autenticado em porta de submissão continua passando.
- Apontar um dos destinos do alias para um endereço que você sabe que recusa, em domínio de teste, e observar o defer no log enquanto o outro destino entrega.
- Se realmente precisar derrubar o serviço, combine janela com o cliente, informe a duração e volte o serviço antes de sair.

Se o alerta chega com o caminho principal fora, o monitoramento é real. Se não chega, você tem monitoramento que só funciona quando não precisa dele.

## Dez itens para padronizar em cada VPS

Rode isso uma vez por servidor, documente no card do cliente e nunca mais pense no assunto.

- `grep -E '^(root|postmaster)' /etc/aliases` para registrar o estado anterior.
- Definir `postmaster: root` e `root:` com dois destinos, sendo pelo menos um fora da máquina.
- `newaliases`.
- Em servidor com painel, configurar primeiro as preferências de correio do sistema e o contato do servidor, depois reconferir o `grep` do passo 1 e reaplicar `newaliases` se tiver completado algo à mão.
- Disparar `echo ... | mail -s "teste root" root`.
- Conferir `exim -bp` ou `mailq` vazios.
- Conferir no log a linha de entrega com o endereço externo expandido.
- Repetir o teste pelo segundo canal, deixando o caminho principal indisponível sem parar o MTA (regra temporária de firewall na porta 25 ou destino que recusa).
- Criar uma regra ou pasta na caixa da agência separando por hostname do servidor, para o alerta não se misturar ao resto.
- Agendar reteste trimestral. Caixa de destino muda, domínio expira, colaborador sai da empresa.

O item 9 parece detalhe e não é. Alerta que cai numa caixa compartilhada sem rótulo tem o mesmo destino do alerta que não saiu: ninguém lê. Inclua o hostname no assunto ou use um endereço com subaddressing (`alertas+vpscliente@...`) quando o provedor de destino suportar.

## Cinco sintomas e o que cada um significa

| Sintoma | Causa provável | O que fazer |
|---|---|---||
| Log mostra entrega em `/var/mail/root` | `newaliases` não foi executado, ou foi editado o arquivo errado | Confirmar o caminho do arquivo e reexecutar `newaliases` |
| Mensagem presa na fila com defer de conexão | Saída na porta 25 bloqueada pelo provedor | Configurar relay autenticado em porta de submissão |
| Entrega aceita mas nada chega | Destinatário classificou como spam, ou falta de alinhamento de SPF/DKIM no domínio remetente | Verificar a pasta de spam e usar um remetente de domínio autenticado |
| Chega o alerta do painel mas não o do cron | Só o contato do servidor foi configurado, o alias de sistema não | Fazer as duas camadas |
| Nada mudou depois de editar `/etc/valiases/...` | Arquivo de domínio virtual não trata usuário local | Mover a configuração para `/etc/aliases` |

## A frase pronta para explicar ao cliente

O cliente não quer saber de alias nem de MTA. Ele quer saber por que o servidor sabia do problema e ninguém agiu. Frase pronta, pode copiar:

> **** "O servidor gerou o aviso no horário certo, mas o aviso estava configurado para ficar guardado dentro da própria máquina, numa caixa de sistema que ninguém abre. Redirecionamos esses avisos para a caixa de monitoramento da agência, com um segundo endereço fora do servidor para o caso de a máquina ficar indisponível, e testamos o caminho inteiro até confirmar a chegada."

Funciona porque não culpa ninguém, descreve o que foi feito e já antecipa a pergunta seguinte ("e se o servidor cair de vez?"). Se o cliente pedir comprovação, mande o print da mensagem de teste com data e hostname no assunto. É barato de produzir no passo 5 do checklist e encerra a conversa.

Um último ponto contra o próprio interesse: na maioria dos casos esse problema não é do plano nem do provedor. É uma linha em `/etc/aliases` que nunca foi preenchida porque a instalação padrão deixa o correio local do root parado na máquina. Antes de migrar servidor por "não recebo alertas", rode os dez itens acima. Leva poucos minutos por VPS e resolve.

