# Limite de anexo de e-mail no cPanel: três tetos, um sintoma

Base64, WHM e código de retorno. Como decidir em 30 segundos se o problema é o seu servidor ou o do destinatário, e o que padronizar na carteira de clientes.

> um anexo de 25 MB chega ao servidor com cerca de 33 MB, porque o base64 infla a mensagem em torno de 33%. O teto que você controla é o de origem (Exim) e, em parte, o da composição (webmail e PHP). O do destinatário, não.

João Rizzon · 2026-09-28 · Painéis

---

## O arquivo de 25 MB nunca chega ao servidor com 25 MB

Anexo em e-mail não viaja como binário. O MIME codifica o arquivo em base64, que representa 3 bytes originais com 4 caracteres ASCII. A conta é direta: o corpo codificado fica cerca de 33% maior que o arquivo, mais as quebras de linha, os cabeçalhos, os delimitadores de parte e o texto da própria mensagem.

É por isso que a conversa com o cliente trava. Ele anexou um PDF de 25 MB, o servidor recusou uma mensagem de 33 MB e ninguém está mentindo.

| Arquivo original | Depois do base64 (≈ +33%) | Teto mínimo (× 1,4) | Valor redondo usado na prática |
|---|---|---|---||
| 5 MB | ≈ 6,7 MB | 7 MB | 10 MB |
| 10 MB | ≈ 13,3 MB | 14 MB | 20 MB |
| 25 MB | ≈ 33,3 MB | 35 MB | 40 MB |
| 50 MB | ≈ 66,7 MB | 70 MB | 80 MB |

A regra que importa: multiplique o maior anexo que o cliente precisa mandar por 1,4. Esse é o **piso**, o valor abaixo do qual a mensagem não passa. O 1,4 cobre o base64 e deixa uma sobra pequena para cabeçalhos. A última coluna é só o arredondamento para cima em número redondo, que é o que a maioria das equipes acaba configurando para não ter que refazer a conta quando o cliente anexa dois arquivos em vez de um, ou uma assinatura com imagem. Nenhum dos dois valores é recomendação universal: são dimensionamento.

Há ainda a ambiguidade de unidade. Alguns painéis e MTAs tratam "M" como mebibyte (1.048.576 bytes) e outras interfaces mostram megabyte decimal. A diferença é pequena, mas ela existe exatamente na fronteira, que é onde o e-mail costuma bater. Mais um motivo para não configurar o teto rente ao tamanho do arquivo.

## Os três tetos que a agência trata como um só

O sintoma é sempre o mesmo ("o e-mail não sai"), mas os limites são três, em camadas diferentes, com donos diferentes.

| Teto | Onde mora | Quem ajusta | Sintoma típico |
|---|---|---|---||
| Servidor de origem | `message_size_limit` do Exim, no servidor que hospeda a conta | quem tem WHM (root) ou o provedor | erro no ato do envio, a mensagem nem sai da caixa |
| Composição do cliente | Outlook desktop, webmail Roundcube, Gmail web, app do celular | parcialmente ajustável (webmail e PHP), fixo em interfaces de terceiros | o programa recusa o anexo antes de enviar |
| Servidor do destinatário | MTA de quem recebe (Gmail, Microsoft 365, servidor próprio do cliente dele) | ninguém do seu lado | a mensagem sai, some por minutos e volta com um retorno |

Ajustar o primeiro teto é trabalho de cinco minutos. O segundo você ajusta em parte. Ajustar o terceiro é impossível. Se você não separar origem de destino antes de mexer em qualquer coisa, vai aumentar o limite do servidor, pedir para o cliente tentar de novo e receber o mesmo retorno, agora com a sua credibilidade envolvida.

## Descobrir se a recusa veio da origem ou do destino

### O atalho que resolve a maioria dos casos antes de abrir log

Pergunte uma coisa só: o erro apareceu na hora de clicar em enviar, ou a mensagem saiu e voltou depois?

- **Erro imediato, mensagem parada na caixa de saída**: seu servidor recusou no momento do envio. A recusa pode vir logo no `MAIL FROM`, quando o cliente anuncia o tamanho pela extensão SIZE, ou ao fim do `DATA`, quando o servidor conta os bytes que chegaram. Nos dois casos existe algo a ajustar do seu lado.
- **Mensagem consta em Enviados e um retorno chega segundos ou minutos depois**: seu servidor aceitou e tentou entregar. Quem recusou foi o destino, ou algum salto no meio.

Esse teste erra em um caso: clientes que fazem envio assíncrono e transformam a recusa imediata em retorno. Por isso, confirme no texto do retorno.

### O que o código de recusa diz e o que ele não decide

O retorno (DSN) traz um cabeçalho `Diagnostic-Code` e, quase sempre, o nome do host que respondeu. É ali que a dúvida acaba.

| Trecho no retorno | Leitura |
|---|---||
| `552 5.3.4 message size exceeds fixed maximum message size` | limite fixo do MTA que respondeu; confira qual host respondeu |
| `550 5.2.3` ou `552 5.2.3`, "message length exceeds administrative limit" | limite de política, também no MTA que respondeu |
| `SMTP error from remote mail server after end of data:` seguido de um host que não é o seu | recusa na entrada, do lado do destinatário |
| Erro exibido pelo cliente de e-mail, sem mensagem de retorno | recusa na saída, pelo seu servidor |

O texto exato varia por provedor, e o mesmo par de códigos pode aparecer nos dois lados. O número não decide nada. O que decide é **de quem é o host que respondeu**.

Onde achar esse host: no cabeçalho `Remote-MTA` do DSN, e no próprio `Diagnostic-Code`, no nome que aparece entre `host` e o código de resposta. Não use o `Reporting-MTA` para isso: ele identifica o servidor que **gerou** o aviso de retorno, que quase sempre é o seu próprio servidor de origem. Ler o `Reporting-MTA` como culpado é o jeito mais rápido de inverter o diagnóstico e mexer no lugar errado. Se o `Remote-MTA` for o MX do destinatário, acabou: o problema está lá.

### Confirmar no exim_mainlog quando você tem root

Com acesso de root no servidor, dois comandos resolvem. O primeiro mostra o teto que o Exim está aplicando de fato, não o que a interface diz:

```bash
exim -bP message_size_limit
```

O segundo procura a recusa no log principal, filtrando pelo endereço do remetente ou do destinatário:

```bash
grep -i 'cliente@dominio.com.br' /var/log/exim_mainlog | tail -20
```

Se a linha de rejeição vier do seu próprio Exim, o teto de origem é o culpado. Se a linha mostrar a resposta de um host remoto, você já tem a frase pronta para mandar ao cliente, com o nome do servidor que recusou.

## Ajustar o teto de origem no WHM

No WHM, as opções do Exim ficam em **Service Configuration » Exim Configuration Manager**, que a [documentação do cPanel](https://docs.cpanel.net/whm/service-configuration/exim-configuration-manager-basic-editor/134/) divide em Basic Editor e Advanced Editor. O Basic Editor expõe as opções mais comuns em formulário; o Advanced Editor permite escrever diretivas do Exim diretamente.

### Descobrir o teto que o Exim aplica de fato

Antes de mudar qualquer coisa, rode `exim -bP message_size_limit`. Anote o valor. Sem esse número você não sabe se o ajuste funcionou nem tem como voltar atrás.

### Alterar o message_size_limit no Basic ou no Advanced Editor

Abra o Basic Editor e verifique se existe ali a opção de tamanho máximo de mensagem. Se existir, use ela: é o caminho que o WHM valida e reconstrói sozinho. Se não existir na sua versão, vá ao Advanced Editor e defina a diretiva `message_size_limit` na seção de configuração do Exim. O nome da diretiva é o mesmo nos dois casos, e é ele que o `exim -bP` vai devolver depois.

A posição exata da opção muda entre versões do WHM. Trate isso como nota, não como instrução: se o rótulo não estiver onde você esperava no Basic Editor, o Advanced Editor resolve sempre.

Defina o valor com folga sobre o base64: para um anexo de 25 MB, o piso é 35 MB e 40 MB é um ponto de partida razoável (dimensionamento, não número oficial). Salve e deixe o WHM reconstruir a configuração do Exim.

O valor `0` desativa a checagem. Não use `0` em servidor com contas de cliente: sem teto, uma mensagem gigante trava fila, enche disco e derruba a entrega das outras. Um limite alto e explícito é melhor que nenhum limite.

Confirme o resultado com o mesmo `exim -bP message_size_limit`. Se a saída não mudou, a configuração não foi aplicada; descubra por quê antes de pedir novo teste ao cliente.

### O limite do webmail é outro e mora no PHP do painel

O Exim aceitar 40 MB não significa que o Roundcube deixe anexar 25 MB. O webmail é uma aplicação PHP e obedece a `upload_max_filesize`, `post_max_size` e, dependendo do caso, `memory_limit`. O `post_max_size` precisa ser maior que a soma dos anexos mais o corpo, não igual ao maior arquivo.

Detalhe que consome tempo de agência: em cPanel, o webmail roda sob a instalação de PHP do próprio painel, não sob a versão de PHP que você escolheu para o site no MultiPHP INI Editor. Mexer no `.user.ini` do site não muda o limite do Roundcube. Se o envio pelo cliente de e-mail funciona e pelo webmail não, é aí que está.

### Validar com um arquivo de tamanho conhecido

Gere um arquivo de tamanho conhecido, anexe e envie para um endereço seu em outro provedor:

```bash
dd if=/dev/zero of=teste-24mb.bin bs=1M count=24
```

Se passar, documente o valor. Se voltar, releia o retorno: agora o host no `Remote-MTA` deve ser o do destino, e você acabou de trocar um problema seu por um problema de terceiro, o que é progresso.

## O que pedir ao provedor quando você não tem WHM

Sem root, o teto do Exim é do provedor e não aparece no cPanel. Nesse cenário, o chamado bem escrito economiza dois dias de ida e volta.

O que pedir, nessa ordem:

- Qual é o `message_size_limit` aplicado ao servidor da conta, em MB.
- Se esse limite pode ser elevado para a conta ou se é global do servidor.
- Qual é o limite de upload do webmail (`upload_max_filesize` e `post_max_size` da instalação que roda o Roundcube).

Anexe ao chamado o retorno completo, com cabeçalhos, e a linha do `Diagnostic-Code`. Isso reduz o chamado a uma pergunta objetiva.

O que não adianta pedir: que o provedor libere a entrega em um destino que recusou. Se o `Remote-MTA` do retorno é o MX do Gmail, do Microsoft 365 ou do servidor do cliente do seu cliente, nenhum provedor de origem tem como aceitar por eles. Pedir isso só queima tempo.

## A regra dos 10 MB que evita rediagnosticar o mesmo caso

Tratar caso a caso é o que torna esse problema caro. Ele é recorrente e previsível, então vira política.

**Regra geral**: anexo até 10 MB vai anexado; acima disso, vai como link de download com expiração. O 10 MB não é mágico, é o valor que passa em praticamente qualquer destino depois da inflação do base64 (≈ 13,3 MB) sem depender do teto de ninguém.

Para o link, três caminhos que você já tem: uma pasta protegida no próprio site do cliente, o armazenamento em nuvem que ele já paga, ou um plugin de entrega de arquivos no WordPress. O ganho colateral é rastreabilidade: você sabe se o arquivo foi baixado, coisa que o anexo não diz.

Mantenha uma planilha única da carteira, com uma linha por cliente:

| Campo | Para que serve |
|---|---||
| Provedor de e-mail do cliente | define quem controla o teto de origem |
| Teto de origem confirmado (MB) | evita rediagnosticar o mesmo caso |
| Data da última verificação | o provedor pode mudar o valor sem aviso |
| Destinos críticos e limite publicado | clientes que mandam sempre para o mesmo órgão ou empresa |
| Método padrão para arquivo grande | link, nuvem, pasta no site |

Preencha na implantação, não na emergência. A verificação leva um minuto por conta com `exim -bP` ou com um teste de envio, e transforma um chamado de meia hora em uma consulta de dez segundos.

## A frase que explica ao cliente por que o e-mail voltou

O ponto mais difícil não é técnico. É explicar que a agência mexeu no servidor, cobrou pelo serviço, e o e-mail voltou mesmo assim.

Texto pronto, para copiar e adaptar:

> **** O limite de tamanho de anexo existe em dois lugares. No nosso servidor, que já está ajustado para aceitar mensagens de até [X] MB, e no servidor de quem recebe, que pertence a outra empresa e aplica o limite dela. Como o e-mail transforma o arquivo em texto para transmitir, um anexo de 25 MB vira cerca de 33 MB no caminho. Neste caso, a mensagem saiu normalmente daqui e foi recusada na entrada pelo servidor do destinatário, que informou o código [código do retorno]. Não há ajuste do nosso lado que faça esse destino aceitar. Para arquivos acima de 10 MB, o caminho confiável é o link de download, que já deixamos configurado.

Duas coisas fazem essa frase funcionar. Ela mostra o código real do retorno, o que tira a conversa do campo da opinião. E ela termina com o que fazer, não com o que não deu.

Se o retorno apontar o seu próprio servidor, a frase é outra e é curta: o limite era nosso, foi ajustado para [X] MB, pode reenviar.

